Doxygen и ассемблер
-
06-07-2019 - |
Вопрос
Я бы хотел использовать Doxygen для документирования устаревшего кода, представляющего собой смесь ассемблера C и x86. Язык ассемблера не встроенный, а в отдельных файлах только для сборки. Как я могу документировать часть языка ассемблера?
Решение
См. вопрос 12 в FAQ по Doxygen . Вы имеете дело с чистыми ассемблерными файлами или встроенными ассемблерами внутри C-источников? Предполагая первое, вам придется либо написать входной фильтр, чтобы преобразовать ассемблерный код в нечто, похожее на C (проще), либо написать новый синтаксический анализатор (намного сложнее).
Другие советы
Вопрос 12 из FAQ по Doxygen в конечном итоге привел меня к Perl фильтр , который выглядит многообещающим. Он преобразует ассемблерный код в нечто, похожее на C, которое может анализировать Doxygen. Спасибо!
Исходная ссылка не работает. Однако в 2008 году я снял копию asm4doxy.pl и спрятал ее. Я поставил его на Pastebin , если кому-то все еще интересно. Насколько я помню, я попробовал это сделать, но в то время это не работало для меня, а для YMMV.