Doxygen does not generate except the empty mainpage

烈酒焚心 提交于 2020-07-10 10:22:18

问题


I have a problem with Doxygen GUI I am currently using version of the Doxygen 1.8.19 I selected project path and directory for the scan source code correctly, And activated EXTRACT_ALL to ENABLE.

The output I see:

enter image description here

I have .cpp and .c codes together. But main is cpp so I added detail file in main.cpp as a:

/**
  * @file           : main.cpp
  * @brief          : Main program body

When I Run doxygen button, I have just seen,

Empty Main page and I cant see another Tab.

How can I solve this problem?

My source code:

In main.cpp file:

/**
*@mainpage  MyPROJECT
*
*
*
*/

/**
   *@file         main.cpp
   *@brief        This is the main source code of the project.
*/....

In main.h file:

/**
*@mainpage  MYPROJECT
*
*
*
*/


    /**
       *@file         main.h
       *@brief        This is the main source code of the project.
    */
    ...

回答1:


Getting text on the Main Page is not triggered by the name of the file but can be accomplished with

  • the @mainpage command (see https://www.doxygen.nl/manual/commands.html#cmdmainpage)
  • creating a markdown file (say my_main.md) and use the configure doxygen with USE_MDFILE_AS_MAINPAGE=my_main.md (see: https://www.doxygen.nl/manual/config.html#cfg_use_mdfile_as_mainpage)

Small note:
When the file documentation is in the same file as the file itself the name of the file with the @file command is not necessary (and @file can actually be omitted. The : is also not OK.




回答2:


I solved the problem. For those who get the same error as me:

Before the "Run doxygen" save the Doxygen file to where main.cpp file to copy there. For example your main.cpp file in the Src/main.cpp than you have to copy "Doxygen.txt" file to Src/main.cpp.

And it works !



来源:https://stackoverflow.com/questions/62384151/doxygen-does-not-generate-except-the-empty-mainpage

标签
易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!