From: Julian Seward <jseward@acm.org>
Date: Mon, 25 Jul 2005 17:54:06 +0000 (+0000)
Subject: Record my adventures in 'make print-docs' land.
X-Git-Tag: svn/VALGRIND_3_0_0~65
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=aafc278acd41bb69dac6a95f403fcde48da7b708;p=thirdparty%2Fvalgrind.git

Record my adventures in 'make print-docs' land.


git-svn-id: svn://svn.valgrind.org/valgrind/trunk@4253
---

diff --git a/docs/README b/docs/README
index 57cafd3c02..5bd22c5b7e 100644
--- a/docs/README
+++ b/docs/README
@@ -17,6 +17,29 @@ Tool specific XML docs:
 All images used in the docs:
   valgrind/docs/images/
 
+New notes, JRS 20050727
+~~~~~~~~~~~~~~~~~~~~~~~
+* I had to install zillions of packages on SuSE 9.2 in order to
+  build the print docs (make print-docs), including
+
+    passivetex
+    xpdf (for pdftops)
+
+  It's possible to use pdf2ps instead, but that seems to generate
+  huge and almost-unreadable .ps.  pdftops does a much nicer job.
+
+
+* Even then, pdfxmltex eventually dies with "TeX capacity exceeded,
+  sorry [pool size = 67555]" or some such.  To fix this, I edited
+  /etc/texmf/texmf.cnf and changed
+
+     pool_size.pdfxmltex = 500000
+
+  to 1500000 and that fixed it.
+
+
+Old notes
+~~~~~~~~~
 Stylesheets, catalogs, parsing/formatting scripts:
   valgrind/docs/lib/
 
@@ -56,9 +79,9 @@ overview:
   automake target, but does nothing.)  Likewise for PDF/PS with 'make
   print-docs'.
 
-- 'make dist' puts the XML files into the tarball.  It also builds the
-  HTML docs and puts them in too, in valgrind/docs/html/ (including
-  style sheets, images, etc).
+- 'make dist' (nb: at the top level, not in docs/) puts the XML files
+  into the tarball.  It also builds the HTML docs and puts them in too, 
+  in valgrind/docs/html/ (including style sheets, images, etc).
 
 - 'make install' installs the HTML docs in
   $(install)/share/doc/valgrind/html/, if they are present.  (They will