more on what to do after building

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

1 files changed, 22 insertions, 18 deletions

diff --git a/Build/source/README b/Build/source/README
index ecd94b62e7c..e2f10b8aa15 100644
--- a/Build/source/README
+++ b/Build/source/README
@@ -1,33 +1,40 @@
 $Id$
-Copyright 2004, 2006, 2007 TeX Users Group.
+Copyright 2004, 2006, 2007, 2008 TeX Users Group.
 You may freely use, modify and/or distribute this file.
-(Originally written in 2004 by Karl Berry.)
 
 To build the source tree, run ./Build.
-To build (mostly) without optimization, try CFLAGS=-g Build.
+To build (mostly) without optimization, run ./Build --debug.
 
+Prerequisites:
 - Bison and Flex are needed for web2c.
 - libfontconfig (development) must be present for XeTeX to build, except
   on MacOSX.
-- A terminal (development) library such as libncurses must be present for
-  Texinfo to build.
+- A terminal library such as ncurses must be present (both headers
+  and library) for Texinfo to build.
 
 The binaries will be left in ./inst/bin/<stdplatform>.
-Don't worry about the other files and directories in inst.
+Ignore the other files and directories in ./inst.
 
 The new binaries are not directly usable from that location.  Instead,
-you have to copy them to texmf/bin/<tlplatform> (in the repository,
-that's under the Master tree).
-
-If your C++ needs to find the standard library in, say, /usr/local/lib,
-(i.e., configure fails saying the compiler doesn't work), try:
-env LD_OPTIONS=-R/usr/local/lib Build
+copy them to Master/bin/<tlplatformname>/.
 
 That should be it for normal builds.  Email tex-live@tug.org if problems.
 
+To make a usable TeX installation, you have to have (thousands of)
+support files as well as the binaries that are built here.  The support
+files are maintained completely independently.  The best basis for
+dealing with them is the TeX Live (plain text) database,
+Master/tlpkg/texlive.tlpdb, and/or our installer.  More information is
+under Master/tlpkg.  See also http://tug.org/texlive/distro.html.
 
-Running ./reautoconf here reruns autoconf, both old (the hacked 2.13
-we have here) and new (assumed to be in /usr/bin/autoconf), as needed.
+P.S. If your C++ needs to find the standard library in, say, /usr/local/lib,
+(i.e., configure fails saying the compiler doesn't work), try:
+env LD_OPTIONS=-R/usr/local/lib ./Build
+
+
+More details and random notes:
+
+Running ./reautoconf here reruns autoconf as needed.  Use --help for more.
 
 Automadness:
 should be oldest > newest in this order (often used alternate names
@@ -41,6 +48,7 @@ To rerun dvipdfmx:
   aclocal; autoheader; automake; autoconf
   touch config.h.in; sleep 1; touch Makefile.in  # shouldn't be needed, but ...
 
+
 Build information:
   i386-darwin: i686-apple-darwin8.1.0 built by Gerben Wierda, from
     http://bloch.ling.yale.edu/i-packages/experimental/tex.ii2/tex.30.tar.bz2
@@ -97,10 +105,6 @@ GNU Make 3.79.1
   ftp://ftp.software.ibm.com/aix/freeSoftware/aixtoolbox/RPMS/ppc/fontconfig/
 
 
-xdvi 22.84.10 - ok 28nov06
-  http://xdvi.sourceforge.net/
-
-
 - TeX Live includes many programs, which depend on many libraries, notably
   the TeX file-searching library kpathsea.