[PPL-devel] [GIT] ppl/w3ppl(master): Mention the `TeX capacity exceeded' problem in the FAQ.

[Enea Zaffanella]

Module: ppl/w3ppl
Branch: master
Commit: a9116a2df725e8736dcea833088207ee50f874f0
URL:    http://www.cs.unipr.it/git/gitweb.cgi?p=ppl/w3ppl.git;a=commit;h=a9116a2df725e8736dcea833088207ee50f874f0

Author: Enea Zaffanella <zaffanella at cs.unipr.it>
Date:   Tue Apr 14 13:16:20 2009 +0200

Mention the `TeX capacity exceeded' problem in the FAQ.

---

 htdocs/Documentation/how_to_get_it.raw |   25 +++++++++++++++++++++++++
 htdocs/FAQ.raw                         |   25 +++++++++++++++++++++++++
 2 files changed, 50 insertions(+), 0 deletions(-)

diff --git a/htdocs/Documentation/how_to_get_it.raw b/htdocs/Documentation/how_to_get_it.raw
index 1ec2ff5..0e91926 100644
--- a/htdocs/Documentation/how_to_get_it.raw
+++ b/htdocs/Documentation/how_to_get_it.raw
@@ -188,3 +188,28 @@ there are similar targets using the prefix `<code>devref</code>'
 instead of `<code>user</code>'.
 Finally, the command `<CODE>make world</CODE>' will build all
 the available documentation in all of the above formats.
+
+<A NAME="LaTeX-Error">
+<H3>A Common LaTeX Error Message and Its Solution</H3>
+
+While compiling some PostScript or PDF documentation, it is possible that
+LaTeX dies with a <CODE>TeX capacity exceeded</CODE> error message.
+The error should contain the indication of the TeX buffer whose capacity
+has been exceeded, e.g.:
+<PRE>
+  ! TeX capacity exceeded, sorry [save size=5000].
+</PRE>
+You than need to edit the file that defines the buffer sizes
+(<CODE>texmf.cnf</CODE> on teTeX, <CODE>20sizes.cnf</CODE> on TeX Live)
+increasing the value of the corresponding buffer.
+Continuing our example, we can double <CODE>save_size</CODE>
+by editing <CODE>texmf.cfg</CODE> so that the relevant line becomes
+<PRE>
+  save_size = 10000        % for saving values outside current group
+</PRE>
+Any change to such configuration files should be followed by running
+the command
+<PRE>
+  texconfig init
+</PRE>
+for the change to become effective.
diff --git a/htdocs/FAQ.raw b/htdocs/FAQ.raw
index 76e95f4..7d25bbc 100644
--- a/htdocs/FAQ.raw
+++ b/htdocs/FAQ.raw
@@ -48,6 +48,15 @@ our answers are unclear or not to the point.
     </UL>
   </LI>
   <LI>
+    <A HREF="#Documentation">Documentation</A>
+    <UL>
+      <LI>
+        <A HREF="#LaTeX-Error">I get a LaTeX error message when trying
+        to build the documentation from scratch. How can I fix it?</A>
+      </LI>
+    </UL>
+  </LI>
+  <LI>
     <A HREF="#Performance">Performance</A>
     <UL>
       <LI>
@@ -274,6 +283,22 @@ The situation changes depending on what Prolog system X-Prolog is:
 </DL>
 
 
+<A NAME="Documentation">
+<H2>Documentation</H2>
+
+<P>
+<A NAME="LaTeX-Error">
+<B>Q:</B>
+<STRONG><FONT COLOR=red>I get a LaTeX error message when trying to build
+the documentation. How can I fix it?</FONT></STRONG>
+
+<BR>
+<B>A:</B>
+See the discussion near to the end of the distributed file
+<A HREF="http://www.cs.unipr.it/git/gitweb.cgi?p=ppl/ppl.git;a=blob;f=doc/README.doc;hb=HEAD"><CODE>doc/README.doc</CODE></A>,
+also reported <A HREF="Documentation/how_to_get_it#LaTeX-Error">here</A>.
+
+
 <A NAME="Performance">
 <H2>Performance</H2>