andreas pushed a commit to branch tex-team
in repository guix.
commit f5c4b2c4711bfc0339ac3e7d0d0c20b1789e8ba2
Author: Nicolas Goaziou <m...@nicolasgoaziou.fr>
AuthorDate: Wed Mar 26 23:08:15 2025 +0100
gnu: tex: Adjust comments for update process.
* gnu/packages/tex.scm: Suggest to log output of the global refresh. Also
mention that all collections must be imported again to find new packages.
Change-Id: Idd194384318143da50f3b269aa5acfdb95f72365
---
gnu/packages/tex.scm | 31 ++++++++++++++++++++++---------
1 file changed, 22 insertions(+), 9 deletions(-)
diff --git a/gnu/packages/tex.scm b/gnu/packages/tex.scm
index 98899cbb63..1607446e3a 100644
--- a/gnu/packages/tex.scm
+++ b/gnu/packages/tex.scm
@@ -175,10 +175,10 @@
;;; |
;;; |
;;; `-- bin -- hyphen-complete, etc. --
latex-bin
-;;; | _____________________
-;;; scripts --------(propagated)-------’ |
-;;; |
-;;; (#:texlive-latex-bin? #f)
+;;; |
__________________________________
+;;; scripts --------(propagated)-------’ |
+;;; |
+;;; (#:texlive-latex-bin? #f)
;;;
;;;
;;; Default font map files and ls-R database are updated in a profile hook
@@ -198,9 +198,9 @@
;;; automated. Yet, the following additional steps are required, and they can
;;; keep one busy for a while:
;;;
-;;; 1. First and foremost, run the updater:
+;;; 1. First and foremost, run the updater and log the (verbose) output:
;;;
-;;; ./pre-inst-env guix refresh -t texlive -u
+;;; ./pre-inst-env guix refresh -t texlive -u > update.log 2>&1
;;;
;;; This takes care of updating all binaries and all TeX Live packages,
;;; barring "collections" and "schemes", in a single run.
@@ -213,11 +213,24 @@
;;; references to deleted packages must also be cleared from their
;;; propagated inputs.
;;;
-;;; 3. Conversely, import newly integrated packages with, e.g.,
+;;; 3. Conversely, import newly integrated packages by refreshing all
+;;; "collections" with, e.g.,
;;;
-;;; ./pre-inst-env guix import texlive -r scheme-full
+;;; ./pre-inst-env guix import texlive -r collection-NAME >> \
+;;; new-packages.scm 2>&1
;;;
-;;; Those must be added to their respective "collections", too.
+;;; It is advisable to iterate the command above over the list of all their
+;;; names:
+;;;
+;;; basic bibtexextra binextra context fontextra fontsrecommended
+;;; fontutils formatsextra games humanities langarabic langchinese
+;;; langcjk langcyrillic langczechslovak langenglish langeuropean
+;;; langfrench langgerman langgreek langitalian langjapanese langkorean
+;;; langother langpolish langportuguese langspanish latex latexextra
+;;; latexrecommended luatex mathscience metapost music pictures
+;;; plaingeneric pstricks publishers xetex
+;;;
+;;; Propagated inputs of collections must be updated accordingly.
;;;
;;; 4. Handle inputs issues. No updater is allowed to create an input field
;;; in a package if it didn't exist beforehand. `texlive' updater is no
