summaryrefslogtreecommitdiff
path: root/Master/tlpkg/doc
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
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')
-rw-r--r--Master/tlpkg/doc/packages.txt148
-rw-r--r--Master/tlpkg/doc/releng.txt188
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.