public
/
nixpkgs
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

texlive: touchup documentation (#77718) 

The `bash` pragma gives syntax highlighting on the file, and removing the
prompts allows a user to just copy-paste the entire block into the terminal to
run the update.
This commit is contained in:
Benjamin Hipple 2020-01-16 23:30:20 -05:00 committed by Dmitry Kalinkin
parent 2628f20267
commit 39700a65ef
1 changed files with 11 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
pkgs/tools/typesetting/tex/texlive/UPGRADING.md
View File

@ -28,15 +28,15 @@ To upgrade the package snapshot, follow this process:
### Snapshot sources and texlive package database ### Snapshot sources and texlive package database
Mirror the current CTAN archive to our mirror(s) and IPFS (URLs in `default.nix`). Mirror the current CTAN archive to our mirror(s) and IPFS (URLs in `default.nix`).
See <https://tug.org/texlive/acquire-mirror.html> for instructions. See https://tug.org/texlive/acquire-mirror.html for instructions.
### Upgrade package information from texlive package database ### Upgrade package information from texlive package database
``` ```bash
$ curl -L http://mirror.ctan.org/tex-archive/systems/texlive/tlnet/tlpkg/texlive.tlpdb.xz \ curl -L http://mirror.ctan.org/tex-archive/systems/texlive/tlnet/tlpkg/texlive.tlpdb.xz \
| xzcat | uniq -u | sed -rn -f ./tl2nix.sed > ./pkgs.nix | xzcat | uniq -u | sed -rn -f ./tl2nix.sed > ./pkgs.nix
``` ```
This will download a current snapshot of the CTAN package database `texlive.tlpdb.xz` This will download a current snapshot of the CTAN package database `texlive.tlpdb.xz`
@ -52,17 +52,18 @@ Updating the list of fixed hashes requires a local build of *all* packages,
which is a resource-intensive process: which is a resource-intensive process:
``` ```bash
# move fixedHashes away, otherwise build will fail on updated packages # move fixedHashes away, otherwise build will fail on updated packages
$ mv fixedHashes.nix fixedHashes-old.nix mv fixedHashes.nix fixedHashes-old.nix
# start with empty fixedHashes # start with empty fixedHashes
$ echo '{}' > fixedHashes.nix echo '{}' > fixedHashes.nix
$ nix-build ../../../../.. -Q --no-out-link -A texlive.scheme-full.pkgs | ./fixHashes.sh > ./fixedHashes-new.nix
nix-build ../../../../.. -Q --no-out-link -A texlive.scheme-full.pkgs | ./fixHashes.sh > ./fixedHashes-new.nix
# The script wrongly includes the nix store path to `biber`, which is a separate nixpkgs package # The script wrongly includes the nix store path to `biber`, which is a separate nixpkgs package
$ grep -v -F '/nix/store/' fixedHashes-new.nix > fixedHashes.nix grep -v -F '/nix/store/' fixedHashes-new.nix > fixedHashes.nix
``` ```
### Commit changes ### Commit changes
Commit the updated `pkgs.nix` and `fixedHashes.nix` to the repository. Commit the updated `pkgs.nix` and `fixedHashes.nix` to the repository.