frozen => 1 for end of TL17 updates

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

1 files changed, 58 insertions, 49 deletions

diff --git a/Master/tlpkg/doc/releng.txt b/Master/tlpkg/doc/releng.txt
index c3baf8b2bc6..087028a8969 100644
--- a/Master/tlpkg/doc/releng.txt
+++ b/Master/tlpkg/doc/releng.txt
@@ -4,39 +4,72 @@ Public domain.
 Notes on putting together the pretest and yearly release --karl.
 See ./packages.txt for info on regular updates, adding/removing platforms, etc.
 
-Coordinate schedule with:
+Coordinate/announce schedule with:
  maintainers of: engines, LaTeX, GUST font, asymptote, context, texworks
  other parts of collection: protext, ctan, mactex.
  general lists
 
+Check if pretest mirrors need renewing, talk to mirror admins if so:
+ http://tug.org/texlive/mirmon/
+ /home/httpd/html/texlive/mirmon/tlpretest-mirrors.txt
+
 To stop updating of certain packages before the general freeze:
  tlpkg/dev/tlnet-disabled-packages.txt
 
-On the day of the last tlnet update,
- Set frozen/1 in 00texlive.config.tlpsrc.
- Freeze should happen at that night's rebuild.
 
-Check if pretest mirrors need renewing, talk to mirror admins if so:
- http://tug.org/texlive/mirmon/
- /home/httpd/html/texlive/mirmon/tlpretest-mirrors.txt
+ I. Preparing, can be done before pretest starts.
 
-
-Then, the next day, start building tlpretest:
+1. doc: write updates for pretest.html, leave commented out until start.
+ - check NEWS/CHANGES/etc. files for all engines and major programs.
+ - diff new and old bindirs to see if there are interesting new programs:
+  \ls $lb >/tmp/now
+  \ls $ib >/tmp/new
+  comm -3 /tmp/now /tmp/new >/tmp/cm
+ - if new kpathsea file types (kpsewhich --help-formats), update kpathsea.texi.
+ - see also doc item below for more necessary updates after pretest starts.
 
-0. Reset frozen to 0 in 00texlive.config.tlpsrc.
+2. Ask tldistro for patches.
 
