diff options
| author | gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4> | 2008-10-17 18:33:35 +0000 |
|---|---|---|
| committer | gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4> | 2008-10-17 18:33:35 +0000 |
| commit | 1d23eb296156769cff3e41bd7026db1cd2538664 (patch) | |
| tree | 512bbaa17560196c09dcce171bcb28a367838542 /docs | |
| parent | 3d3e5728aa1d14444b99732426d36f6375013727 (diff) | |
| download | ChibiOS-1d23eb296156769cff3e41bd7026db1cd2538664.tar.gz ChibiOS-1d23eb296156769cff3e41bd7026db1cd2538664.tar.bz2 ChibiOS-1d23eb296156769cff3e41bd7026db1cd2538664.zip | |
git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@474 35acf78f-673a-0410-8e92-d51de3d6d3f4
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/Doxyfile | 2 | ||||
| -rw-r--r-- | docs/ch.txt | 10 | ||||
| -rw-r--r-- | docs/readme.txt | 35 |
3 files changed, 46 insertions, 1 deletions
diff --git a/docs/Doxyfile b/docs/Doxyfile index b9baae9ad..98fe036c1 100644 --- a/docs/Doxyfile +++ b/docs/Doxyfile @@ -9,7 +9,7 @@ PROJECT_NUMBER = "0.7.2 beta" OUTPUT_DIRECTORY = . CREATE_SUBDIRS = NO OUTPUT_LANGUAGE = English -BRIEF_MEMBER_DESC = NO +BRIEF_MEMBER_DESC = YES REPEAT_BRIEF = YES ABBREVIATE_BRIEF = "The $name class" \ "The $name widget" \ diff --git a/docs/ch.txt b/docs/ch.txt index 05d38e33c..de2db1c6f 100644 --- a/docs/ch.txt +++ b/docs/ch.txt @@ -329,6 +329,16 @@ /** @} */
/**
+ * @defgroup ThreadLists Thread Lists and Queues
+ * @{
+ * ChibiOS/RT thread lists and queues utilities.
+ * @ingroup Kernel
+ * @file chlists.c Lists and queues code.
+ * @file lists.h Lists and queues macros and structures.
+ */
+/** @} */
+
+/**
* @defgroup Threads Threads
* @{
* Threads creation and termination APIs.
diff --git a/docs/readme.txt b/docs/readme.txt new file mode 100644 index 000000000..730d20072 --- /dev/null +++ b/docs/readme.txt @@ -0,0 +1,35 @@ +*** 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:
+- Doxigen 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 doxigen.
+
+Build procedure:
+- Run Doxiwizard.
+- Load ./docs/Doxifile from Doxiwizard.
+- 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.
|