gnuk/ChibiOS_2.0.8/docs
2010-11-30 13:54:43 +09:00
..
html import ChibiOS 2.0.8 2010-11-30 13:54:43 +09:00
reports import ChibiOS 2.0.8 2010-11-30 13:54:43 +09:00
rsc import ChibiOS 2.0.8 2010-11-30 13:54:43 +09:00
src import ChibiOS 2.0.8 2010-11-30 13:54:43 +09:00
Doxyfile import ChibiOS 2.0.8 2010-11-30 13:54:43 +09:00
index.html import ChibiOS 2.0.8 2010-11-30 13:54:43 +09:00
readme.txt import ChibiOS 2.0.8 2010-11-30 13:54:43 +09:00

*** Documentation access ***

Open ./docs/index.html to open the start page or ./docs/html/index.html in
order to access directly the doxigen documentation.

*** Documentation rebuild procedure ***

The following software must be installed:
- Doxygen 1.5.7.1 or later.
- Graphviz 2.21 or later. The ./bin directory must be specified in the path in
  order to make Graphviz accessible by Doxygen.

Build procedure:
- Run Doxywizard.
- Load ./docs/Doxyfile from Doxywizard.
- Start.

*** Doxygen usage rules ***
- The JavaDoc style is recommended (@ instad of \, /** instead of /*!).
- Params descriptions must not begin with a capital letter and must not be
  terminated with a dot unless it is composed of multiple paragraphs.
- Retvals descriptions must not begin with a capital letter but must be
  terminated by a dot.
- Normal paragraphs, return rescriptions and notes must start with a capital
  letter and must be terminated with a dot.
- Multiple return values should be listed using the @retval command.
- Parameters direction must be specified.

Examples:
@note This is a note.
@retval RDY_OK is a possible return value.
@return The pointer to the created thread is returned.
@param[in] n the number of bytes to be written
@param[in] n the number of bytes to be written. This value can be zero.