-1a. Preserve final tlnet of current release:
+2. No /dev suffix: Build/source/{version.ac,texk/{kpathsea,ptexenc}/version.ac
+
+3. Check/update copyright years: *.pm, tlmgr*, install-tl, tlpkg/installer
+
+4. Check for upstream releases: {libs,texk,utils}/README
+
+5. When finalizing sources (any time in the new year, can be early,
+    before initial builds in any case),
+   update version numbers, years, and copyright years in:
+  top level version.ac
+  dvipdfm-x:configure.ac dvipdfmx.c xbb.c
+  dvips:    configure.ac NEWS dvips.c dvips.h afm2tfm.c dvips.texi
+  kpathsea: version.ac NEWS kpsewhich.c doc/kpathsea.texi texmf.cnf
+  ptexenc:  version.ac
+  web2c:    NEWS doc/web2c.texi ptexdir/ptex-base.ch,ptex_version.h
+            pdftexdir/pdftex.web pdftexdir/pdftex_version.h
+  then reautoconf (~5min), rebuild (~10min).
+  install-tl, tlmgr.pl (copyright only)
+  check *.c *.h sources in above for needed copyright year updates too.
+  run ~karl/bin/tlversions to see+compare engine/etc. versions
+  commit updates.
+
+
+ II. Building pretest instead of regular release.
+
+0. On the day of the last tlnet update,
+ Set frozen/1 in TLConfig.pm.
+ Freeze should happen at that night's rebuild.
+
+1. Then, the next day, start building tlpretest:
+  Reset frozen to 0 in TLConfig.pm.`;
+
+1a. And preserve final tlnet of current release:
 cd /home/ftp/texlive/tlnet
 cp -ar ../tlnet /home/ftp/historic/systems/texlive/YYYY/tlnet-final
 
 1b. Set up tlpretest:
-Better to empty tlpretest, touch texlive.tlpdb; then --recreate should suffice.
 Update /home/ftp/texlive/tlpretest/README.
-Update pretest.html, notably including major changes this year.
-diff new and old bindirs to see if there are interesting new programs:
-  \ls $lb >/tmp/now
-  \ls $ib >/tmp/new
-  comm -3 /tmp/now /tmp/new >/tmp/cm
+Empty tlpretest otherwise and then touch texlive.tlpdb;
+then --recreate in cron.tl should suffice.
 
 2. Then switch to pretest in cron.tl:
 critical=--critical	 # push tlcritical
@@ -49,11 +82,7 @@ First build happens below.
 3. option adjustrepo 0 in tl-update-tlnet, since pretest shouldn't go
 to CTAN for updates.
 
-4a. When starting trial builds (or earlier):
-Build/source/{version.ac,texk/{kpathsea,ptexenc}/version.ac: no /dev
-Also good to do other version/year updates as below.
-
-4b. When starting pretest, basic updates for release year:
+4. After setting up for pretest (not before), basic updates for release year:
 Master/.mkisofsrc
 Master/release-texlive.txt
 Master/tlpkg/TeXLive/TLConfig.pm (including MinRelease)
@@ -62,9 +91,8 @@ Master/tlpkg/bin/tl-update-images
 Master/tlpkg/installer/texlive.png (tlpkg/doc/texlive-installer-graphic.xcf)
 Master/texmf-dist/web2c/texmfcnf.lua
 Master/texmf-dist/web2c/texmf.cnf  # from Build/.../kpathsea
-(check/update copyright years in *.pm, tlmgr*, install-tl, tlpkg/installer)
 
-5. Ensure version numbers in sources are updated; see list below.
+5. Ensure version numbers in sources are updated; see list above.
 Then commit new binaries with tl-update-bindir.
 
 6. After committing, run tex \\end to check that mktexfmt works. 
@@ -76,7 +104,7 @@ problems.  Then, so things will get redone later as another check:
 (and might have to merge back if Master was mistakenly updated):
   diff -ru0 --exclude=man --exclude=info \
     Build/source/inst/texmf-dist Master/texmf-dist
-for p in *conv hbf2gf; do cp /home/ftp/mirror/rsync.tex.ac.uk/CTAN/language/chinese/CJK/cjk-4.8.4/doc/pdf/$p.pdf $p; done
+for p in *conv hbf2gf; do cp /home/ftp/tex-archive/language/chinese/CJK/cjk-4.8.4/doc/pdf/$p.pdf $p; done
 
 8. Now, try a first update of tlpretest:
   force_rebuild=true cron.tl
@@ -100,7 +128,7 @@ A. After tlnet freeze:
     http://tug.org/texcollection/
     http://puszcza.gnu.org.ua/projects/texcollection/
 
-A.0. Specifics for tlperl update:
+B. Specifics for tlperl update:
   cd $pg
   find tlperl -type f | \grep -v README.TEXLIVE | sort >/tmp/now
   tar tf newperl.tgz | \grep -v /\$ | sort >/tmp/new
@@ -116,7 +144,7 @@ A.0. Specifics for tlperl update:
   update tlperl/README.TEXLIVE
   svn commit when ready ...
 
-B. Build a test ISO image for initial TeX Collection testing:
+C. Build a test ISO image for initial TeX Collection testing:
   In cron.tl, set images_frozen=false.
   In tl-update-images, ensure V= the new YYYY and target=/.../test
   Update /home/ftp/texlive/Images/test/README.
@@ -129,7 +157,7 @@ M. As work proceeds, update the doc:
   Ensure all engine manuals updated in texmf-dist.
   Update texlive-en.tex (+ .pdf, .html), tell tldoc to translate.
     Don't neglect to update "Builders of the binaries".
-  Update tlbuild.texi.
+  Update tlbuild.texi, including make tlbuild-incl.texi.
   Consider updates of core man pages in Build/source/texk/web2c/man.
   Remake updmap,fmtutil man pages with help2man:
     make -C Build/source/Work/texk/texlive/tl_scripts xupdmap.1 xfmtutil.1
@@ -143,7 +171,7 @@ M. As work proceeds, update the doc:
     # and check /tmp/so.rules against man1/Makefile
   Update texdoc Data.tlpdb.lua.
 
-N. Really test during pretest (really! don't leave it for knuth!):
+N. Really test during pretest (really! don't leave it for Knuth to do!):
   .fmt's sharable across endian-different platforms (including luatex).
   interactive mf '\drawdot (50,50); showit;'  % and from * prompt
 
@@ -163,27 +191,8 @@ Q. After final build, to do total freeze:
   In cron.tl, set *_frozen=true.
   Probably also just disable the cron entry.
 
-
-When finalizing sources (any time in the new year, can be early, before
-initial builds in any case):
-- update version numbers, years, and copyright years in:
-  top level version.ac
-  dvipdfm-x:configure.ac dvipdfmx.c xbb.c
-  dvips:    configure.ac NEWS dvips.c dvips.h afm2tfm.c dvips.texi
-  kpathsea: version.ac NEWS kpsewhich.c doc/kpathsea.texi texmf.cnf
-  ptexenc:  version.ac
-  web2c:    NEWS doc/web2c.texi ptexdir/ptex-base.ch,ptex_version.h
-            pdftexdir/pdftex.web pdftexdir/pdftex_version.h
-  texk/*/version.ac, libs/*/version.ac, utils/*/version.ac
-  then reautoconf (6min), rebuild.
-  install-tl, tlmgr.pl (copyright only)
-  check *.c *.h sources in above for needed copyright year updates too.
-  run ~karl/bin/tlversions to see+compare engine/etc. versions
-- if new kpathsea file types (kpsewhich --help-formats), update kpathsea.texi.
-- ask tldistro for patches.
 
-
-Making the big release:
+ III. Making the big release:
 
 - unmount live install of last year's:
 umount /home/ftp/texlive/Contents/live