RE: [Doxygen-users] Variables at absolute location handledincorrectly in Doxygen
Brought to you by:
dimitri
|
From: Mark E. S. Jr. <ms...@aw...> - 2006-02-08 00:06:09
|
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 |