Resync new repository with old repo r5166

git-svn-id: http://svn.code.sf.net/p/nuttx/code/trunk@5153 42af7a65-404d-4744-a932-0658087f49c3

NxWidgets/Doxygen/README.txt

@@ -0,0 +1,64 @@
+README
+======
+
+This directory contains the documentation automatically generated by Doxygen.
+
+Contents
+========
+
+  o Installing the necessary packages in Ubuntu
+  o Generating documentation
+  o References
+
+Installing the necessary packages in Ubuntu
+===========================================
+
+1. Install the following packages.
+
+  $ sudo aptitude install doxygen doxygen-doc doxygen-gui dot2tex graphviz
+
+2. (Optional) Install Doxygen from the latest sourcode.
+
+  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 [1]:
+
+  $ svn co https://doxygen.svn.sourceforge.net/svnroot/doxygen/trunk doxygen-svn
+  $ cd doxygen-svn
+  $ ./configure
+  $ make
+  $ make install
+
+Generating documentation
+========================
+
+Two ways described here:
+
+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:
+
+    $ cd /path/to/nuttx/trunk/NXWidgets/Doxygen/
+    $ doxygen Doxyfile
+
+References
+==========
+
+[1] http://www.stack.nl/~dimitri/doxygen/download.html

NxWidgets/Doxygen/gendoc.sh

@@ -0,0 +1,94 @@
+#!/bin/bash
+#################################################################################
+# NxWidgets/Doxygen/gendoc.sh
+#
+#   Copyright (C) 2012 Gregory Nutt. All rights reserved.
+#   Author: Jose Pablo Carballo <jcarballo@nx-engineering.com>
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+#
+# 1. Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright
+#    notice, this list of conditions and the following disclaimer in
+#    the documentation and/or other materials provided with the
+#    distribution.
+# 3. Neither the name NuttX, NxWidgets, nor the names of its contributors
+#    me be used to endorse or promote products derived from this software
+#    without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+# FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+# COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+# BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
+# OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+# AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+# ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+#
+#################################################################################
+#
+# set -x
+# Functions
+
+function ShowUsage()
+{
+    echo ""
+    echo "USAGE: $0 <doxygen-output-directory-path>"
+    echo ""
+    echo "Where:"
+    echo " <doxygen-output-directory-path> is the full, absolut path to place the doxygen output"
+    echo ""
+}
+
+# Input parameters
+
+DOXYGENOUTPUT_DIR=$1
+if [ -z "${DOXYGENOUTPUT_DIR}" ]; then
+    echo "Missing required arguments"
+    ShowUsage
+    exit 1
+fi
+
+# Check that the directory exist
+
+if [ ! -d "${DOXYGENOUTPUT_DIR}" ]; then
+    echo "Directory ${DOXYGENOUTPUT_DIR} does not exist"
+    exit 1
+fi
+
+# Find the doxygen configuration file
+
+DOXYFILE="Doxyfile"
+if [ ! -e "${DOXYFILE}" ]; then
+    echo "This script must be executed in the documentation/ directory"
+    exit 1
+fi
+
+doxygen "${DOXYFILE}" || \
+    {
+        echo "Failed to run doxygen"; \
+        exit 1;
+    
+    }
+
+cp -rf html "${DOXYGENOUTPUT_DIR}" || \
+    {
+        echo "Failed to move html output"; \
+        exit 1;
+    }
+
+rm -rf html || \
+    {
+        echo "Failed to remove the html/ directory"; \
+        exit 1;
+    }
+
+echo "open ${DOXYGENOUTPUT_DIR}/html/index.html to start browsing"
+