Как мне справиться с конфликтующими именами при создании документов Python с Doxygen - PullRequest
1 голос
/ 23 февраля 2011

У меня проблема с Doxygen для Windows с Python, где входные файлы с одинаковым именем файла вызывают конфликт с выходными файлами.Это похоже на ошибку в doxygen - есть ли способ обойти эту проблему?


Справочная информация

Мы создаем документы для нашего API, используя Doxygen,Наш проект в основном написан на python, и единственными компонентами, которые заботятся о наших клиентах, являются python.Из-за случайностей в истории наши классы часто имеют неудачные соглашения об именах.

Например, у нас есть классы, чье полное имя:

tools.b.foo.Foo
tools.b.bar.Bar

Позже этот класс был повторно реализован и помещенв новый модуль:

tools.c.foo.Foo_improved
tools.c.bar.Bar_improved

Когда мы хотим собрать документацию по API инструментов, у нас есть процесс, который проверяет инструменты. * в каталоге на сервере сборки, а затем мы вызываем doxygen с довольно стандартнымконфигурационный файл.

Мы ожидаем, что в выводе должно быть четыре HTML-файла, два для foo и два для bar.Однако мы получаем только два файла.Оба набора сценариев анализируются, однако, поскольку имена модулей совпадают, документация для старой версии переписывает документацию, созданную для новых версий.В результате в каждом случае, когда имя модуля Python дублируется (но в другом подпакете), мы получаем только один файл документа для каждого имени файла.

FYI, мы используем doxygen 1.7.1в Windows XP 32bit с Python 2.4.4

Конфигурационный файл находится здесь: http://pastebin.me/002f3ec3145f4e1896a9cf79e7179493

ОБНОВЛЕНИЕ 1: В сгенерированном индексе документа я вижу записи для всех четырех файлов, однако, если я буду следоватьобе ссылки на Foo и Foo_improved указывают на один и тот же файл.

1 Ответ

0 голосов
/ 21 сентября 2011

Вы можете попробовать явно объявить класс с полным пространством имен http://www.doxygen.nl/manual/commands.html#cmdclass

...