more on what to do after building

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

2 files changed, 30 insertions, 24 deletions

diff --git a/Build/README b/Build/README
index 29b259024e2..25d95d6dd4a 100644
--- a/Build/README
+++ b/Build/README
@@ -1,15 +1,15 @@
 $Id$
-Copyright (C) 2006, 2007 TeX Users Group.
+Copyright (C) 2006, 2007, 2008 TeX Users Group.
 You may freely use, modify and/or distribute this file.
-(Originally written in 2006 by Karl Berry.)
 
 This Build directory contains sources and tools which are used in
 building TeX Live, but are not part of the live hierarchy.  Each subdir
 has another README with more details.
 
-logs - complete logs of all commits to the TL source repositories.
+logs   - complete logs of all commits to the TL source repositories.
 source - the actual sources for all the executable programs.
-tools - scripts related to most everything else.
+tools  - scripts related to most everything else, that mostly will be
+         moved to Master/tlpkg/bin in the fullness of time.
 
 Directories named tmp.raw and tmp.cooked are also created/used/removed
 here by ctan2tl, ctan2tds, and place.
@@ -17,7 +17,9 @@ here by ctan2tl, ctan2tds, and place.
 If you know enough about TeX to be reading this, then you (or your
 institution) should consider joining a TeX user group (there's a list at
 http://tug.org/usergroups.html) -- if you're already a member, thanks
-for your support!  The TeX Users Group, the oldest such group, produces
-the periodicals TUGboat (http://tug.org/TUGboat), The PracTeX Journal
+for your support!
+
+The TeX Users Group, the oldest such group, produces the periodicals
+TUGboat (http://tug.org/TUGboat), The PracTeX Journal
 (http://tug.org/pracjourn), sponsors an annual meeting and publishes the
 proceedings ... and hosts TeX Live development and distribution.
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.