VIM is fantastic!

It can do a lot of thing…..

And the things, it cannot do, can be added using scripts.

In this case the script, named DoxygenToolkit.vim, adds the capability to add doxygen comment typing a simple command.

Wikipedia: "Doxygen is a documentation generator, a tool for writing software reference documentation. The documentation is written within code, and is thus relatively easy to keep up to date. Doxygen can cross reference documentation and code, so that the reader of a document can easily refer to the actual code."

 

doxygen

Let's start:

 

Now open a new c file for example issuing the following command

# vim file.c

and type the following few lines of code:

int foo(char mychar, int myint, double* myarray, int mask = DEFAULT) 
{
} 

 

Issue the ": Dox" (note: no spaces between : and Dox) command with the cursor on the function declaration, you should obtain something like the following lines:

/** 
* @brief 
* 
* @param mychar 
* @param myint 
* @param myarray 
* @param mask 
* 
* @return 
*/ 

int foo(char mychar, int myint, double* myarray, int mask = DEFAULT) 

{
} 
The script is configurable, take a look at http://www.vim.org/scripts/script.php?script_id=987 for more info
Gg1