[xiph-commits] r17831 - trunk/theora/doc

[giles at svn.xiph.org]

Author: giles
Date: 2011-02-10 16:25:49 -0800 (Thu, 10 Feb 2011)
New Revision: 17831

Modified:
   trunk/theora/doc/Doxyfile.in
   trunk/theora/doc/Makefile.am
Log:
Prefer pdflatex and use batch mode when generating API docs.

We normally ask doxygen to generate latex source, but don't
actually run it through latex as part of the standard build.
If desired, a 'refman.pdf' can be created manually with
'make -C doc/libtheora/latex'.

Using latex+dvipdf turns out not to work, and pdflatex generally
does a better job anyway.


Modified: trunk/theora/doc/Doxyfile.in
===================================================================
--- trunk/theora/doc/Doxyfile.in	2011-02-11 00:22:05 UTC (rev 17830)
+++ trunk/theora/doc/Doxyfile.in	2011-02-11 00:25:49 UTC (rev 17831)
@@ -1142,14 +1142,14 @@
 # plain latex in the generated Makefile. Set this option to YES to get a
 # higher quality PDF documentation.
 
-USE_PDFLATEX           = NO
+USE_PDFLATEX           = YES
 
 # If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \\batchmode.
 # command to the generated LaTeX files. This will instruct LaTeX to keep
 # running if errors occur, instead of asking the user for help.
 # This option is also used when generating formulas in HTML.
 
-LATEX_BATCHMODE        = NO
+LATEX_BATCHMODE        = YES
 
 # If LATEX_HIDE_INDICES is set to YES then doxygen will not
 # include the index chapters (such as File Index, Compound Index, etc.)

Modified: trunk/theora/doc/Makefile.am
===================================================================
--- trunk/theora/doc/Makefile.am	2011-02-11 00:22:05 UTC (rev 17830)
+++ trunk/theora/doc/Makefile.am	2011-02-11 00:25:49 UTC (rev 17831)
@@ -8,7 +8,7 @@
 
 doc_DATA = $(static_docs) doxygen-build.stamp
 
-EXTRA_DIST = $(static_docs) Doxyfile.in
+EXTRA_DIST = $(static_docs) Doxyfile.in doxygen-build.stamp
 
 if HAVE_DOXYGEN
 doxygen-build.stamp: Doxyfile $(top_srcdir)/include/theora/*.h
@@ -66,7 +66,7 @@
 uninstall-local:
 	rm -rf $(DESTDIR)$(docdir)
 
-clean-local:
+maintainer-clean-local:
 	if test -d libtheora; then rm -rf libtheora; fi
 	if test -f doxygen-build.stamp; then rm -f doxygen-build.stamp; fi