release doc/final tweaks

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

2 files changed, 158 insertions, 178 deletions

diff --git a/Master/tlpkg/doc/packages.txt b/Master/tlpkg/doc/packages.txt
index 6a665e65ad3..324d8093980 100644
--- a/Master/tlpkg/doc/packages.txt
+++ b/Master/tlpkg/doc/packages.txt
@@ -4,6 +4,8 @@ Public domain.
 See http://tug.org/texlive/pkgupdate.html (and scripts) for information
 on the CTAN-to-TL update process.
 
+See ./releng.txt for info about setting up the pretest and doing a release.
+
 To add a new platform:
 - check that the config.guess output maps to our architecture name
   in the `platform' routine in TeXLive/TLUtils.pm.
@@ -19,148 +21,20 @@ To remove a platform:
 - remove any special cases in Master/tlpkg/tlpsrc.
 - rebuild.
 
+
 To remake tlcritical from scratch:
  cd /home/ftp/texlive
  rm -rf tlcritical
  mkdir tlcritical
  tl-update-tlcritical --recreate
  
-
-Coordinate schedule with:
- engine people, LaTeX people, GUST font people
- general lists
-
-To stop updating of certain packages before the general freeze:
- tlpkg/dev/tlnet-disabled-packages.txt
-
-Really test during pretest (really!):
-  .fmt's sharable across endian-different platforms (including luatex).
-  interactive mf '\drawdot (50,50); showit;'
-
-When finalizing sources (can be before tlnet freeze)
-  version numbers and years and copyright years in:
-  top level version.ac
-  dvips:    configure.ac NEWS dvips.c dvips.h afm2tfm.c dvips.texi
-  kpathsea: version.ac NEWS kpsewhich.c doc/kpathsea.texi
-  web2c:    NEWS doc/web2c.texi
-  ptexenc:  version.ac
-  texmf.cnf (both Build and Master), texmfcnf.lua (Master)
-  install-tl, tlmgr.pl (copyright only)
-  run ~karl/bin/tlversions to see+compare engine/etc. versions
-
-tlnet freeze:
-  opt_frozen=1 in 00texlive.installation.tlpsrc on last day of updates.
-  on first day of freeze, pretest=--pretest and critical=--critical in cron.tl.
-  cp -ar tlnet /home/ftp/historic/systems/texlive/YYYY/tlnet-final
-  Either:
-    mkdir /home/ftp/texlive/tlpretest/tlpkg
-    cp Master/tlpkg/texlive.tlpdb !$  # no texlive.installer?
-    tl-update-tlnet will make everything else.
-  But better?
-    cd /home/ftp/texlive/tlnet
-    \cp -ar [a-u]* ../tlpretest/  # omit README (update that)
-  Update pretest.html.
-  
-After tlnet freeze:
-  fix release-texlive.txt .mkisofsrc tl-update-tlnet TLConfig.pm
-  in Master/tlpkg, update bundled Windows programs as needed:
-    dviout texworks tlgs tlperl tlpsv
-
-When binary set and docs are stable enough:
-  Ask ConTeXt people to update.
-  Compare Build/source/inst/texmf to texmf.
-  tl-update-txi
-  tl-update-man # and run make in texmf/doc/man
-
-When total freeze:
-  peb + laurens + khaled: no commits
-  after: copy bugs.html to historic/YYYY-1/bugs.html, rm tugstyle.css ref
-
-
-Making the big release:
-
-- Live unmount:
-umount /home/ftp/texlive/Contents/live
-
-hx=/home/ftp/historic/systems/texlive
-prev=2010
-this=2011
-mkdir $hx/$this
-
-cd /home/ftp/texlive/Images
-cp README.html $hx/$prev/
-mv *.iso* $hx/$prev/
-mv test/*.iso* .
-mv test/texlive*.tar.xz* $hx/$this/  # tar version only from historic
-update README and test/README
-rm texlivetest.iso
-
-cd /home/ftp/texlive/tlnet
-mkdir $hx/$prev/tlnet
-cd /home/ftp/texlive/tlnet
-cp README $hx/$prev/tlnet/
-mv [a-z]* $hx/$prev/tlnet/
-mv ../tlpretest/[a-z]* .
-mv mactex*   # deal with mactex below
-update README and ../tlpretest/README
-
-cd /home/httpd/html/texlive
-mkdir $hx/$prev/web
-cp *.html !$
-
-
-- tug.org stuff:
-do full install to default location.
-rm /usr/local/texlive-rel; ln -s texlive/$this /usr/local/texlive-rel
-create source/ subdir, cp texlive-*-source.tar.xz and w32tex-src.tar.xz
-change /etc/fstab, mount /home/ftp/texlive/Contents/live.
-update ~www/texlive web pages (search for $prev):
-  acquire* - general
-  bugs.html - general
-  doc.html - platform list, translation list
-  quickinstall.html - paths
-  w32client.html - new .zip needed
-update historic/systems with final proTeXt and MacTeX, when ready.
-update TUG member area with CTAN snapshot, when ready.
-update TUG home page.
-
-- announcements:
-Dick Koch @ updating MacTeX.
-CTAN @ re-enabling tlnet mirroring.
-Manfred @ making TeX Collection DVD.
-Martin @ torrents.
-pretest mirror admins @ done till next year (~www/texlive/mirmon/tl*.txt).
-
-- make tag + branch:
-svn copy -r 23181 -m'texlive-2011.0 tag based on r23181' svn://tug.org/texlive/trunk svn://tug.org/texlive/tags/texlive-2011.0
-svn copy -r 23181 -m'branch2011 branch based on r23181' svn://tug.org/texlive/trunk svn://tug.org/texlive/branches/branch2011
-
-  It's the same command, just different destinations.
-  http://svnbook.red-bean.com/en/1.5/svn-book.html#svn.branchmerge
-
-  Do both a branch and a tag so that it's possible to easily compare the
-  current state of the branch with its starting point (the tag).
-
-  Then, to check out the branch, so critical source fixes can be applied
-  for the distros:
-cd /home/texlive
-rm -rf branch # if starting a new year on tug
-mkdir branch; cd branch
-svn co file:///home/svn/texlive/branches/branch2011/Build/source . >&out
-
-
-- update ~karl/bin/cron.tl, and reenable when feel ready.
-critical=
-pretest=
-all_frozen=false
-probably wait for net_frozen=false for a couple days
-
 
-
-Different naming convention to branch before a release, for development
-work before we want to switch trunk over:
-svn copy -r 12205 -m'texlive-2009-dev tag based on r12205' svn://tug.org/texlive/trunk svn://tug.org/texlive/tags/texlive-2009-dev
-svn copy -r 12205 -m'branch2009-dev branch based on r12205' svn://tug.org/texlive/trunk svn://tug.org/texlive/branches/branch2009-dev
+To branch before a release, in the unlikely event of separate
+  development work before we want to switch trunk over:
+svn copy -r 12205 -m'texlive-2009-dev tag based on r12205' \
+  svn://tug.org/texlive/trunk svn://tug.org/texlive/tags/texlive-2009-dev
+svn copy -r 12205 -m'branch2009-dev branch based on r12205' \
+  svn://tug.org/texlive/trunk svn://tug.org/texlive/branches/branch2009-dev 
 
-Use -dev instead of .something because - will sort first, keeping the
-listings in a nice chronological order.
+(Use -dev instead of .something because - will sort first, keeping the
+listings in a nice chronological order.)
diff --git a/Master/tlpkg/doc/releng.txt b/Master/tlpkg/doc/releng.txt
index 1b881dc01f9..cb8e10eed49 100644
--- a/Master/tlpkg/doc/releng.txt
+++ b/Master/tlpkg/doc/releng.txt
@@ -1,70 +1,176 @@
 $Id$
 Public domain.
 
-Just rough notes on putting together the yearly release --karl.
+Notes on putting together the pretest and yearly release --karl.
 
+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
 
-/home/httpd/html/texlive/mirmon/tlpretest-mirrors.txt 
+Coordinate schedule with:
+ engine people, LaTeX people, GUST font people
+ general lists
 
-# on the day of the last tlnet update,
-# set opt_frozen in 00texlive.installation.tlpsrc.
-# freeze should happen the next day.
+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 opt_frozen in 00texlive.installation.tlpsrc.
+ Freeze should happen the next day.
 
 
 then, the next day, build tlpretest.
 
 0. Reset opt_frozen to 0 in 00texlive.installation.tlpsrc.
 
-1. Set up tlpretest:
+1a. Set up tlpretest:
 cd /home/ftp/texlive/tlnet
 tar cf - [a-u]* | (cd ../tlpretest && tar xf -)
 # do not copy README.
+Update pretest.html, notably including major changes this year:
+diff new and old bindirs to see if there are interesting new programs.
+
+1b. Preserve final tlnet of current release:
+cp -ar tlnet /home/ftp/historic/systems/texlive/YYYY/tlnet-final
+
+2. Then switch to pretest in cron.tl:
+critical=--critical	# push tlcritical
+pretest=--pretest	# update tlpretest, not tlnet (if not frozen)
+net_frozen=false 	# update tlnet|tlpretest (per $pretest)
 
-2. Then make these changes in the cron script:
---- cron.tl	2011/05/25 22:49:19	1.171
-+++ cron.tl	2011/05/25 22:50:03
-@@ -16,7 +16,7 @@ trap "rm -f $lockfile; exit 0;" 0 1 2 15
- critical= #--critical	 # push tlcritical to tlnet
--pretest= #--pretest	 # update tlpretest, not tlnet (when frozen)
-+pretest=--pretest	 # update tlpretest, not tlnet (when frozen)
- recreate= #--recreate	 # recreate all packages in tlnet (do not do lightly)
- 
- all_frozen=false	 # master tree
--tlnet_frozen=false	 # tlnet/tlpretest
-+tlnet_frozen=true	 # tlnet/tlpretest
- : ${images_frozen=true}  # iso generation
+(tlcritical will remain getting updated daily, even though it doesn't
+ work with tlnet any more.  That's ok.)
 
 3. The next nightly build will update tlpretest, or run
 force_rebuild=true cron.tl
 
+4. Basic updates for release year:
+kpathsea/texmf.cnf & web2c/texmf.cnf
+Master/release-texlive.txt
+Master/tlpkg/TeXLive/TLConfig.pm
+Master/tlpkg/bin/tl-update-tlnet
+.mkisofsrc
 
-4. kpathsea/texmf.cnf & web2c/texmf.cnf,
-   Master/release-texlive.txt,
-   Master/tlpkg/TeXLive/TLConfig.pm - change $ReleaseYear.
-   .mkisofsrc
+5. When closer to release:
+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
+after successful image build, email tldistro@tug.org for info/review
 
+
+Really test during pretest (really!):
+  .fmt's sharable across endian-different platforms (including luatex).
+  interactive mf '\drawdot (50,50); showit;'
+
+When finalizing sources (can be before tlnet freeze)
+  version numbers and years and copyright years in:
+  top level version.ac
+  dvips:    configure.ac NEWS dvips.c dvips.h afm2tfm.c dvips.texi
+  kpathsea: version.ac NEWS kpsewhich.c doc/kpathsea.texi
+  web2c:    NEWS doc/web2c.texi
+  ptexenc:  version.ac
+  texmf.cnf (both Build and Master), texmfcnf.lua (Master)
+  install-tl, tlmgr.pl (copyright only)
+  run ~karl/bin/tlversions to see+compare engine/etc. versions
+
+After tlnet freeze:
+  in Master/tlpkg, update bundled Windows programs as needed:
+    dviout texworks tlgs tlperl tlpsv
+
+When binary set and docs are stable enough:
+  Ask ConTeXt people to update if not done.
+  peb + laurens + khaled: no commits.
+  Compare Build/source/inst/texmf to texmf.
+  tl-update-txi
+  tl-update-man # and run make in texmf/doc/man
+  # and check /tmp/so.rules against man1/Makefile
+
+When total freeze:
+  in cron.tl, set *_frozen=true.
+  probably also just disable the cron entry.
 
-tlcritical will remain getting updated daily, even though it doesn't
-work with tlnet any more.  c'est la vie.
+
+Making the big release:
 
+- Live unmount of last year's:
+umount /home/ftp/texlive/Contents/live
 
-when closer to time:
-  in cron.tl, images_frozen=false
-  in tl-update-images, ensure V= the new YYYY and target=/.../test
-  update /home/ftp/texlive/Images/test/README
-  after successful image build, email tldistro@tug.org for info/review
+hx=/home/ftp/historic/systems/texlive
+prev=2011
+this=2012
+mkdir $hx/$this
 
-
-run tl-update-txi
-and tl-update-man (and check /tmp/so.rules against man1/Makefile)
+cd /home/ftp/texlive/Images
+cp README.html $hx/$prev/
+mv *.iso* $hx/$prev/
+mv test/*.iso* .
+mv test/texlive*.tar.xz* $hx/$this/  # tar version only from historic
+update README and test/README
 
-
-w32clientYYYY.zip on web pages.
-
- after release
+cd /home/ftp/texlive/tlnet
+mkdir $hx/$prev/tlnet
+cd /home/ftp/texlive/tlnet
+diff -qr . $hx/$prev/tlnet-final # should already be there from before, so:
+rm -rf [a-z]*
+mv ../tlpretest/[a-z]* .
+update README and ../tlpretest/README
+
+cd /home/httpd/html/texlive
+mkdir $hx/$prev/web
+cp *.html !$  # remove tugstyle.css ref from bugs.html
+
+
+- tug.org stuff:
+do full install to default location.
+rm /usr/local/texlive-rel; ln -s texlive/$this /usr/local/texlive-rel
+create source/ subdir, cp texlive-*-source.tar.xz and w32tex-src.tar.xz
+change /etc/fstab, mount /home/ftp/texlive/Contents/live.
+update ~www/texlive web pages (search for $prev):
+  acquire* - general
+  bugs.html - general
+  doc.html - platform list, translation list
+  quickinstall.html - paths
+  w32client.html - new w32client*.zip needed (siep)
+update historic/systems with final proTeXt and MacTeX, when ready.
+  https://bscw.fernuni-hagen.de
+  ftp://ftp.fernuni-hagen.de/pub/windows/win32/ProTeXt/
+update TUG member area with CTAN snapshot, when ready.
+
+- announcements:
+Dick Koch @ updating MacTeX.
+CTAN @ re-enabling tlnet mirroring.
+Martin @ torrents.
+Nikola @ FreeBSD binaries.
+pretest mirror admins @ done till next year (~www/texlive/mirmon/tl*.txt).
+
+- make tag + branch:
+svn copy -r 26940 -m'texlive-2012.0 tag based on r26940' \
+  svn://tug.org/texlive/trunk svn://tug.org/texlive/tags/texlive-2012.0
+svn copy -r 26940 -m'branch2012 branch based on r26940' \
+  svn://tug.org/texlive/trunk svn://tug.org/texlive/branches/branch2012
+
+  It's the same command, just different destinations.
+  http://svnbook.red-bean.com/en/1.5/svn-book.html#svn.branchmerge
+
+  Do both a branch and a tag so that it's possible to easily compare the
+  current state of the branch with its starting point (the tag).
+
+  To check out the branch, for critical source fixes for the sake of
+  during-the-year rebuilds or for the distros, if they request it:
+cd /home/texlive
+rm -rf branch # when starting a new year on tug
+mkdir branch; cd branch
+svn co file:///home/svn/texlive/branches/branch2012/Build/source . >&out
+
+
+- update ~karl/bin/cron.tl, and reenable when feel ready.
+critical=
+pretest=
+net_frozen=false
+all_frozen=false
+
+
+ publicity after release:
 texcollection/index.html
 store/index.html
-
-texlive/*.html - search for 2010
-new bugs.html (save all *.html in historic)
-tlmgr.html NEWS
+update TUG home page.