summaryrefslogtreecommitdiff
path: root/Master/tlpkg/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2020-03-10 16:46:34 +0000
committerKarl Berry <karl@freefriends.org>2020-03-10 16:46:34 +0000
commitaf446d36b33df852f2be14288d1ebabfcade3116 (patch)
tree07939227f611041976906de0005a0faba5348dbe /Master/tlpkg/doc
parent4480b9200dc29547866e0908e9326eb512b273db (diff)
tl-update-install-pkg,
tl-update-containers: mostly use $prg (basename) instead of $0. tl-update-tlnet: new option --no-install-pkg for use when updating frozen release after moving to pretest. git-svn-id: svn://tug.org/texlive/trunk@54221 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/tlpkg/doc')
-rw-r--r--Master/tlpkg/doc/releng.txt42
1 files changed, 35 insertions, 7 deletions
diff --git a/Master/tlpkg/doc/releng.txt b/Master/tlpkg/doc/releng.txt
index 14f60e6b2b6..3ad7084b596 100644
--- a/Master/tlpkg/doc/releng.txt
+++ b/Master/tlpkg/doc/releng.txt
@@ -72,12 +72,13 @@ and
1a. Then preserve final tlnet of current release YYYY:
cd /home/ftp/texlive/tlnet
cp -ar ../tlnet /home/ftp/historic/systems/texlive/YYYY/tlnet-final
-# if and when post-freeze updates are made, also update tlnet-final with:
-rsync -anv \
- /home/ftp/texlive/tlnet/ /home/ftp/historic/systems/texlive/YYYY/tlnet-final/
-to see what will be changed, and then remove the -n to actually do it.
+# if and when post-freeze updates are needed, see below.
-1b. Set up tlpretest:
+1b. Also preserve Catalogue as of the freeze, again for the sake of
+ post-freeze updates:
+rsync -ar /home/httpd/html/catalogue /home/texlive/catalogue-freeze
+
+1c. Set up tlpretest:
Update /home/ftp/texlive/tlpretest/README.
Empty tlpretest except for that README and 00_TIME.txt (used for mirmon).
@@ -146,7 +147,7 @@ This was a one-time event, but left here as an example for the unknown future.
10. Life and daily updates go on. In cron.tl, set:
net_frozen=false
- catalogue_compare=true
+ catalogue_compare=true # maybe not every day?
A. At some point, after tlnet freeze:
Update gpg expiration, see tlpkg/gpg/tl-key-extension.txt.
@@ -203,8 +204,35 @@ nice -19 svn co svn://tug.org/texlive/branches/branch$tlyear.$subnum . >&out
# errors, just rm out afterwards.
e) make the required update, probably most easily by copying the
- affected files from the trunk. Running ctan2tl (c2l) inside the
+ affected files from the trunk. Running ctan2tl (or c2l) inside the
branch checkout should also work, if no other changes have intervened.
+
+ f) remake tlnet (not tlpretest); cron.tl does too much overhead for
+ this delicate situation, so run the commands by hand.
+ 1) update tlpdb so we'll get the new revision number;
+ must run from branch, not trunk, or all will be wrong!
+cd /home/texlive/branch/Master/tlpkg/bin # must be in branch directory
+ Use Catalogue snapshot saved above (at "preserve Catalogue")
+ to avoid myriad Catalogue changes.
+ If files have been removed without any other changes to a given
+ package (hopefully not), add --fix-reverse-revisions.
+catdir=/home/texlive/catalogue-freeze
+./tl-update-tlpdb --catalogue=$catdir
+ Check that only expected changes are made.
+ Might be easier to run this, get the new revision number(s),
+ then revert and manually edit if there are additional unneeded
+ changes. Don't worry about 00texlive.*, they aren't distributed.
+
+ 2) for safety, make a backup of tlnet:
+tar -cf /tmp/tlnet.tar -C /home/ftp/texlive/tlnet . # remove when done
+
+ 3) update tlnet, again from the branch, not trunk. Double check!
+ we don't want to update the installer packages, as they have
+ already been getting updated from trunk, so are newer.
+cd /home/texlive/branch/Master/tlpkg/bin
+./tl-update-tlnet --no-install-pkgs
+ It will take about an hour to run. hopefully only the intended
+ packages will get updated. if not, that's why we made the tar backup.
e) Update the tlnet-final directory in historic:
tlnet_live=/home/ftp/texlive/tlnet