другой кислород не генерирует ничего - PullRequest
Новая
       76

другой кислород не генерирует ничего

0 голосов
/ 23 апреля 2020

я впервые использую doxygen 1.8.15. Я генерирую Doxyfile по doxygen -g и пытаюсь создать документацию просто по doxygen.

Среди прочего у меня есть в базовом каталоге test.cpp, похожем на это: 

/**
 * This is a test. doc for an enum
 */
enum Test {
        /**
         * doc for an item
         */
        SomeItem
};

Я ожидаю вывод html в html/index.html, но это по сути пустой сайт. Ниже приводится выдержка из вывода: 

Parsing files
Preprocessing /home/ernst/Ankrit/Software/Products/Recon/recon/Mbed/main.cpp...
Parsing file /home/ernst/Ankrit/Software/Products/Recon/recon/Mbed/main.cpp...
Reading /home/ernst/Ankrit/Software/Products/Recon/recon/Mbed/mbed_settings.py...
Parsing file /home/ernst/Ankrit/Software/Products/Recon/recon/Mbed/mbed_settings.py...
Preprocessing /home/ernst/Ankrit/Software/Products/Recon/recon/Mbed/test.cpp...
Parsing file /home/ernst/Ankrit/Software/Products/Recon/recon/Mbed/test.cpp...
Building group list...

Как видите, test.cpp находится внутри. Но в результатах ничего не отображается на cpp, только mbed_settings. Что я сделал не так?

1 Ответ

1 голос
/ 23 апреля 2020

Когда, например, cpp код doxygen имеет «привычку» не находить некоторую информацию, когда нет соответствующего файла .h.

С помощью команды `` file` эта проблема может быть преодолеть, поэтому код: 

/// \file

/**
 * This is a test. doc for an enum
 */
enum Test {
        /**
         * doc for an item
         */
        SomeItem
};

дает запрошенный результат.

...