Hi,
I'm trying to document C code with doxygen for an OpenVOS System.
There, they are using a special C dialect ("VOS C").
For the system there I am working on there exist so-called system
subroutines. These subroutines are basically simple C-functions.
But to distinguish them from "normal" functions, they all have
the common name style "s$foo_bar". Note the Dollar sign!
See this link [*] for a list of common Stratus subroutines.
Unfortunately, doxygen can not handle them correctly. Here is an
example to test this for your own:
1: Generate a Doxyfile with "doxygen -g"
2: Set EXTRACT_ALL to YES
3: Do echo "void s$foo_bar();" > foo.c
4: Run doxygen.
Now, the HTML output of doxygen tells me that this function
declaration is in the source code:
"void s $foo_bar ()"
One can even better realize what's going on when activating
"SOURCE_BROWSER = YES" in Doxyfile. Then, you can click only on
"$foo_bar" when you open the xource code page in your web browser.
What I would expect here is "s$foo_bar" as the (clickable) function
name.
Can this be solved somehow? I wouldn't say that this is a bug
because VOS C is a rare C dialect. But I would like to know if
Dollar ($) signs in C function names can be correctly parsed by
Doxygen somehow.
Thanks for any help
Uwe
[*]
http://stratadoc.stratus.com/vos/17.1.1/r068-12/wwhelp/wwhimpl/common/html/wwhelp.htm?context=r068-12&file=prefacer068-12.html
------------------------------------------------------------------------------
Dive into the World of Parallel Programming! The Go Parallel Website,
sponsored by Intel and developed in partnership with Slashdot Media, is your
hub for all things parallel software development, from weekly thought
leadership blogs to news, videos, case studies, tutorials and more. Take a
look and join the conversation now. http://goparallel.sourceforge.net
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users
