move Master/Tools to Build/tools

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

1 files changed, 83 insertions, 0 deletions

diff --git a/Build/tools/README b/Build/tools/README
new file mode 100644
index 00000000000..e950d928e6b
--- /dev/null
+++ b/Build/tools/README
@@ -0,0 +1,83 @@
+(public domain -- originally written in 2004 by Karl Berry.)
+
+The scripts here relate to building or verifying TeX Live itself.
+
+tlrebuild - master script to check package files (tpm-check),
+  update them (update-tpm), update the lists files generated from the
+  tpm's for the Unix installer (update-lists),
+  and make the ISO image (MakeImages.sh).
+
+tpm-by-size - reports packages by space consumed.
+
+tpm-ctan-check - check that TL is up to date wrt CTAN.
+
+update-auto - check for various sources external to TeX Live being
+  changed, such as config.guess, texinfo.tex, etc.
+
+update-lists - update texmf/lists/* files from all the tpm's.
+
+update-tpm - regenerate tpm files via tpm-factory.pl.
+
+htmltext - simplistic creation of plain text from HTML, used for the
+  top-level doc.
+
+mkdocindex - builds top-level doc.html file.
+
+--
+
+Instructions from Sebastian (5jun04) on updating packages from ctan to
+TeX Live; encapsulated in the ./ctan2tl script, but don't run it blindly.
+
+a) grab the package X to Build/cdbuild/raw as a zip archive: gets $X.zip
+
+b) unpack zip: makes $X
+
+c) run
+    ../ctan2tds.pl $X
+  which makes ../cooked/X
+
+d) cd ../cooked: check $X tree is OK
+
+e) ../place $X: copies this tree to main texmf-dist, updates/creates
+   TPM, updates/creates list file
+    (this includes running tpm-factory)
+
+f) p4 revert -a
+   p4 submit
+
+--
+The difference between Map and MixedMap, from te:
+
+    The purpose of MixedMap is to help people who have printers which render
+    the type1 versions of the fonts worse than (mode-tuned) versions of
+    type3 fonts. The entries from MixedMap are just) not added to
+    psfonts_pk.map. That's the only difference.
+
+--
+pdftex update:
+\cp -f Annou* NEWS README /home/karl/src/Master/texmf/doc/pdftex
+cd !$
+p4update Annou* NEWS README
+
+cd manual
+\cp -f * /home/karl/src/Master/texmf/doc/pdftex/manual
+cd !$
+make
+p4update *
+
+# texmf is copies of various .ini's, ignore.
+
+
+on new architecture, or version change, must edit:
+Master/utils.sh: platform_guess() Sys variable setting.
+Master/common.sh:
+  setvars - name
+  menu_this_platform - list
+  screen_5 - text, must match
+Master/Tools/Tpm.pm: system list
+
+
+
+new year:
+- MakeImages.sh
+- texmf.cnf