doc updates, including wl 11 Oct 2006 07:08:30

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

4 files changed, 54 insertions, 49 deletions

diff --git a/Build/README b/Build/README
index 8471dde67bd..29b259024e2 100644
--- a/Build/README
+++ b/Build/README
@@ -3,14 +3,21 @@ Copyright (C) 2006, 2007 TeX Users Group.
 You may freely use, modify and/or distribute this file.
 (Originally written in 2006 by Karl Berry.)
 
-The Build directory contains sources and tools which are used in
+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.
-tools - scripts related to most everything else.
 source - the actual sources for all the executable programs.
+tools - scripts related to most everything else.
 
-Directories named tmp.raw and tmp.cooked are also created/used here by
-ctan2tl, ctan2tds, and place.
+Directories named tmp.raw and tmp.cooked are also created/used/removed
+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
+(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 2240fd29d8f..ecd94b62e7c 100644
--- a/Build/source/README
+++ b/Build/source/README
@@ -27,7 +27,7 @@ That should be it for normal builds.  Email tex-live@tug.org if problems.
 
 
 Running ./reautoconf here reruns autoconf, both old (the hacked 2.13
-we have here) and new (assumed to be in /usr/bin/autoconf).
+we have here) and new (assumed to be in /usr/bin/autoconf), as needed.
 
 Automadness:
 should be oldest > newest in this order (often used alternate names
diff --git a/Build/source/texk/README b/Build/source/texk/README
index 0ae830b7af1..39ef160ff0b 100644
--- a/Build/source/texk/README
+++ b/Build/source/texk/README
@@ -1,44 +1,32 @@
-This directory contains TeX-related programs that use the kpathsea
-library for configuration and path searching (and the library itself).
-
-For the simplest possible installation, see the beginning of
-kpathsea/INSTALL.
-
-If you want to override the defaults, read both <program>/INSTALL (e.g.,
-web2c/INSTALL) and kpathsea/INSTALL.
-
-Other files are not necessary reading for basic installation, but may
-prove helpful:
-- etc/unixtex.ftp describes how to obtain a TeX system by ftp or on
-  physical media, and some alternative TeX distributions.
-- README in each subdirectory briefly summarizes that directory.
-- NEWS in each subdirectory has noteworthy changes by release.
-- kpathsea/BUGS has bug reporting information.
-- kpathsea/CONFIGURE has generic instructions on running configure scripts.
-
-Please send bug reports and suggestions for either the programs or the
-documentation, no matter how small, to tex-k@mail.tug.org.  But please
-read kpathsea/BUGS first.  (That file also tells you how to join the
-mailing list yourself, and how to receive announcements only.)
-
-For general documentation on the coding and usage standards this
-distribution follows, see the GNU standards document
-http://www.gnu.org/prep/standards, especially the `Makefile
-Conventions', `Configuration', and `User Interfaces' sections.
-
-The files in the etc/ directory are present for informational purposes.
-They are not used or installed by the programs.  For example, a copy of
-texinfo.tex is there in case you want to produce DVI files from the
-Texinfo manuals.
-
-If you know enough about TeX to be reading this, then you (or your
-institution) should consider joining the TeX Users Group
-(http://tug.org)) -- if you're already a member, thanks for your
-support!  TUG produces the periodicals TUGboat (http://tug.org/TUGboat),
-The PracTeX Journal (http://tug.org/pracjourn), sponsors an annual
-meeting and publishes the proceedings, and more.
-
-This is free software.  See the files COPYING* for copying permissions.
-
-Karl Berry
-Olaf Weber
+$Id$
+Copyright 2006, 2007 TeX Users Group.
+(Originally written in 2006 by Karl Berry.)
+You may freely use, modify and/or distribute this file.
+
+This TeX Live directory contains the programs that use the kpathsea
+library for configuration and path searching, and the library itself.
+
+Some programs can be built on their own, but others, including kpathsea
+itself, cannot.  Instead, try configure --enable-tetex-build in .., or
+using the Build script there.  In general, for TeX Live we only test
+configuring the whole tree.
+
+Upstream sources for the programs as last checked:
+
+afm2pl 0.7.03 - ok 5dec06
+  http://tex.aanhet.net/afm2pl/
+
+devnag - from devnag package installed in texmf-dist.
+
+dvipdfmx 20061211 - ok 14dec06
+  http://project.ktug.or.kr/dvipdfmx/snapshot/current/
+  -> http://www.ctan.org/tex-archive/dviware/dvipdfmx/
+
+dvipng 1.9 - ok 5dec06
+  http://www.ctan.org/tex-archive/dviware/dvipng/
+
+dvi2tty 5.3.1 - needs update 18may07
+  http://www.mesa.nl/pub/dvi2tty/
+
+xdvik 22.84.10 - ok 4dec06
+  http://xdvi.sourceforge.net/
diff --git a/Build/source/texk/README.TL b/Build/source/texk/README.TL
index 334af438212..640c51f981c 100644
--- a/Build/source/texk/README.TL
+++ b/Build/source/texk/README.TL
@@ -1,6 +1,16 @@
 Copyright 2006, 2007 Karl Berry.
 You may freely use, modify and/or distribute this file.
 
+This TeX Live directory contains the programs that use the kpathsea
+library for configuration and path searching, and the library itself.
+
+Some programs can be built on their own, but others, including kpathsea
+itself, cannot.  Instead, try configure --enable-tetex-build at the top
+level.  In general, for TeX Live we only ever test configuring the whole
+tree.
+
+Upstream sources for the programs here:
+
 afm2pl 0.7.03 - ok 5dec06
   http://tex.aanhet.net/afm2pl/