This is the mail archive of the
libstdc++@gcc.gnu.org
mailing list for the libstdc++ project.
Re: [Tom Browder] Re: libstdc++ Manual in pdf?
- From: Benjamin Kosnik <bkoz at redhat dot com>
- To: libstdc++ at gcc dot gnu dot org
- Date: Thu, 9 Sep 2010 09:59:54 -0700
- Subject: Re: [Tom Browder] Re: libstdc++ Manual in pdf?
- References: <mcrbp86eut1.fsf@google.com>
> What's up with this? We use non-free software to generate the PDF
> version of the libstdc++ manual?
Just look at libstdc++-v3/doc/Makefile.am please. You will see:
# PDF
doc-pdf: doc-pdf-docbook doc-pdf-doxygen
cp ${docbook_outdir}/pdf/libstdc++-manual.pdf .
cp ${doxygen_outdir}/pdf/libstdc++-api.pdf .
# 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
Or, translating for the lazy, this uses dblatex, which is GPLv2+.
Nothing to see here.
-benjamin
ps. previous releases (pre-4.5) didn't actually support PDF, and did
have options to use prince, apache fop, and various other tools.
Nothing was really standardized. Then dblatex came along with the
correct support for docbook, and libstdc++ switched to it (and made
the necessary markup changes for indexing) as it provided the best
quality output, period. If you can find something better that is also
free I'm all ears.