[avr-libc-dev] [bug #43261] symbols in documentation are getting their leading and trailing "__" stripped by doxygen

[anonymous]

URL:
<http://savannah.nongnu.org/bugs/?43261>

Summary: symbols in documentation are getting their leading
and trailing "__" stripped by doxygen
Project: AVR C Runtime Library
Submitted by: None
Submitted on: Fri 19 Sep 2014 05:10:50 PM UTC
Category: Documentation
Severity: 3 - Normal
Priority: 5 - Normal
Item Group: Documentation
Status: None
Percent Complete: 0%
Assigned to: None
Originator Email: ***@gmail.com
Open/Closed: Open
Discussion Lock: Any
Release: 1.8.0
Fixed Release: None

_______________________________________________________

Details:


For example this page:

http://www.nongnu.org/avr-libc/user-manual/using_tools.html

list all the macros like AVR_ARCH instead of __AVR_ARCH__

Joerg says thi sis a doxygen issue and points out that in the
next table a few lines below the underscores are working fine:

Strange enough, in the next table a few lines below, the
underscores are working fine:

<tr><td>avr1</td><td>at90s1200</td<td>__AVR_AT90S1200__</td></tr>






_______________________________________________________

Reply to this item at:

<http://savannah.nongnu.org/bugs/?43261>

_______________________________________________
Message sent via/by Savannah
http://savannah.nongnu.org/

[Jonathan W. Taylor]

Update of bug #43261 (project avr-libc):

Assigned to: None => elderling


_______________________________________________________

Reply to this item at:

<http://savannah.nongnu.org/bugs/?43261>

_______________________________________________
Message sent via/by Savannah
http://savannah.nongnu.org/

[Jonathan W. Taylor]

Update of bug #43261 (project avr-libc):

Percent Complete: 0% => 80%

_______________________________________________________

Follow-up Comment #1:

Generating the documentation with doxygen 1.8.11 appears to resolve this issue
completely.

_______________________________________________________

Reply to this item at:

<http://savannah.nongnu.org/bugs/?43261>

_______________________________________________
Message sent via/by Savannah
http://savannah.nongnu.org/

[Jonathan W. Taylor]

Follow-up Comment #2, bug #43261 (project avr-libc):

I can see the CVS repo where the documentation is stored, but I don't know
whether it is acceptable for me to change it. Furthermore, if it OK for me to
change it, I don't know if I should regenerate all of the documentation or
just the broken files.

_______________________________________________________

Reply to this item at:

<http://savannah.nongnu.org/bugs/?43261>

_______________________________________________
Message sent via/by Savannah
http://savannah.nongnu.org/

[Joerg Wunsch]

Post by Jonathan W. Taylor
Furthermore, if it OK for me to
change it, I don't know if I should regenerate all of the documentation or
just the broken files.

Re-importing everything is the better way for sure.