summaryrefslogtreecommitdiff
path: root/NxWidgets/Doxygen
diff options
context:
space:
mode:
authorpatacongo <patacongo@42af7a65-404d-4744-a932-0658087f49c3>2012-03-27 15:01:22 +0000
committerpatacongo <patacongo@42af7a65-404d-4744-a932-0658087f49c3>2012-03-27 15:01:22 +0000
commit2a4b0b1d5da5d20a1145f5bcdd845c3b49cae7bd (patch)
treea89c8f8f869b6ccfa7f2f2a8340e64842f336fad /NxWidgets/Doxygen
parent433c65557b66a9e8d2c4ed69e4fb219e202836b8 (diff)
downloadnuttx-2a4b0b1d5da5d20a1145f5bcdd845c3b49cae7bd.tar.gz
nuttx-2a4b0b1d5da5d20a1145f5bcdd845c3b49cae7bd.tar.bz2
nuttx-2a4b0b1d5da5d20a1145f5bcdd845c3b49cae7bd.zip
Update NxWidgets Doxygen support
git-svn-id: svn://svn.code.sf.net/p/nuttx/code/trunk@4527 42af7a65-404d-4744-a932-0658087f49c3
Diffstat (limited to 'NxWidgets/Doxygen')
-rw-r--r--NxWidgets/Doxygen/README.txt31
1 files changed, 25 insertions, 6 deletions
diff --git a/NxWidgets/Doxygen/README.txt b/NxWidgets/Doxygen/README.txt
index 4546d4903..26d76ce4b 100644
--- a/NxWidgets/Doxygen/README.txt
+++ b/NxWidgets/Doxygen/README.txt
@@ -8,6 +8,7 @@ Contents
o Installing the necessary packages in Ubuntu
o Generating documentation
+ o References
Installing the necessary packages in Ubuntu
===========================================
@@ -16,13 +17,13 @@ Installing the necessary packages in Ubuntu
$ sudo aptitude install doxygen doxygen-doc doxygen-gui dot2tex graphviz
-2. (Optional) Install from the latest sourcode.
+2. (Optional) Install Doxygen from the latest sourcode.
- The Ubuntu package is outdated. The newer the version of Doxygen, the cooler
+ The Ubuntu package is outdated. The newer the version of Doxygen, the better
the documentation looks.
Place yourself in some temporary folder where you can download the source,
- and run (http://www.stack.nl/~dimitri/doxygen/download.html):
+ and run [1]:
$ svn co https://doxygen.svn.sourceforge.net/svnroot/doxygen/trunk doxygen-svn
$ cd doxygen-svn
@@ -33,13 +34,31 @@ Installing the necessary packages in Ubuntu
Generating documentation
========================
-1. Position the shell into this folder:
+Two ways described here:
- misc/NXWidgets/Doxygen
+1. Use the provided gendoc.sh script.
+
+ trunk/NXWidgets/Doxygen/gendoc.sh
+
+ The script only needs the argument to the absolute path where to place the
+ generated documentation. I.e.:
+
+ $ cd /path/to/nuttx/trunk/NXWidgets/Doxygen/
+ $ mkdir doc
+ $ ./gendoc.sh $PWD/doc
+
+
+2. Using the Doxyfile directly:
The file "Doxyfile" contains the configuration of the Doxygen settings
for the run, edit only if necessary.
To generate the documentation type:
- $ doxygen Doxyfile
+ $ cd /path/to/nuttx/trunk/NXWidgets/Doxygen/
+ $ doxygen Doxyfile
+
+References
+==========
+
+[1] http://www.stack.nl/~dimitri/doxygen/download.html