summary refs log tree commit diff
path: root/gnu
diff options
context:
space:
mode:
authorHartmut Goebel <h.goebel@crazy-compilers.com>2016-12-02 15:20:00 +0100
committerHartmut Goebel <h.goebel@crazy-compilers.com>2016-12-02 18:07:36 +0100
commit447b9473cba5e65a9c46c2428b588a2110f01c5e (patch)
tree97e0419bae680a44a9b243b8cefba67ef2fa36f8 /gnu
parentb0aa6ede251709f650b30020057a86da8c636f99 (diff)
downloadguix-447b9473cba5e65a9c46c2428b588a2110f01c5e.tar.gz
gnu: dblatex: Update comment.
* gnu/packages/docbook.scm (dblatex)[arguments]: Detail comment about why
the use of setuptools needs to be disabled.
Diffstat (limited to 'gnu')
-rw-r--r--gnu/packages/docbook.scm10
1 files changed, 7 insertions, 3 deletions
diff --git a/gnu/packages/docbook.scm b/gnu/packages/docbook.scm
index f54e031873..46041c24d3 100644
--- a/gnu/packages/docbook.scm
+++ b/gnu/packages/docbook.scm
@@ -192,9 +192,13 @@ by no means limited to these applications.)  This package provides XML DTDs.")
        ("libxslt" ,libxslt)))           ;for xsltproc
     (arguments
      `(#:python ,python-2               ;'print' syntax
-       ;; XXX: Disable usage of setuptools, even though it is supported.
-       ;; This causes an invalid "package_base" in out/bin/.dblatex-real
-       ;; due to a missing leading '/'. See this thread for details:
+       ;; Using setuptools causes an invalid "package_base" path in
+       ;; out/bin/.dblatex-real due to a missing leading '/'.  This is caused
+       ;; by dblatex's setup.py stripping the root path when creating the
+       ;; script.  (dblatex's setup.py still uses distutils and thus has to
+       ;; create the script by itself. The feature for creating scripts is one
+       ;; of setuptools' features.)
+       ;; See this thread for details:
        ;; https://lists.gnu.org/archive/html/guix-devel/2016-12/msg00030.html
        #:use-setuptools? #f
        #:tests? #f                      ;no 'test' command