clisp build process, other build docs

git-svn-id: svn://tug.org/texlive/trunk@29540 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 62 insertions, 61 deletions

diff --git a/Build/source/README b/Build/source/README
index 9caeb754d36..825cffc34ea 100644
--- a/Build/source/README
+++ b/Build/source/README
@@ -12,13 +12,14 @@ To make without configuring, run TL_CONFIGURE=true ./Build.
 environment variables; just take a look to see all the names.)
 
 Prerequisites:
+- C and C++ compilers.
+
 - GNU make.  If your GNU make is invoked by some name other than `make',
-  try setting the envvar TL_MAKE to what is needed.
+  try: env TL_MAKE=/your/gnu/make ./Build
 
 - GNU clisp and GNU libffcall, for xindy.  See more
   details in utils/README.  (Alternative: Build --disable-xindy.)
-
-  Perl, latex, and pdflatex to build the rules and/or documentation.
+  Also perl, latex, and pdflatex to build the rules and/or documentation.
 
 - Perl to autodetect the TeX Live platform name for biber.
 
@@ -27,8 +28,8 @@ Prerequisites:
   (Alternative: Build --without-x.)
 
 - libfontconfig (again both headers and library), for XeTeX and xdvipdfmx,
-  except on MacOSX.  (Alternative:
-  Build --disable-xetex --disable-xdvipdfmx.)
+  except on MacOSX.  (Alternative: Build --disable-xetex --disable-xdvipdfmx.)
+  While on MacOSX, an Objective C compiler is needed.
 
 - If you modify any .y or .l source files, then Bison and Flex (or maybe
   equivalents) are needed.  The distributed .c and .h files are generated
@@ -58,61 +59,61 @@ programs or libraries, recompiling after fixing problems, etc., are in
 the other README.* files here.
 
 
-Build information:
-  In general, xe(la)tex and xdvipdfmx depend on fontconfig.
-  We cannot statically link it because it varies by os version.
+Build information for some of the platforms.
 
-  i386-linux: Debian sarge, gcc 3.3.5, libc 2.3.2, Linux 2.6.9-67.0.4.ELsmp
-    chroot /home/texlive/sarge; Build --with-xindy --with-clisp=...
-  
-  x86_64-linux: gcc 4.5, libc 2.3.6, Linux 2.6.28.6
+i386-linux: gcc 4.6.3, Linux 2.6.18-* (CentOS 5)
+  ~karl/bin/mybuild
+        
+x86_64-linux: gcc 4.5, libc 2.3.6, Linux 2.6.28.6
   
-  universal-darwin, x86_64-darwin: a menagerie of versions.
-    See Master/source/mactexdoc.tar.xz.
-
-  i386-solaris, x86_64-solaris: Solaris 11.
-
-  powerpc-linux (Debian Squeeze)
-Linux homer 2.6.32-5-powerpc64 #1 SMP Tue Mar 8 02:01:42 UTC 2011
-ppc64 Debian GNU/Linux 6.0
-(only the kernel is 64bit, the entire userland is 32bit.)
-
-  sparc-solaris
-OS: Sun Solaris 8
-compiler: Sun Studio 11
-bison (GNU Bison) 2.3
-flex version 2.5.4
-GNU m4 1.4.5
-GNU Make 3.81
-  Because Solaris 8 does not include fontconfig, we used fontconfig
-  package (version 2.3.2) from http://www.blastwave.org/
-  (together with its dependencies)
-
-  powerpc-aix
-OS: AIX 4.3
-compiler: IBM C for AIX Compiler, Version 5 (xlc)
-bison (GNU Bison) 1.34
-flex version 2.5.4
-GNU m4 1.4
-GNU Make 3.79.1
-  You can download fontconfig for AIX from
-  http://www-03.ibm.com/servers/aix/products/aixos/linux/download.html
-  ftp://ftp.software.ibm.com/aix/freeSoftware/aixtoolbox/RPMS/ppc/fontconfig/
-
-  alpha-linux
-OS: Debian GNU/Linux 4.0 (Etch), kernel 2.6.18
-gcc (GCCC) 4.1.2 20061115 (prerelease) (Debian 4.1.1-21)
-bison (GNU Bison) 2.3
-flex 2.5.33
-GNU M4 1.4.8
-GNU Make 3.81
-  - you have to set the ulimit high enough before compiling clisp and texlive
-      ulimit -s 16384
-    did suffice for me
-  - compiling of texk/web2c/pdftexdir/writezip.c is broken and triggers a 
-    compiler error with the above gcc. This is a known optimization error
-    of gcc on alphas. The solution is to set
-      LDFLAGS=-Wl,--no-relax
-    before running Build.
-  - compilation of clisp needs --disable-mmap
-  - asy compilation with --disable-gsl && make
+universal-darwin, x86_64-darwin: a menagerie of versions.
+  See Master/source/mactexdoc.tar.xz.
+
+i386-solaris, x86_64-solaris: Solaris 11.
+
+i386-cygwin: gcc-4.5.3.
+
+powerpc-linux (Debian Squeeze)
+  Linux homer 2.6.32-5-powerpc64 #1 SMP Tue Mar 8 02:01:42 UTC 2011
+  ppc64 Debian GNU/Linux 6.0
+  (only the kernel is 64bit, the entire userland is 32bit.)
+
+sparc-solaris
+  OS: Sun Solaris 8
+  compiler: Sun Studio 11
+  bison (GNU Bison) 2.3
+  flex version 2.5.4
+  GNU m4 1.4.5
+  GNU Make 3.81
+    Because Solaris 8 does not include fontconfig, we used fontconfig
+    package (version 2.3.2) from http://www.blastwave.org/
+    (together with its dependencies)
+
+powerpc-aix
+  OS: AIX 4.3
+  compiler: IBM C for AIX Compiler, Version 5 (xlc)
+  bison (GNU Bison) 1.34
+  flex version 2.5.4
+  GNU m4 1.4
+  GNU Make 3.79.1
+    You can download fontconfig for AIX from
+    http://www-03.ibm.com/servers/aix/products/aixos/linux/download.html
+    ftp://ftp.software.ibm.com/aix/freeSoftware/aixtoolbox/RPMS/ppc/fontconfig/
+
+alpha-linux
+  OS: Debian GNU/Linux 4.0 (Etch), kernel 2.6.18
+  gcc (GCCC) 4.1.2 20061115 (prerelease) (Debian 4.1.1-21)
+  bison (GNU Bison) 2.3
+  flex 2.5.33
+  GNU M4 1.4.8
+  GNU Make 3.81
+    - you have to set the ulimit high enough before compiling clisp and texlive
+        ulimit -s 16384
+      did suffice for me
+    - compiling of texk/web2c/pdftexdir/writezip.c is broken and triggers a 
+      compiler error with the above gcc. This is a known optimization error
+      of gcc on alphas. The solution is to set
+        LDFLAGS=-Wl,--no-relax
+      before running Build.
+    - compilation of clisp needs --disable-mmap
+    - asy compilation with --disable-gsl && make