On Wed, 2009-07-01 at 18:16 -0700, Zach Welch wrote: > Hi all, > > I have been thinking about adding some supplemental "source" packages, > which can be used by OpenOCD distributors as they see fit: > - openocd-user-guide: both PDF and HTML versions (or separated?) > - openocd-developer-manual: both PDF and HTML versions (ditto?) > > Some of these things require more work to produce or package, but I have > a patch that improves the doxygen output to produce an (enormous) PDF > version of the Developer Manual. This makes the main page and > introductory text pages that I have put in place _much_ more readable, > as they are presented in a linear format.
If anyone wants to play with my patch and see the PDF manual for themselves, it is attached below, and it applies with only a little bit of fuzz. This patch does more than that one change, so beware. Cheers, Zach
Index: Makefile.am =================================================================== --- Makefile.am (revision 1931) +++ Makefile.am (working copy) @@ -25,10 +25,17 @@ sed -e 's,@srcdir\@,$(srcdir),' $< \ ) > $@ +THE_MANUAL = doxygen/latex/refman.pdf + doxygen:: $(MAKE) Doxyfile doxygen Doxyfile 2>&1 | perl $(srcdir)/tools/logger.pl > doxygen.log + $(MAKE) $(THE_MANUAL) +%.pdf: %.tex + -cd $$(dirname $*) && pdflatex $$(basename $*) + -cd $$(dirname $*) && pdflatex $$(basename $*) + TCL_PATH = tcl # command to find paths of script files, relative to TCL_PATH TCL_FILES := find $(srcdir)/$(TCL_PATH) -name '*.cfg' -o -name '*.tcl' | \ Index: Doxyfile.in =================================================================== --- Doxyfile.in (revision 1931) +++ Doxyfile.in (working copy) @@ -38,7 +38,7 @@ # If a relative path is entered, it will be relative to the location # where doxygen was started. If left blank the current directory will be used. -OUTPUT_DIRECTORY = +OUTPUT_DIRECTORY = doxygen # If the CREATE_SUBDIRS tag is set to YES, then doxygen will create # 4096 sub-directories (in 2 levels) under the output directory of each output @@ -770,7 +770,7 @@ # If a relative path is entered the value of OUTPUT_DIRECTORY will be # put in front of it. If left blank `html' will be used as the default path. -HTML_OUTPUT = doxygen +HTML_OUTPUT = html # The HTML_FILE_EXTENSION tag can be used to specify the file extension for # each generated HTML page (for example: .htm,.php,.asp). If it is left blank @@ -981,7 +981,7 @@ # If the GENERATE_LATEX tag is set to YES (the default) Doxygen will # generate Latex output. -GENERATE_LATEX = NO +GENERATE_LATEX = YES # The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. # If a relative path is entered the value of OUTPUT_DIRECTORY will be @@ -992,7 +992,7 @@ # The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be # invoked. If left blank `latex' will be used as the default command name. -LATEX_CMD_NAME = latex +LATEX_CMD_NAME = pdflatex # The MAKEINDEX_CMD_NAME tag can be used to specify the command name to # generate index for LaTeX. If left blank `makeindex' will be used as the @@ -1004,7 +1004,7 @@ # LaTeX documents. This may be useful for small projects and may help to # save some trees in general. -COMPACT_LATEX = NO +COMPACT_LATEX = YES # The PAPER_TYPE tag can be used to set the paper type that is used # by the printer. Possible values are: a4, a4wide, letter, legal and @@ -1029,20 +1029,20 @@ # contain links (just like the HTML output) instead of page references # This makes the output suitable for online browsing using a pdf viewer. -PDF_HYPERLINKS = NO +PDF_HYPERLINKS = YES # If the USE_PDFLATEX tag is set to YES, pdflatex will be used instead of # 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.)
_______________________________________________ Openocd-development mailing list [email protected] https://lists.berlios.de/mailman/listinfo/openocd-development
