Prefer pdflatex and use batch mode when generating API docs.
authorRalph Giles <giles@xiph.org>
Fri, 11 Feb 2011 00:25:49 +0000 (00:25 +0000)
committerRalph Giles <giles@xiph.org>
Fri, 11 Feb 2011 00:25:49 +0000 (00:25 +0000)
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.

svn path=/trunk/theora/; revision=17831

doc/Doxyfile.in
doc/Makefile.am

index 09f7890..ffb3581 100644 (file)
@@ -1142,14 +1142,14 @@ PDF_HYPERLINKS         = NO
 # 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.)
index 5aeda7d..54e82fd 100644 (file)
@@ -8,7 +8,7 @@ static_docs = vp3-format.txt color.html \
 
 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 @@ install-data-local: doxygen-build.stamp
 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