Я хотел бы использовать Doxygen для документирования устаревшего кода, который представляет собой сочетание языка ассемблера C и x86. Язык ассемблера не является встроенным, а в отдельных файлах только для сборки. Как я могу документировать часть языка ассемблера?Язык Doxygen и Assembly
См. Вопрос 12 из Doxygen FAQ. Вы имеете дело с чистыми файлами сборки или встроенной сборкой внутри источников C? Предполагая первое, вам придется либо написать входной фильтр, чтобы преобразовать код сборки в нечто C-like (проще), либо написать новый парсер (намного сложнее).
Вопрос 12 из Doxygen FAQ в конечном итоге привел меня к Perl filter, который выглядит многообещающим. Он преобразует ассемблерный код в нечто такое, что Doxygen может анализировать. Благодаря!
Оригинал link кажется мертвым. Однако еще в 2008 году я снял копию asm4doxy.pl и вытолкнул ее. Я поставил его на Pastebin, если кому-то все еще интересно. Насколько я помню, я попробовал, но в то время это не работало, но YMMV.
Благодарим за обмен кода на Pastebin! – orbitcowboy
Примечание: я сохранил ссылку Pastebin на [WayBack-Machine] (http://web.archive.org/web/20160422133219/http://pastebin.com/Z3ZmaEmU) – orbitcowboy
-1 Этот пост довольно старый. Мне интересно, если кто-то уже нашел красивое и элегантное решение включить код сборки в документацию Doxygen? Текущее состояние: Доступен фильтр Doxygen, который преобразует предоставленный код сборки в C-подобный структурированный код. К сожалению, ссылка на фильтр (http://bogdro.ciki.me/inne/asm4doxy.txt) не работает. Помощь приветствуется – orbitcowboy
Я работал с bogdro некоторое время назад, чтобы добавить что-то для Ida-Pro. Я сохранил копию онлайн http://www.solengtech.com/downloads/asm4doxy.pl?attredirects=0&d=1 – rickfoosusa