ngz pushed a commit to branch tex-team
in repository guix.

commit 6288589f951874a2764d4e72722d9487d70c58b4
Author: Nicolas Goaziou <m...@nicolasgoaziou.fr>
AuthorDate: Mon Feb 10 11:29:23 2025 +0100

    gnu: texlive build system: Un-dumbify a comment.
    
    * guix/build/texlive-build-system.scm (build): Clarify a poorly explained
    design choice.
    
    Change-Id: Ida4e4ccb3934f8b5cc7a6e36e33cec7a5e5581e8
---
 guix/build/texlive-build-system.scm | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/guix/build/texlive-build-system.scm 
b/guix/build/texlive-build-system.scm
index 4a1afc709b..25b64991f7 100644
--- a/guix/build/texlive-build-system.scm
+++ b/guix/build/texlive-build-system.scm
@@ -214,8 +214,10 @@ runfile to replace.  If a file has no matching runfile, it 
is ignored."
                                                        f))))
                        build-targets))
           ((directory-exists? "source")
-           ;; Prioritize ".ins" files over ".dtx" files.  There's no
-           ;; scientific reasoning here; it just seems to work better.
+           ;; Prioritize ".ins" files over ".dtx" files.  The former only
+           ;; generate runfiles whereas the latter usually also rebuild
+           ;; documentation, which is not regenerated during the build process
+           ;; as it would introduce some bootstrapping issues.
            (match (find-files "source" "\\.ins$")
              (() (find-files "source" "\\.dtx$"))
              (files files)))

Reply via email to