doxygendoxywizard

How to give description for directory in Doxygen


I am working with Doxygen to document my project. I know, by using the below Doxygen commands, we can give a description for source files.

/**
* \file example.cpp
* \brief Implementation of example functions 
*/

Is there any way to give a description for a directory/folder in Doxygen?


Solution

  • Use the \dir doxygen command. I asked a similar question how to link to documentation of directory in which I show

    /// \dir cpp/vtutil 
    ///      
    /// \brief Brief description of the dir cpp/vtutil goes here
    /// 
    /// \details A more detailed description goes here. 
    

    This works to provide documentation of the directory. In my original question, I was having trouble using \ref to link to the directory documentation. After more digging and experimenting I was able to get it to work. I commented in my answer that Doxygen is pretty forgiving or flexible with the path used when documenting a directory with the \dir command, but it is rather picky when referencing it with the \ref command.