I have a class which has may functions and i want to hide a particular function. For example
class Test
{
/**
* About Function1
*
* @param[in] arg1 About arg1
* @param[in] arg2 About arg2
*/
public void Function1(int arg1,char arg2);
// Presume same documentation for this function also
public void Function2(int,char);
// Presume same documentation for this function also
public void Function3(int,char);
// Presume same documentation for this function also
public void Function4(int,char);
}
Suppose I want to hide say Function2 how would I do that.
Now in the current scenario it is displaying all the four functions along with its documentations.
Now, I have the following attribute set in my .doxygen rule file:
EXTRACT_ALL = YES
Can you please suggest me something by which i can hide say Function2?
You can put example source code in a special path defined in the doxygen config under EXAMPLE_PATH , and then insert examples with the @example tag. Doxygen will then generate an extra page containing the source of the example. It will also set a link to it from the class documentation containing the example tag.
It is parsed by doxygen . The file may contain tabs and newlines for formatting purposes. The statements in the file are case-sensitive. Comments may be placed anywhere within the file (except within quotes). Comments begin with the # character and end at the end of the line.
A special comment block is a C or C++ style comment block with some additional markings, so doxygen knows it is a piece of structured text that needs to end up in the generated documentation. The next section presents the various styles supported by doxygen.
Doxytag is a small command line based utility. It can generate tag files. These tag files can be used with doxygen to generate references to external documentation (i.e. documentation not contained in the input files that are used by doxygen).
If you have EXTRACT_PRIVATE = NO
in the config file, then you can mark any member as private to Doxygen and it will not generate documentation for that member:
/// @private
public void Function2(int, char);
Bonus question: if you wanted to use the same documentation for all four members you can do so using one of these approaches:
/**
* About Function1,2,3,4...
*/
/// @{
public void Function1(int arg1, char arg2);
public void Function2(int arg1, char arg2);
public void Function3(int arg1, char arg2);
public void Function4(int arg1, char arg2);
/// @}
/**
* About Function1,2,3,4...
*/
public void Function1(int arg1, char arg2);
/// @copydoc Function1
public void Function2(int arg1, char arg2);
/// @copydoc Function1
public void Function3(int arg1, char arg2);
/// @copydoc Function1
public void Function4(int arg1, char arg2);
The one using @{
...@}
requires the use of DISTRIBUTE_GROUP_DOC = YES
in the config file.
If you love us? You can donate to us via Paypal or buy me a coffee so we can maintain and grow! Thank you!
Donate Us With