diff options
author | patacongo <patacongo@42af7a65-404d-4744-a932-0658087f49c3> | 2012-03-27 15:01:22 +0000 |
---|---|---|
committer | patacongo <patacongo@42af7a65-404d-4744-a932-0658087f49c3> | 2012-03-27 15:01:22 +0000 |
commit | 2a4b0b1d5da5d20a1145f5bcdd845c3b49cae7bd (patch) | |
tree | a89c8f8f869b6ccfa7f2f2a8340e64842f336fad /NxWidgets/Doxygen | |
parent | 433c65557b66a9e8d2c4ed69e4fb219e202836b8 (diff) | |
download | px4-nuttx-2a4b0b1d5da5d20a1145f5bcdd845c3b49cae7bd.tar.gz px4-nuttx-2a4b0b1d5da5d20a1145f5bcdd845c3b49cae7bd.tar.bz2 px4-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.txt | 31 |
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 |