summaryrefslogtreecommitdiff
path: root/Master/tlpkg/doc/releng.txt
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-03-02 00:23:24 +0000
committerKarl Berry <karl@freefriends.org>2018-03-02 00:23:24 +0000
commitdb245e1d4f6365e948c79cefeb7cab2870bb7957 (patch)
tree0af04905a452a9bf29ea3d7c77f7f221016985e0 /Master/tlpkg/doc/releng.txt
parentf12daf64ff24d47a74a0ac5f8bff673735f4912c (diff)
frozen => 1 for end of TL17 updates
git-svn-id: svn://tug.org/texlive/trunk@46779 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/tlpkg/doc/releng.txt')
-rw-r--r--Master/tlpkg/doc/releng.txt107
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