ngz pushed a commit to branch tex-team
in repository guix.
commit 95b15cffff61961dbbdf3ddbbddbad683a7f1a45
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 | 23 ++++++++++++++++++-----
1 file changed, 18 insertions(+), 5 deletions(-)
diff --git a/gnu/packages/tex.scm b/gnu/packages/tex.scm
index cd4276f2a8..c31d838687 100644
--- a/gnu/packages/tex.scm
+++ b/gnu/packages/tex.scm
@@ -197,9 +197,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.
@@ -212,11 +212,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
