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.

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

doc/Doxyfile.in

@@ -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.)

doc/Makefile.am

@@ -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