javadoc-banner.h File Reference

Go to the source code of this file.

Functions
void	cstyle (int theory)
void	javadocBanner (int theory)
void	doxygenBanner (int theory)

Function Documentation

cstyle()

void cstyle

(

int

theory

)

A brief history of JavaDoc-style (C-style) comments.

This is the typical JavaDoc-style C-style comment. It starts with two asterisks.

Parameters

theory

Even if there is only one possible unified theory. it is just a set of rules and equations.

doxygenBanner()

void doxygenBanner

(

int

theory

)

A brief history of Doxygen-style banner comments.

This is a Doxygen-style C-style "banner" comment. It starts with a "normal" comment and is then converted to a "special" comment block near the end of the first line. It is written this way to be more "visible" to developers who are reading the source code. This style of commenting behaves poorly with clang-format.

Parameters

theory

Even if there is only one possible unified theory. it is just a set of rules and equations.

javadocBanner()

void javadocBanner

(

int

theory

)