Add some information about increasing JadeTeX parameters.

diff --git a/doc/src/sgml/docguide.sgml b/doc/src/sgml/docguide.sgml
index 2a58b56a2be72f43939428e4898c75e87a5612f1..68359fdd307b88918ecd2d5482709ed7e52628a0 100644 (file)
--- a/doc/src/sgml/docguide.sgml
+++ b/doc/src/sgml/docguide.sgml
@@ -1,4 +1,4 @@
-
+
 
 
  Documentation
@@ -20,7 +20,7 @@
    
    
     
-     PDF or Postscript, for printing
+     PDF or PostScript, for printing
     
    
    
@@ -38,7 +38,7 @@
  
   HTML 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.
  
 
@@ -149,7 +149,7 @@
        JadeTeX to use
        TeX as a formatting backend for
        Jade.
-       JadeTeX can create Postscript or
+       JadeTeX can create PostScript or
        PDF files (the latter with bookmarks).
       
 
@@ -250,10 +250,12 @@ CATALOG "/usr/local/share/sgml/docbook/4.2/docbook.cat"
     available for Debian GNU/Linux.
     To install, simply use:
 
-apt-get install jade
+apt-get install openjade1.3
 apt-get install docbook
-apt-get install docbook-stylesheets
+apt-get install docbook-dsssl
 
+    (The plain openjade package installs
+    OpenJade 1.4, which seems not to work.)
    
   
 
@@ -449,7 +451,7 @@ CATALOG "docbook-dsssl-1.xx/catalog"
      url and
      ot2enc.  All of these can be found on
      your friendly neighborhood 
-     CTAN site.
+     CTAN site.
      The installation of the TeX 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
  
 
   
-   Print Output via <application>JadeTe<span class="marked">x</span></application>
+   Print Output via <application>JadeTe<span class="marked">X</span></application>
 
    
     If you want to use JadeTex to produce a
@@ -608,7 +610,7 @@ gmake man.tar.gz
 
      
       
-       To generate Postscript from the DVI:
+       To generate PostScript from the DVI:
 
 doc/src/sgml$ gmake postgres.ps
 
@@ -622,12 +624,31 @@ gmake man.tar.gz
 doc/src/sgml$ gmake postgres.pdf
 
        (Of course you can also make a PDF version
-       from the Postscript, but if you generate PDF
+       from the PostScript, but if you generate PDF
        directly, it will have hyperlinks and other enhanced features.)
       
      
     
    
+
+   
+    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 texmf.cnf.  The following
+    settings worked at the time of this writing:
+
+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
+
+   
   
 
   
@@ -638,7 +659,7 @@ gmake man.tar.gz
     documentation by converting it to RTF 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
     PDF.  The procedure below illustrates this
     process using Applixware.
    
@@ -861,7 +882,7 @@ gmake man.tar.gz
     
      
       Print the document
-      to a file in Postscript format.
+      to a file in PostScript format.