From mboxrd@z Thu Jan 1 00:00:00 1970 From: Chris Marusich Subject: How to package gnucash-docs Date: Wed, 06 Sep 2017 03:42:19 -0700 Message-ID: <87lglsds6s.fsf@gmail.com> Mime-Version: 1.0 Content-Type: multipart/signed; boundary="==-=-="; micalg=pgp-sha256; protocol="application/pgp-signature" Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:36010) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dpXn0-0004Hu-Cu for guix-devel@gnu.org; Wed, 06 Sep 2017 06:42:35 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dpXmy-0001Pa-4G for guix-devel@gnu.org; Wed, 06 Sep 2017 06:42:33 -0400 Received: from mail-pf0-x229.google.com ([2607:f8b0:400e:c00::229]:34710) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1dpXmx-0001Nx-SQ for guix-devel@gnu.org; Wed, 06 Sep 2017 06:42:32 -0400 Received: by mail-pf0-x229.google.com with SMTP id m1so12237382pfk.1 for ; Wed, 06 Sep 2017 03:42:28 -0700 (PDT) Received: from garuda ([2601:1c0:c801:8b71:4e0f:6eff:fef6:70b9]) by smtp.gmail.com with ESMTPSA id h70sm2764954pfc.115.2017.09.06.03.42.23 for (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Wed, 06 Sep 2017 03:42:24 -0700 (PDT) List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: guix-devel@gnu.org --==-=-= Content-Type: multipart/mixed; boundary="=-=-=" --=-=-= Content-Type: text/plain Content-Transfer-Encoding: quoted-printable Hi, I've noticed that the "help document" for GnuCash doesn't show up in Yelp on GNOME. Apparently, this is because most (if not all) of the GnuCash documentation is packaged separately in gnucash-docs, which hasn't been added to Guix yet. I've added it successfully (see attached patch), but I'm looking for guidance on how to make the following improvements. First, "make check" fails because xmllint tries to look up a DTD on the Internet when validating the XML for dozens of documents. This isn't a huge problem because I can simply skip the tests. I've manually verified that at least some of the documentation shows up correctly (in multiple languages, even!) in Yelp on GNOME, which is better than no documentation at all. However, it'd be nice if I could make the tests pass. Is there any trick for making xmllint work in a sandboxed build? Second, I'm not sure if gnucash-docs should exist as a separate package in Guix. I feel like it would be nicer if I could just add this as a "doc" output of the gnucash package. How can I accomplish that? Thank you for your help! =2D-=20 Chris --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0001-gnu-Add-gnucash-docs.patch Content-Transfer-Encoding: quoted-printable From=2089eca236514f7c86bdf0f6d93d4348bb0cab43bc Mon Sep 17 00:00:00 2001 From: Chris Marusich Date: Wed, 6 Sep 2017 03:15:05 -0700 Subject: [PATCH] gnu: Add gnucash-docs. * gnu/packages/gnucash.scm (gnucash-docs): Add it. =2D-- gnu/packages/gnucash.scm | 39 ++++++++++++++++++++++++++++++++++++++- 1 file changed, 38 insertions(+), 1 deletion(-) diff --git a/gnu/packages/gnucash.scm b/gnu/packages/gnucash.scm index ac2dce576..2d71e89dd 100644 =2D-- a/gnu/packages/gnucash.scm +++ b/gnu/packages/gnucash.scm @@ -23,8 +23,11 @@ #:use-module (guix packages) #:use-module (guix download) #:use-module (guix build-system gnu) + #:use-module (guix build-system glib-or-gtk) #:use-module (gnu packages) #:use-module (gnu packages autotools) + #:use-module (gnu packages docbook) + #:use-module (gnu packages documentation) #:use-module (gnu packages gnome) #:use-module (gnu packages gnupg) #:use-module (gnu packages glib) @@ -52,7 +55,7 @@ (base32 "0g2risryfgplxh6cxpsl7fn255vipgsx38b4l081h665nqwmz5nv")) (patches (search-patches "gnucash-price-quotes-perl.patch")))) =2D (build-system gnu-build-system) + (build-system glib-or-gtk-build-system) (inputs `(("guile" ,guile-2.0) ("icu4c" ,icu4c) @@ -114,6 +117,40 @@ import and transaction matching. It also automates se= veral tasks, such as financial calculations or scheduled transactions.") (license license:gpl3+))) =20 +(define-public gnucash-docs + (package + (name "gnucash-docs") + (version (package-version gnucash)) + (source + (origin + (method url-fetch) + (uri (string-append "mirror://sourceforge/gnucash/gnucash-docs/" + version "/gnucash-docs-" version ".tar.gz")) + (sha256 + (base32 + "0dfb4m4084apav9kjsc4mfbj99xsyxm59qhpm1nxvhybn5h6qr3r")))) + (build-system gnu-build-system) + ;; These are native-inputs because they seem to only be required for + ;; building the documentation. + (native-inputs + `(("libxml2" ,libxml2) + ("libxslt" ,libxslt) + ("docbook-xsl" ,docbook-xsl) + ("scrollkeeper" ,scrollkeeper))) + ;; Disable tests since xmllint tries to access the Internet, which fai= ls. + ;; We can enable tests if we figure out how to make it work offline. + (arguments '(#:tests? #f)) + (home-page "http://www.gnucash.org/") + (synopsis "Documentation for GnuCash") + (description + "User guide and other documentation for GnuCash in various languages. +This package exists because the GnuCash project maintains its documentatio= n in +an entirely separate package from the actual GnuCash program. To read the +documentation, install this package and then access the program's help as +usual, either from within GnuCash or by directly using your desktop +environment's help reader (e.g. Yelp in the case of GNOME.)") + (license (list license:fdl1.1+ license:gpl3+)))) + (define-public gwenhywfar (package (name "gwenhywfar") =2D-=20 2.14.1 --=-=-=-- --==-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEEy/WXVcvn5+/vGD+x3UCaFdgiRp0FAlmv0QsACgkQ3UCaFdgi Rp3Y8RAAm0hjxP1/vMxkg8fEoKF4qn4FzTRiMfEzJOwmuMz0GXGRDlXs7ogJGYQc g/yw1qL+emfMaJfvOCdN1WoQesApfKvhKnuXGykQyaryMB6IKrhBWN5XINLxQvYI nuVmAFd8Tst22gZONmAdX5yuZuHdQOEijNk0Cj3xSVSKTPgTx1tTtqELqzOnTMq2 wFtXUBtVACteZFcXJeABNhxVezNATg8vt71Kat8oUdBek1Zi7zT5a6i7l/3kPaZJ Ry9Uzzs5LPc3M4mURqRULvDnXApqKbKdXm2eUyZyMjHBunh40WB8OKTVPdCi/Jsf VdGeJcE45rwAargKlSemGahVF+5IEnlzcKRNLQ8Q/j9d8mXu5C/GtEjEnw2mFyiK 1AlwOTNVo4G9dw4uV+Z/57TLvgnd1A0maDJX9aR3LzUK7D/LXq+m63vZthCdqovU V8vpZjTirmBztjvxbfV1j7SqzL/lrIGyllf3/vJHQPyzs2fR5uGqfanbVFMLBaOd uZ/vbTQO4X1Pf61NuuPMIb0PmYYzxCVdtfPmUUZtxLKATdsgxIrh7ZVeaBnEj718 edf/C9TUanGN3q8ks3L7K1cgdYWGKTdS53t35UE03KmtpQeVVf6bjpVtZXOvSR2E NucfgQziA02czam9exTv8io7BYvHjtte5kwDjXSJF54bxXqmV4o= =8kWn -----END PGP SIGNATURE----- --==-=-=--