How to give description for directory in Doxygen

Question

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?

Answer 1

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.