Doxygen Test Suite

Class

class Test
#include “inc/class.h”

This is a test class.

Some details about the Test class

class Test3
file class.h

Interface

interface TestInterface
#include “inc/interface.h”

This is a test interface.

Some details about the TestInterface interface

file interface.h

Define

file define.h

testing defines

This is to test the documentation of defines.

Defines

ABS(x)

Computes the absolute value of its argument x.

MAX(x, y)

Computes the maximum of x and y.

MIN(x, y)

Computes the minimum of x and y.

NOARGS

Define with no arguments

Enum

class Test4
#include <enum.h>

The class description.

Public Types

enum TEnum

A description of the enum type.

Values:

Val1

The description of the first enum value.

Val2
enum AnotherEnum

Another enum, with inline docs

Values:

V1

value 1

V2

value 2

file enum.h

File

file file.h

A brief file description.

A more elaborated file description.

Variables

int globalValue

A global integer value.

More details about this value.

Func

class Test6
#include <func.h>

Test6 class.

Details about Test6.

Public Functions

const char *member(char c, int n)

A member function.

Return
a character pointer.
Parameters
  • c: a character.
  • n: an integer.
Exceptions
  • std::out_of_range: parameter is out of range.

file func.h

Page

file page.doc
page page1

Leading text.

page page2

Even more info.

Relates

class String

A String class.

Friends

int strcmp(const String &s1, const String &s2)

Compares two strings.

Related

void stringDebug()

A string debug function.

file relates.cpp

Functions

int strcmp(const String &s1, const String &s2)

Compares two strings.

Author

class WindowsNT

Windows Nice Try.

Author
Bill Gates
Author
Several species of small furry animals gathered together in a cave and grooving with a picture.
Version
4.0
Date
1996-1998
Warning
This class may explode in your face.
Warning
If you inherit anything from this class, you’re doomed.

file author.cpp
page bug

Par

class Test11

Normal text.

More normal text.

User defined paragraph:
Contents of the paragraph.
New paragraph under the same heading.
Note
This note consists of two paragraphs. This is the first paragraph.
And this is the second paragraph.

file par.cpp

Overload

class Test10

A short description.

More text.

Public Functions

void drawRect(int x, int y, int w, int h)

This command draws a rectangle with a left upper corner at ( x , y ), width w and height h.

void drawRect(const Rect &r)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

file overload.cpp

Example

class Test5

A Test5 class.

More details about this class.

Public Functions

void example()

An example member function.

More details about this function.

file example.cpp
example example_test.cpp

This is an example of how to use the Test5 class.More details about this example.

void main()
{
  Test7 t;
  t.example();
}

Include

class Test7

A test class.

Public Functions

void example()

a member function

file include.cpp
page example

Our main function starts like this:

void main()
{
First we create a object t of the Test7 class.
  Test7 t;
Then we call the example member function
  t.example();
After that our little test routine ends.
}

QtStyle

class Test12

A test class.

A more elaborate class description.

Public Types

enum TEnum

An enum.

More detailed enum description.

Values:

TVal1

Enum value TVal1.

TVal2

Enum value TVal2.

TVal3

Enum value TVal3.

Public Functions

Test12()

A constructor.

A more elaborate description of the constructor.

~Test12()

A destructor.

A more elaborate description of the destructor.

int testMe(int a, const char *s)

A normal member taking two arguments and returning an integer value.

Return
The test results
See
Test12(), ~Test12(), testMeToo() and publicVar()
Parameters
  • a: an integer argument.
  • s: a constant character pointer.

virtual void testMeToo(char c1, char c2) = 0

A pure virtual member.

See
testMe()
Parameters
  • c1: the first argument.
  • c2: the second argument.

Public Members

Test12::TEnum *enumPtr

Enum pointer.

Details.

Test12::TEnum enumVar

Enum variable.

Details.

int publicVar

A public variable.

Details.

int (*handler)(int a, int b)

A function variable.

Details.

