diff options
Diffstat (limited to 'Master/tlpkg/doc/releng.txt')
| -rw-r--r-- | Master/tlpkg/doc/releng.txt | 188 |
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. |