I'd like to use Doxygen to document legacy code that's a mix of C and x86 assembly language. The assembly language is not inline, but in separate assembly-only files. How can I document the assembly language portion?
See question 12 of the Doxygen FAQ. Are you dealing with pure assembly files, or inline assembly inside C sources? Assuming the former, you'll have to either write an input filter to transform the assembly code into something C-like (easier), or write a new parser (much harder).
-
-1 down vote This post is quite old. I am wondering, if somebody has already found a nice and elegant solution to include assembly code into Doxygen's documentation? The current state: There was a Doxygen filter available that converted the provided assembly code into C-like structured code. Unforunately, the link to the filter (bogdro.ciki.me/inne/asm4doxy.txt) is down. Help is appreciated – orbitcowboy Apr 21 '16 at 6:17
-
I worked with bogdro a while back to add something for Ida-Pro. I saved a copy online solengtech.com/downloads/asm4doxy.pl?attredirects=0&d=1 – rickfoosusa May 13 '16 at 15:44
Question 12 of the Doxygen FAQ eventually led me to a Perl filter that looks promising. It converts the assembly code into something C-like that Doxygen can parse. Thanks!
The original link appears to be dead. However back in 2008, I had pulled down a copy of asm4doxy.pl and squirreled it away. I've put it up on Pastebin if anyone is still interested. As I recall, I tried it, but it didn't really work for me at the time, but YMMV.
-
1