2.2.5 How Texinfo/Info is Produced

The Info format is supported by Emacs and many other tools as a method for browsing large and small documents. Individual chapters and sections are converted into nodes within the Info document.

The Info format is produced by calling makeinfo on the texi file. The texi can be produced directly from the DocBook file format using the XSL stylesheets.

To build the Info file, use the info target:

make mysqldoc-guide.info
XML_CATALOG_FILES="../../mysqldoc-toolset//catalog.xml ../../mysqldoc-toolset/xsl.d/docbook-xsl-1.77.1/catalog.xml" xsltproc --xinclude --novalid  \
        --stringparam current.date "`date "+%Y-%m-%d"`" \
        --stringparam repository.revision "`../../mysqldoc-toolset/tools/get-svn-revision ..`" \
        --param map.remark.to.para 0 \
        --param generate.autolink 0 \
        --stringparam qandaset.style "" \
        --param alternate.legalnotice.location 1 \
        ../../mysqldoc-toolset/xsl.d/dbk-prep.xsl mysqldoc-guide.xml > mysqldoc-guide-collected.xml.tmpprep-1310
mv mysqldoc-guide-collected.xml.tmpprep-1310 mysqldoc-guide-collected.xml
../../mysqldoc-toolset/tools/idremap.pl  \
        --urlcore="" \
        --prefix="mysqldoc-guide-" \
        mysqldoc-guide-collected.xml > mysqldoc-guide-prepped.xml.tmpremap-1310
Replaced 49 entries (from 2 non-local IDs)
mv mysqldoc-guide-prepped.xml.tmpremap-1310 mysqldoc-guide-prepped.xml
XML_CATALOG_FILES="../../mysqldoc-toolset//catalog.xml ../../mysqldoc-toolset/xsl.d/docbook-xsl-1.77.1/catalog.xml" xsltproc --xinclude --novalid   \
        --stringparam l10n.gentext.default.language en \
        ../../mysqldoc-toolset/xsl.d/mysql-info-excludes.xsl mysqldoc-guide-prepped.xml > mysqldoc-guide.texi.tmp-exc
XML_CATALOG_FILES="../../mysqldoc-toolset//catalog.xml ../../mysqldoc-toolset/xsl.d/docbook-xsl-1.77.1/catalog.xml" xsltproc --xinclude --novalid   \
        --stringparam l10n.gentext.default.language en \
        ../../mysqldoc-toolset/xsl.d/dbk-texi.xsl mysqldoc-guide.texi.tmp-exc > mysqldoc-guide.texi.tmp
../../mysqldoc-toolset/tools/fixup-texi.pl mysqldoc-guide.texi.tmp > mysqldoc-guide.texi.tmp2
rm -f mysqldoc-guide.texi.tmp
mv mysqldoc-guide.texi.tmp2 mysqldoc-guide.texi
makeinfo --no-split -I . mysqldoc-guide.texi

The fixup-texi.pl script corrects some problems in the texi output, before it is processed by makeinfo, that are known to cause problems when the file is converted to Info format.