diff options
author | Benjamin Kosnik <bkoz@redhat.com> | 2010-07-20 06:43:02 +0000 |
---|---|---|
committer | Benjamin Kosnik <bkoz@gcc.gnu.org> | 2010-07-20 06:43:02 +0000 |
commit | 547f963b5a77e253a81de517b0d137e2a083f776 (patch) | |
tree | 623f468ed946a7025e06a945f3f8e793323fc5f1 | |
parent | 13411c9d4c0fb1c35998d67d6d9ce112db4651c9 (diff) | |
download | gcc-547f963b5a77e253a81de517b0d137e2a083f776.zip gcc-547f963b5a77e253a81de517b0d137e2a083f776.tar.gz gcc-547f963b5a77e253a81de517b0d137e2a083f776.tar.bz2 |
Makefile.am (doc-texinfo): New rule.
2010-07-19 Benjamin Kosnik <bkoz@redhat.com>
* doc/Makefile.am (doc-texinfo): New rule.
(doc-texinfo-docbook): New rule.
(DB2TEXI_FLAGS): New.
(doc-xml-single-docbook): Just the manual, not the set. Tweak flags.
* doc/Makefile.in: Regenerate.
From-SVN: r162327
-rw-r--r-- | libstdc++-v3/ChangeLog | 8 | ||||
-rw-r--r-- | libstdc++-v3/doc/Makefile.am | 30 | ||||
-rw-r--r-- | libstdc++-v3/doc/Makefile.in | 32 |
3 files changed, 58 insertions, 12 deletions
diff --git a/libstdc++-v3/ChangeLog b/libstdc++-v3/ChangeLog index 2d41140..cb0c735 100644 --- a/libstdc++-v3/ChangeLog +++ b/libstdc++-v3/ChangeLog @@ -1,3 +1,11 @@ +2010-07-19 Benjamin Kosnik <bkoz@redhat.com> + + * doc/Makefile.am (doc-texinfo): New rule. + (doc-texinfo-docbook): New rule. + (DB2TEXI_FLAGS): New. + (doc-xml-single-docbook): Just the manual, not the set. Tweak flags. + * doc/Makefile.in: Regenerate. + 2010-07-14 Jonathan Wakely <jwakely.gcc@gmail.com> * doc/xml/manual/shared_ptr.xml: Update. diff --git a/libstdc++-v3/doc/Makefile.am b/libstdc++-v3/doc/Makefile.am index 8c708ff..1454140 100644 --- a/libstdc++-v3/doc/Makefile.am +++ b/libstdc++-v3/doc/Makefile.am @@ -52,6 +52,9 @@ doc-html: doc-html-docbook doc-html-doxygen cp -R ${docbook_outdir}/html ./libstdc++-manual.html cp -R ${doxygen_outdir}/html ./libstdc++-api.html +# TEXINFO +doc-texinfo: doc-texinfo-docbook + # Doxygen configuration # Assumes doxygen, graphviz (with dot), pdflatex installed doxygen_script=${top_srcdir}/scripts/run_doxygen @@ -216,14 +219,17 @@ XSL_HTML_STYLE = $(XSL_STYLE_DIR)/xhtml/chunk.xsl #XSL_HTML_SINGLE_STYLE = $(XSL_STYLE_DIR)/xhtml/onechunk.xsl XSL_HTML_SINGLE_STYLE = $(XSL_STYLE_DIR)/xhtml/docbook.xsl +${docbook_outdir}/fo: + mkdir -p ${docbook_outdir}/fo + ${docbook_outdir}/html: mkdir -p ${docbook_outdir}/html ${docbook_outdir}/pdf: mkdir -p ${docbook_outdir}/pdf -${docbook_outdir}/fo: - mkdir -p ${docbook_outdir}/fo +${docbook_outdir}/texinfo: + mkdir -p ${docbook_outdir}/texinfo ${docbook_outdir}/xml: mkdir -p ${docbook_outdir}/xml @@ -239,11 +245,14 @@ doc-xml-validate-docbook: $(xml_sources) @echo "Generating XML validation log..." $(XMLLINT) $(XMLLINT_FLAGS) ${top_srcdir}/doc/xml/spine.xml -manual_xml = ${docbook_outdir}/xml/libstdc++-manual.xml +# XML, all one page +# Some info on canonicalization +# http://www.mail-archive.com/help-texinfo@gnu.org/msg00864.html +manual_xml = ${docbook_outdir}/xml/libstdc++-manual-single.xml doc-xml-single-docbook: $(xml_sources) ${docbook_outdir}/xml @echo "Generating XML single..." - $(XMLLINT) --xinclude --noent --noblanks \ - -o ${manual_xml} ${top_srcdir}/doc/xml/spine.xml + $(XMLLINT) --xinclude --noent --noblanks --nocdata --nsclean --c14n \ + ${top_srcdir}/doc/xml/manual/spine.xml > ${manual_xml} # HTML, index plus chapters doc-html-docbook: $(xml_sources) ${docbook_outdir}/html @@ -267,13 +276,22 @@ doc-fo-docbook: $(xml_sources) ${docbook_outdir}/fo # PDF, via dblatex manual_pdf = ${docbook_outdir}/pdf/libstdc++-manual.pdf DBLATEX_FLAGS = --dump --verbose --pdf -o ${manual_pdf} - doc-pdf-docbook: doc-pdf-dblatex-docbook doc-pdf-dblatex-docbook: $(xml_sources) ${docbook_outdir}/pdf @echo "Generating pdf dblatex files..." dblatex $(DBLATEX_FLAGS) ${top_srcdir}/doc/xml/spine.xml +# Texinfo, via docbook2X +DB2TEXI_FLAGS = \ + --encoding=utf-8//TRANSLIT \ + --string-param output-file="libstdc++-manual" \ + --string-param directory-category="GNU C++ Library" \ + --string-param explicit-node-names=true +doc-texinfo-docbook: doc-xml-single-docbook ${docbook_outdir}/texinfo + @echo "Generating texinfo files..." + db2x_docbook2texi $(DB2TEXI_FLAGS) ${manual_xml} + # Performance doc and graph configuration. # Assumes pychart, beautiful soup installed. diff --git a/libstdc++-v3/doc/Makefile.in b/libstdc++-v3/doc/Makefile.in index fda2476..fbdfb51 100644 --- a/libstdc++-v3/doc/Makefile.in +++ b/libstdc++-v3/doc/Makefile.in @@ -371,7 +371,11 @@ XMLLINT = xmllint LINT_FLAGS = --postvalid --debug --xinclude --noent --noblanks --nonet --noout DTD_FLAGS = --dtdvalid http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd XMLLINT_FLAGS = $(LINT_FLAGS) $(DTD_FLAGS) -manual_xml = ${docbook_outdir}/xml/libstdc++-manual.xml + +# XML, all one page +# Some info on canonicalization +# http://www.mail-archive.com/help-texinfo@gnu.org/msg00864.html +manual_xml = ${docbook_outdir}/xml/libstdc++-manual-single.xml # HTML, all one page manual_html = ${docbook_outdir}/html/libstdc++-manual-single.html @@ -380,6 +384,14 @@ manual_html = ${docbook_outdir}/html/libstdc++-manual-single.html manual_pdf = ${docbook_outdir}/pdf/libstdc++-manual.pdf DBLATEX_FLAGS = --dump --verbose --pdf -o ${manual_pdf} +# Texinfo, via docbook2X +DB2TEXI_FLAGS = \ + --encoding=utf-8//TRANSLIT \ + --string-param output-file="libstdc++-manual" \ + --string-param directory-category="GNU C++ Library" \ + --string-param explicit-node-names=true + + # Performance doc and graph configuration. # Assumes pychart, beautiful soup installed. # Generates the plots and graphs for performance testing. @@ -572,6 +584,9 @@ doc-html: doc-html-docbook doc-html-doxygen cp -R ${docbook_outdir}/html ./libstdc++-manual.html cp -R ${doxygen_outdir}/html ./libstdc++-api.html +# TEXINFO +doc-texinfo: doc-texinfo-docbook + doc-html-doxygen: -(srcdir=`cd ${top_srcdir}; ${PWD_COMMAND}`; \ builddir=`cd ..; ${PWD_COMMAND}`; \ @@ -634,14 +649,17 @@ stamp-latex-doxygen: fi $(STAMP) stamp-latex-doxygen +${docbook_outdir}/fo: + mkdir -p ${docbook_outdir}/fo + ${docbook_outdir}/html: mkdir -p ${docbook_outdir}/html ${docbook_outdir}/pdf: mkdir -p ${docbook_outdir}/pdf -${docbook_outdir}/fo: - mkdir -p ${docbook_outdir}/fo +${docbook_outdir}/texinfo: + mkdir -p ${docbook_outdir}/texinfo ${docbook_outdir}/xml: mkdir -p ${docbook_outdir}/xml @@ -650,8 +668,8 @@ doc-xml-validate-docbook: $(xml_sources) $(XMLLINT) $(XMLLINT_FLAGS) ${top_srcdir}/doc/xml/spine.xml doc-xml-single-docbook: $(xml_sources) ${docbook_outdir}/xml @echo "Generating XML single..." - $(XMLLINT) --xinclude --noent --noblanks \ - -o ${manual_xml} ${top_srcdir}/doc/xml/spine.xml + $(XMLLINT) --xinclude --noent --noblanks --nocdata --nsclean --c14n \ + ${top_srcdir}/doc/xml/manual/spine.xml > ${manual_xml} # HTML, index plus chapters doc-html-docbook: $(xml_sources) ${docbook_outdir}/html @@ -668,12 +686,14 @@ doc-fo-docbook: $(xml_sources) ${docbook_outdir}/fo @echo "Generating FO files..." $(XSLTPROC) $(XSLTPROC_FLAGS) -o ${docbook_outdir}/fo/spine.fo \ $(XSL_FO_STYLE) ${top_srcdir}/doc/xml/spine.xml - doc-pdf-docbook: doc-pdf-dblatex-docbook doc-pdf-dblatex-docbook: $(xml_sources) ${docbook_outdir}/pdf @echo "Generating pdf dblatex files..." dblatex $(DBLATEX_FLAGS) ${top_srcdir}/doc/xml/spine.xml +doc-texinfo-docbook: doc-xml-single-docbook ${docbook_outdir}/texinfo + @echo "Generating texinfo files..." + db2x_docbook2texi $(DB2TEXI_FLAGS) ${manual_xml} doc-html-performance: -@(chmod + ${doc_performance_script}; \ ${doc_performance_script} ${top_srcdir} \ |