RE: [Doxygen-users] Variables at absolute location handledincorrectly in Doxygen

[Mark E. S. Jr. <ms...@aw...>]

It is fairly common in C compilers intended for the microcontroller
world (especially Harvard Architecture based micros like the AVR
<http://en.wikipedia.org/wiki/AVR>  which I use).  My compiler
<http://www.hpinfotech.ro/html/cvavr.htm>  uses this additional
construct to specify a variable must go into a static location in the
memory space.  GCC for this platform does not do it the same as this,
but there are other compilers which do.  Also, in my experience for PIC
microcontrollers, many of the compilers use it.

=20

Mark E. Scott, Jr.

ms...@aw...

AWS, Inc.

512-478-7727

=20

________________________________________

From: John Calcote [mailto:jca...@no...]=20

Sent: Tuesday, February 07, 2006 4:52 PM

To: Mark E. Scott Jr.; dox...@li...

Subject: Re: [Doxygen-users] Variables at absolute location
handledincorrectly in Doxygen

=20

Scott,=20

=20

Do you use some sort of preprocessor to convert this "@ 0x1E08"
construct into assembly language, or something? This is not standard C,
at least not any part of the standard of which I am aware. :)=20

=20

This extension to the language is probably your problem. Is there some
way to put a comment around the construct so Doxygen won't think it's
part of the declaration? Often language pre-processors will allow you to
embed such extensions in standard C comments so the compiler won't
complain. Is this an extension to C that is supported by your
microcontroller C compiler?

=20

John

=20

-----

John Calcote (jca...@no...)

Sr. Software Engineeer

Novell, Inc.

=20

=20

>>> "Mark E. Scott Jr." <ms...@aw...> 2/7/2006 2:40 pm >>>

Hello,

=20

I have noticed that on some of my microcontroller projects, using C, and
having variables with their locations set absolutely, Doxygen shows the
absolute location as the variable name.

=20

For instance:

BLOCK_8 stBase @ 0x1E08;

=20

This is a variable of type BLOCK_8, at the absolute location 0x1E08.
However, when it shows up in my output, it reads the variable name as
'x1e08', and links it to a different place than the actual variable
name.

=20

Is there anyway to modify my construct such that Doxygen won't believe
that 'x1E08' is the variable name?

=20

Many thanks!

=20

Mark E. Scott, Jr.

ms...@aw...

AWS, Inc.

=20