Documentation/quickstart/debugging.rst: rewrite JTAG/OpenOCD section #2031
Conversation
- Add mentions to SWD - Sony's OpenOCD fork no longer needed since Nuttx support was merged upstream on http://openocd.zylin.com/#/c/4103/. Recommended to build from source or use one of the unofficial, more recent builds. - Amazon link for Olimex adapter was no longer available so removed. - Reordered and some parts rewritten
diegoherranz
force-pushed
the
doc_openocd
branch
from
48918fd
to
8247eb6
Compare
| This guide assumes your board has a JTAG connector, and you have a JTAG hardware debugger like a | ||
| `Segger J-Link <https://www.segger.com/products/debug-probes/j-link/>`_ or `OpenOCD <http://openocd.org/doc-release/html/index.html>`_. | ||
| examine variables and memory. `SWD <https://en.wikipedia.org/wiki/JTAG#Similar_interface_standards>`_ is an | ||
| Arm-specific, alternative 2-pin electrical interface that uses the same protocol and can be used too. |
There was a problem hiding this comment.
Does it matter that the author of that wiki page claims a Creative_Commons_Attribution-ShareAlike license?
https://en.wikipedia.org/wiki/Wikipedia:Text_of__3.0_Unported_License
Wikipedia is also a registered trademark. Does that matte?
There was a problem hiding this comment.
I can rewrite "alternative 2-pin electrical interface that uses the same protocol" which was copy-pasted from there. I didn't think of if given it was just a short sentence. Would that be better?
Wikipedia is also a registered trademark. Does that matte?
In terms of the trademark, we only include the word Wikipedia in the actual link to its website. I don't know about legal, stuff but I would expect that to be OK? Otherwise it would be difficult to link anything. Does anyone one for certain?
Sony must be a trademark too. Should that be mentioned somewhere?
Thanks.
|
Hi,
Does it matter that the author of that wiki page claims a Creative_Commons_Attribution-ShareAlike license?
https://en.wikipedia.org/wiki/Wikipedia:Text_of__3.0_Unported_License <https://en.wikipedia.org/wiki/Wikipedia:Text_of__3.0_Unported_License>
Yes it does see [1]
Wikipedia is also a registered trademark. Does that matte?
As long as you are respectful of the trademark that fine, I wouldn’t;t expect that Wikipedia forbid uses of it trademark use like this.
Thanks,
Justin
1. https://www.apache.org/legal/resolved.html#cc-by
|
But we are just linking to it. I'm not sure what the issue in question is here? This is not taking the text from the article. |
|
Hi,
See [1] (this would be fine) and for use of Sony see [2] (which seem easy to comply with).
Thanks,
Justin
1. https://foundation.wikimedia.org/wiki/Trademark_policy <https://foundation.wikimedia.org/wiki/Trademark_policy>
2. https://www.sonycreativesoftware.com/corporate/copyright <https://www.sonycreativesoftware.com/corporate/copyright>
|
|
Hi,
But we are just linking to it. I'm not sure what the issue in question is here? This is not taking the text from the article.
Linking to it is fine, just don’t take any text from it.
Thanks,
Justin
|
|
So, the copyright concern get resolved, let's merge it! |
|
I was just about to rewrite the SWD sentence so that it's not a copy-paste from the Wikipedia. I'll do that on another pull request. |
Original content rather than copy-paste from Wikipedia. Discussed on apache#2031
Original content rather than copy-paste from Wikipedia. Discussed on #2031
on http://openocd.zylin.com/#/c/4103/. Recommended to build from source or use
one of the unofficial, more recent builds.