file qtstyle.cpp

JdStyle

class Test8

A test class.

A more elaborate class description.

Public Types

enum TEnum

An enum.

More detailed enum description.

Values:

TVal1

enum value TVal1.

TVal2

enum value TVal2.

TVal3

enum value TVal3.

Public Functions

Test8()

A constructor.

A more elaborate description of the constructor.

~Test8()

A destructor.

A more elaborate description of the destructor.

int testMe(int a, const char *s)

a normal member taking two arguments and returning an integer value.

See
Test8()
See
~Test8()
See
testMeToo()
See
publicVar()
Return
The test results
Parameters
  • a: an integer argument.
  • s: a constant character pointer.

virtual void testMeToo(char c1, char c2) = 0

A pure virtual member.

See
testMe()
Parameters
  • c1: the first argument.
  • c2: the second argument.

Public Members

Test8::TEnum *enumPtr

enum pointer.

Details.

Test8::TEnum enumVar

enum variable.

Details.

int publicVar

a public variable.

Details.

int (*handler)(int a, int b)

a function variable.

Details.

file jdstyle.cpp

StructCmd

file structcmd.h

A Documented file.

Details.

Defines

MAX(a, b)

A macro that returns the maximum of a and b.

Details.

Typedefs

typedef unsigned int UINT32

A type definition for a .

Details.

Functions

int open(const char *pathname, int flags)

Opens a file descriptor.

Detailed description.

Parameters
  • pathname: The name of the descriptor.
  • flags: Opening flags.

int close(int fd)

Closes the file descriptor fd.

Parameters
  • fd: The descriptor to close.

size_t write(int fd, const char *buf, size_t count)

Writes count bytes from buf to the file descriptor fd.

Parameters
  • fd: The descriptor to write to.
  • buf: The data buffer to write.
  • count: The number of bytes to write.

int read(int fd, char *buf, size_t count)

Read bytes from a file descriptor.

Parameters
  • fd: The descriptor to read from.
  • buf: The buffer to read into.
  • count: The number of bytes to read.

Variables

int errno

Contains the last error code.

Warning
Not thread safe!

ResTypeDef

struct CoordStruct

A coordinate pair.

Public Members

float x

The x coordinate

float y

The y coordinate

file restypedef.cpp

An example of resolving typedefs.

Typedefs

typedef CoordStruct Coord

Creates a type name for CoordStruct

Functions

Coord add(Coord c1, Coord c2)

This function returns the addition of c1 and c2, i.e: (c1.x+c2.x,c1.y+c2.y)

AfterDoc

class Test1
#include <afterdoc.h>

A test class

Public Types

enum EnumType

An enum type.

The documentation block cannot be put after the enum!

Values:

EVal1

enum value 1

EVal2

enum value 2

Public Functions

void member()

a member function.

Protected Attributes

int value

an integer value

file afterdoc.h

Template

template <class T, int i = 100>
class Test14

A template class

Public Functions

Test14()

The constructor of the template class

Test14(const Test14 &t)

The copy constructor

template <class T>
template<>
class Test14<T *>

A partial template specialization

Inherits from Test14< void *, 200 >

Public Functions

Test14()

The constructor of the partial specialization

template <>
template<>
class Test14<void *, 200>

complete specialization

Subclassed by Test14< T * >

Public Functions

Test14()

The constructor of the specialization

file templ.cpp

Tag

class Tag

A class that is inherited from the external class Test13.

Inherits from Test13

Public Functions

void example()

an overloaded member.

file tag.cpp

Group

class C1

class C1 in group 1

class C2

class C2 in group 1

class C3

class C3 in group 2

class C4

class C4 in group 2

class C5

class C5 in the third group.

namespace N1

namespace N1 is in four groups

Also see This is another section in group 5

See
The first group, The Second Group, The Third Group, The Fourth Group

file group.cpp

this file in group 3

Functions

void func1()

function in group 1

void func2()

another function in group 1

void func3()

