кислород с IDL / ODL - PullRequest
       30

кислород с IDL / ODL

0 голосов
/ 17 июня 2010

Если у вас есть проект C ++, в котором есть куча файлов .ODL и сгенерированных файлов .h из компилятора ODL, следует указать doxygen для анализа как .odl и .h, так и только одного или другой? В общем, я не люблю документировать сгенерированный код, но IDL - это особый случай.

В любом случае, похоже, что список участников файлов ODL не совсем корректно работает в моих тестах, правильно ли анализируются файлы ODL?

1 Ответ

3 голосов
/ 17 июня 2010

С этой страницы кажется, что Doxygen отлично поддерживает парсинг *idl и *.odl файлов.Может быть, у вас есть проблемы с форматом комментариев?

В любом случае, я бы посоветовал вам не разбирать как *.idl/*.odl файлы, так и сгенерированные .h файлы.Последние по определению генерируются и представляют те же классы, что и классы, определенные в файлах *.idl/*.old.

Парсинг обоих аналогичен двойному документированию одного и того же набора классов, что, очевидно, не очень хорошая идея.

...