3

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?

2

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
6

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.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.