![]() |
PandaRoot
|
Documentation Sample Class. More...
#include <PndDocuSample.h>
Public Member Functions | |
PndDocuSample () | |
Default constructor does not need much of a description. More... | |
PndDocuSample (std::string _s, int _i) | |
Proper constructor. More... | |
~PndDocuSample () | |
Default destructor. More... | |
void | SetString (std::string _s) |
Set the string. More... | |
void | SetNumber (int _i) |
Set the number. More... | |
std::string | GetString () |
Returns the current string. More... | |
int | GetNumber () |
Return the current number. More... | |
void | PrintValues () |
You can either document in the header file... More... | |
void | AddString () |
void | SquareNumber () |
Documentation Sample Class.
This file highlights documentation with Doxygen
. Please see the individual parts for more information.
The current paragraph is designated for a long description of the class, possibly also with run / invocation instructions. Since this can be quite extensive, Doxygen provides functionality to properly format text. Two ways of styling text are supported, HTML
and Markdown
syntax. I will shortly highlight the latter, as it is a neat, quite natural way of styling text.
Markdown is the a markup language which lets you write styled text.
Headings are created with a number of consecutive hashes (#
), text can be bold or in italics. The following paragraph concisely highlights some features and is followed by the code used to generate it.
For more, see the original page or this slightly more extensive example.
This text can be italic, can be bold, or with fixed-width
. Also, a link can be set and an image included:
Code (uninterpreted) can be included in a block with three tildes (both for start and end of block). Optionally, a language can be specified which is used to generate syntax highlighted code.
And
The code used to generated the last section is the following:
If your class / method needs some mathematical description, you can use LaTeX to create formulas
\[ 55 = \sum_{i = 1}^{10} i \]
The formulas are rendered either in-browser with MathJax or during generation of the documentation as an image, depending on the configuration in the doxygen config file.
Definition at line 82 of file PndDocuSample.h.
PndDocuSample::PndDocuSample | ( | ) |
Default constructor does not need much of a description.
PndDocuSample::PndDocuSample | ( | std::string | _s, |
int | _i | ||
) |
Proper constructor.
Use this constructor to directly initialize the class
_s | A string with some information |
_i | Some integer. Does not need to be 42. |
PndDocuSample::~PndDocuSample | ( | ) |
Default destructor.
void PndDocuSample::AddString | ( | ) |
Referenced by GetNumber().
|
inline |
Return the current number.
fNumber
Definition at line 129 of file PndDocuSample.h.
References AddString(), PrintValues(), and SquareNumber().
|
inline |
Returns the current string.
fString
Definition at line 124 of file PndDocuSample.h.
void PndDocuSample::PrintValues | ( | ) |
You can either document in the header file...
This is true for all descriptions. They are combined.
Referenced by GetNumber().
|
inline |
Set the number.
_i | Number |
Definition at line 118 of file PndDocuSample.h.
|
inline |
Set the string.
[in] | _s | The input string. You can give additional directions of the variable. It can be an input, which should be the case usually, or on output, e.g. if you provide a pointer or reference to a variable to be filled in the course of this method. Notice that in the description of this method the usually one-line |
Definition at line 111 of file PndDocuSample.h.
void PndDocuSample::SquareNumber | ( | ) |
Referenced by GetNumber().