tinySA/docs
gdisirio ad864b4aa1 git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@760 35acf78f-673a-0410-8e92-d51de3d6d3f4 2009-02-14 07:25:15 +00:00
..
img git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@686 35acf78f-673a-0410-8e92-d51de3d6d3f4 2009-01-29 19:30:36 +00:00
reports git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@760 35acf78f-673a-0410-8e92-d51de3d6d3f4 2009-02-14 07:25:15 +00:00
src git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@757 35acf78f-673a-0410-8e92-d51de3d6d3f4 2009-02-13 20:34:09 +00:00
Doxyfile git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@758 35acf78f-673a-0410-8e92-d51de3d6d3f4 2009-02-13 21:06:49 +00:00
ch.txt git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@753 35acf78f-673a-0410-8e92-d51de3d6d3f4 2009-02-11 21:05:12 +00:00
index.html git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@700 35acf78f-673a-0410-8e92-d51de3d6d3f4 2009-01-31 08:58:54 +00:00
readme.txt git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@638 35acf78f-673a-0410-8e92-d51de3d6d3f4 2009-01-18 17:10:04 +00:00

readme.txt

This file contains invisible Unicode characters!

This file contains invisible Unicode characters that may be processed differently from what appears below. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to reveal hidden characters.

*** 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.
- AUTOBRIEF is enabled but deprecated, gradually convert to the use of explicit
  @brief command.

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