From db245e1d4f6365e948c79cefeb7cab2870bb7957 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 2 Mar 2018 00:23:24 +0000 Subject: frozen => 1 for end of TL17 updates git-svn-id: svn://tug.org/texlive/trunk@46779 c570f23f-e606-0410-a88d-b1316a301751 --- Master/tlpkg/doc/releng.txt | 107 ++++++++++++++++++++++++-------------------- 1 file changed, 58 insertions(+), 49 deletions(-) (limited to 'Master/tlpkg/doc/releng.txt') 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 -- cgit v1.2.3