- Add support for automagically generating API documentation

with Doxygen. Just use ``make apidox''.


git-svn-id: svn://svn.gna.org/svn/sgpemv2/trunk@208 3ecf2c5c-341e-0410-92b4-d18e462d057c

doc/Makefile.am

@@ -18,6 +18,8 @@
 # along with SGPEMv2; if not, write to the Free Software
 # Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
 
+.PHONY : apidox
+
 info_TEXINFOS = sgpem2uman.texi sgpem2dman.texi
 
 licenses = fdl.texi gpl.texi
@@ -25,3 +27,9 @@ licenses = fdl.texi gpl.texi
 sgpem2uman_TEXINFOS = $(licenses) vers-uman.texi
 sgpem2dman_TEXINFOS = $(licenses) vers-dman.texi
 
+apidox :
+if HAVE_DOXYGEN
+	doxygen @top_builddir@/config/Doxyfile
+else
+	@echo "** Doxygen not installed. Skipping generating API docs."
+endif

doc/sgpem2uman.texi

@@ -85,6 +85,10 @@ Free Documentation License''.
 
 @table @strong
 
+@item 2006, January 26th @r{--- Matteo Settenvini}
+Add subsection about how to generate code documentation
+via Doxygen.
+
 @item 2005, December 11th @r{--- Matteo Settenvini}
 Added full license text.
 
@@ -111,10 +115,11 @@ First draft of this document.
 @cindex  SGPEM
 @cindex  description
 
-SGPEM is an Italian acronym, standing for ``@emph{Simulatore della Gestione dei Processi in un Elaboratore Multiprogrammato}'' (in English, 
-``@emph{Multitasking Computer Process Management Simulator}'').
-It was initially developed for use inside the Course in Computer Science
-of the Padova University, Italy.
+SGPEM is an Italian acronym, standing for ``@emph{Simulatore della Gestione dei Processi 
+in un Elaboratore Multiprogrammato}'' (in English, ``@emph{Multitasking Computer Process 
+Management Simulator}'').
+It was initially developed for use inside the ``Operating Systems'' teaching,
+part of the Computer Science course of the University of Padova, Italy.
 
 SGPEMv2 is a didactic software aiming...
 
@@ -225,6 +230,16 @@ will sufficit).
 See the ``@file{INSTALL}'' file in this folder for an overview of other 
 (less common) autoconf options.
 
+@subsection Generating API documentation
+
+We added Doxygen support to the project. If you've installed it, 
+you can simply run @command{make apidox} from the package 
+top source directory. The documentation will be outputted into
+the @samp{$@{BUILD_DIR@}/docs/API/} directory.
+
+If you'd like to generate nicier inheritance graphs, you've just to
+install @command{dot}, part of the @emph{Graphviz} package.
+
 @c % --------------------------------------------------
 
 @c include license text