[Doxygen-users] Dollar signs in function names
Brought to you by:
dimitri
From: Uwe S. <u.s...@gm...> - 2015-01-09 15:06:59
|
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 |