summaryrefslogtreecommitdiff
path: root/Master/tlpkg/doc/releng.txt
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-07-23 22:05:17 +0000
committerKarl Berry <karl@freefriends.org>2012-07-23 22:05:17 +0000
commit1bffdb6270a480f703a7978b526a423b26998a5e (patch)
tree266201f7c96c5d730f54f1c516bbfb84125d7ade /Master/tlpkg/doc/releng.txt
parent4a4697b0ffba8bffa9c86b07e6a6f6ce3067a489 (diff)
release doc/final tweaks
git-svn-id: svn://tug.org/texlive/trunk@27122 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/tlpkg/doc/releng.txt')
-rw-r--r--Master/tlpkg/doc/releng.txt188
1 files changed, 147 insertions, 41 deletions
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.