yet another function in group 1

group group1

This is the first group.

More documentation for the first group.

group group2

This is the second group.

group group3

This is the third group.

group group4

Group 4 is a subgroup of group 3.

group group5

This is the fifth group.

page mypage1

Text of the first section

page mypage2

Text of the second section

Diagrams

class A
#include <diagrams_a.h>

Subclassed by C, D

Public Members

A *m_self
class B
#include <diagrams_b.h>

Subclassed by D

Public Members

A *m_a
class C
#include <diagrams_c.h>

Inherits from A

Public Members

D *m_d
class D
#include <diagrams_d.h>

Inherits from A, B

Subclassed by E

Public Members

C m_c
class E
#include <diagrams_e.h>

Inherits from D

file diagrams_a.h
file diagrams_b.h
file diagrams_c.h
#include “diagrams_c.h”
file diagrams_d.h
#include “diagrams_a.h”#include “diagrams_b.h”
file diagrams_e.h
#include “diagrams_d.h”

Memgrp

class Test9

A class.

Details

Group2

Description of group 2.

void func1InGroup2()

Function 1 in group 2.

Details.

void func2InGroup2()

Function 2 in group 2.

Details.

Unnamed Group

void func1InGroup1()

Same documentation for both members.

Details

void func2InGroup1()

Same documentation for both members.

Details

Public Functions

void ungroupedFunction()

Function without group.

Details.

file memgrp.cpp

docs for this file

Unnamed Group

A

one description for all members of this group (because DISTRIBUTE_GROUP_DOC is YES in the config file)

B

one description for all members of this group (because DISTRIBUTE_GROUP_DOC is YES in the config file)

void glob_func()

one description for all members of this group (because DISTRIBUTE_GROUP_DOC is YES in the config file)

Docstring

class PyClass

Documentation for a class.

More details.

Public Functions

__init__(self self)

The constructor.

PyMethod(self self)

Documentation for a method.

Private Members

_memVar
namespace docstring

@package docstring
Documentation for this module.

More details.

Functions

func()

Documentation for a function.

More details.

file docstring.py

PyExample

class PyClass

Documentation for a class.

More details.

Public Functions

__init__(self self)

The constructor.

PyMethod(self self)

Documentation for a method.

Parameters
  • self: The object pointer.

Public Static Attributes

int pyexample.PyClass.classVar = 0

A class variable.

Private Members

_memVar

a member variable

namespace pyexample

Documentation for this module.

More details.

Functions

func()

Documentation for a function.

More details.

file pyexample.py

Mux

class behavior

Architecture definition of the MUX.

More details about this mux element.

class mux_using_with

Mux entity brief description Detailed description of this mux design element.

Public Members

in din_0std_logic

Mux first input.

in din_1std_logic

Mux Second input.

in selstd_logic

Select input.

out mux_outstd_logic

Mux output.

_library_ ieeeieee

Use standard library.

_use_ std_logic_1164std_logic_1164

Use logic elements.

file mux.vhdl

2:1 Mux using with-select

Manual

struct Car

Car type.

Car class.

Inherits from Vehicle

Protected Attributes

Vehicle base

Base class.

struct Object

Object type.

Base object class.

Subclassed by Vehicle

Public Functions

static Object *objRef(Object *obj)

Increments object reference count by one.

static Object *objUnref(Object *obj)

Decrements object reference count by one.

Private Members

int ref

Reference count.

struct Truck

Truck type.

Truck class.

Inherits from Vehicle

Protected Attributes

Vehicle base

Base class.

struct Vehicle

Vehicle type.

Vehicle class.

Inherits from Object

Subclassed by Car, Truck

Public Functions

void vehicleStart(Vehicle *obj)

Starts the vehicle.

void vehicleStop(Vehicle *obj)

Stops the vehicle.

Protected Attributes

Object base

Base class.

file manual.c

Functions

int main(void)

Main function.

Ref vehicleStart(), objRef(), objUnref().