Module: ppl/w3ppl Branch: master Commit: a9116a2df725e8736dcea833088207ee50f874f0 URL: http://www.cs.unipr.it/git/gitweb.cgi?p=ppl/w3ppl.git;a=commit;h=a9116a2df72... Author: Enea Zaffanella <zaffanella@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>