mirror of https://github.com/postgres/postgres
Add some information about increasing JadeTeX parameters.
This commit is contained in:
Peter Eisentraut
parent
465269b8ad
commit
0a265e487b
|
|
@ -1,4 +1,4 @@
|
|||
<!-- $PostgreSQL: pgsql/doc/src/sgml/docguide.sgml,v 1.59 2006/10/23 18:10:30 petere Exp $ -->
|
||||
<!-- $PostgreSQL: pgsql/doc/src/sgml/docguide.sgml,v 1.60 2006/12/10 02:37:40 petere Exp $ -->
|
||||
|
||||
<appendix id="docguide">
|
||||
<title>Documentation</title>
|
||||
|
|
@ -20,7 +20,7 @@
|
|||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
PDF or Postscript, for printing
|
||||
PDF or PostScript, for printing
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
|
|
@ -38,7 +38,7 @@
|
|||
<para>
|
||||
<acronym>HTML</acronym> documentation and man pages are part of a
|
||||
standard distribution and are installed by default. PDF and
|
||||
Postscript format documentation is available separately for
|
||||
PostScript format documentation is available separately for
|
||||
download.
|
||||
</para>
|
||||
|
||||
|
|
@ -149,7 +149,7 @@
|
|||
<productname>JadeTeX</productname> to use
|
||||
<productname>TeX</productname> as a formatting backend for
|
||||
<productname>Jade</productname>.
|
||||
<application>JadeTeX</application> can create Postscript or
|
||||
<application>JadeTeX</application> can create PostScript or
|
||||
<acronym>PDF</acronym> files (the latter with bookmarks).
|
||||
</para>
|
||||
|
||||
|
|
@ -250,10 +250,12 @@ CATALOG "/usr/local/share/sgml/docbook/4.2/docbook.cat"
|
|||
available for <productname>Debian GNU/Linux</productname>.
|
||||
To install, simply use:
|
||||
<programlisting>
|
||||
apt-get install jade
|
||||
apt-get install openjade1.3
|
||||
apt-get install docbook
|
||||
apt-get install docbook-stylesheets
|
||||
apt-get install docbook-dsssl
|
||||
</programlisting>
|
||||
(The plain <literal>openjade</literal> package installs
|
||||
OpenJade 1.4, which seems not to work.)
|
||||
</para>
|
||||
</sect2>
|
||||
|
||||
|
|
@ -449,7 +451,7 @@ CATALOG "docbook-dsssl-1.<replaceable>xx</>/catalog"
|
|||
<productname>url</productname> and
|
||||
<productname>ot2enc</productname>. All of these can be found on
|
||||
your friendly neighborhood <ulink url="http://www.ctan.org">
|
||||
<acronym>CTAN site</acronym></ulink>.
|
||||
<acronym>CTAN</acronym> site</ulink>.
|
||||
The installation of the <application>TeX</application> base
|
||||
system is far beyond the scope of this introduction. Binary
|
||||
packages should be available for any system that can run
|
||||
|
|
@ -589,7 +591,7 @@ gmake man.tar.gz
|
|||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>Print Output via <application>JadeTex</application></title>
|
||||
<title>Print Output via <application>JadeTeX</application></title>
|
||||
|
||||
<para>
|
||||
If you want to use <application>JadeTex</application> to produce a
|
||||
|
|
@ -608,7 +610,7 @@ gmake man.tar.gz
|
|||
|
||||
<listitem>
|
||||
<para>
|
||||
To generate Postscript from the <acronym>DVI</acronym>:
|
||||
To generate PostScript from the <acronym>DVI</acronym>:
|
||||
<screen>
|
||||
<prompt>doc/src/sgml$ </prompt><userinput>gmake postgres.ps</userinput>
|
||||
</screen>
|
||||
|
|
@ -622,12 +624,31 @@ gmake man.tar.gz
|
|||
<prompt>doc/src/sgml$ </prompt><userinput>gmake postgres.pdf</userinput>
|
||||
</screen>
|
||||
(Of course you can also make a <acronym>PDF</acronym> version
|
||||
from the Postscript, but if you generate <acronym>PDF</acronym>
|
||||
from the PostScript, but if you generate <acronym>PDF</acronym>
|
||||
directly, it will have hyperlinks and other enhanced features.)
|
||||
</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</para>
|
||||
|
||||
<para>
|
||||
When using JadeTeX to build the PostgreSQL documentation, you will
|
||||
probably need to increase some of TeX's internal parameters. These
|
||||
can be set in the file <filename>texmf.cnf</filename>. The following
|
||||
settings worked at the time of this writing:
|
||||
<programlisting>
|
||||
hash_extra.jadetex = 200000
|
||||
hash_extra.pdfjadetex = 200000
|
||||
pool_size.jadetex = 2000000
|
||||
pool_size.pdfjadetex = 2000000
|
||||
string_vacancies.jadetex = 150000
|
||||
string_vacancies.pdfjadetex = 150000
|
||||
max_strings.jadetex = 300000
|
||||
max_strings.pdfjadetex = 300000
|
||||
save_size.jadetex = 10000
|
||||
save_size.pdfjadetex = 10000
|
||||
</programlisting>
|
||||
</para>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
|
|
@ -638,7 +659,7 @@ gmake man.tar.gz
|
|||
documentation by converting it to <acronym>RTF</acronym> and
|
||||
applying minor formatting corrections using an office suite.
|
||||
Depending on the capabilities of the particular office suite, you
|
||||
can then convert the documentation to Postscript of
|
||||
can then convert the documentation to PostScript of
|
||||
<acronym>PDF</acronym>. The procedure below illustrates this
|
||||
process using <productname>Applixware</productname>.
|
||||
</para>
|
||||
|
|
@ -861,7 +882,7 @@ gmake man.tar.gz
|
|||
<step performance="required">
|
||||
<para>
|
||||
<quote>Print</quote> the document
|
||||
to a file in Postscript format.
|
||||
to a file in PostScript format.
|
||||
</para>
|
||||
</step>
|
||||
</procedure>
|
||||
|
|
|
|||
Loading…
Reference in New Issue