[bug#34028] [PATCH] gnu: dbus: Build documentation (manpages and html).

[bug#34028] [PATCH] gnu: dbus: Build documentation (manpages and html).

[Maxim Cournoyer]

[-- Attachment #1: Type: text/plain, Size: 102 bytes --]

Hello,

This adds the documentation for dbus.  It should be applied to
core-updates.

Thanks,

Maxim


[-- Attachment #2: 0001-gnu-dbus-Build-documentation-manpages-and-html.patch --]
[-- Type: text/x-patch, Size: 2289 bytes --]

From 2067f89a28a631eb05dd7301c08554bb0e9faa96 Mon Sep 17 00:00:00 2001
From: Maxim Cournoyer <maxim.cournoyer@gmail.com>
Date: Thu, 10 Jan 2019 07:35:38 -0500
Subject: [PATCH] gnu: dbus: Build documentation (manpages and html).

* gnu/packages/glib.scm (dbus)[native-inputs]: Add docbook-xml-4.4,
docbook-xsl, doxygen, xmlto, libxml2, libxslt and yelp-tools.
[outputs]: Add a "doc" output to hold the large HTML documentation.
---
 gnu/packages/glib.scm | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)

diff --git a/gnu/packages/glib.scm b/gnu/packages/glib.scm
index cd9b48caf..946ed2ba1 100644
--- a/gnu/packages/glib.scm
+++ b/gnu/packages/glib.scm
@@ -9,6 +9,7 @@
 ;;; Copyright © 2017 Petter <petter@mykolab.ch>
 ;;; Copyright © 2018 Tobias Geerinckx-Rice <me@tobias.gr>
 ;;; Copyright © 2018 Alex Vong <alexvong1995@gmail.com>
+;;; Copyright © 2019 Maxim Cournoyer <maxim.cournoyer@gmail.com>
 ;;;
 ;;; This file is part of GNU Guix.
 ;;;
@@ -33,6 +34,8 @@
   #:use-module (gnu packages bison)
   #:use-module (gnu packages check)
   #:use-module (gnu packages compression)
+  #:use-module (gnu packages docbook)
+  #:use-module (gnu packages documentation)
   #:use-module (gnu packages enlightenment)
   #:use-module (gnu packages file)
   #:use-module (gnu packages flex)
@@ -118,14 +121,21 @@
                             "sysconfdir=/tmp/dummy"
                             "install"))))))
     (native-inputs
-     `(("pkg-config" ,pkg-config)))
+     `(("pkg-config" ,pkg-config)
+       ;; Dependencies to generate the doc.
+       ("docbook-xml" ,docbook-xml-4.4)
+       ("docbook-xsl" ,docbook-xsl)
+       ("doxygen" ,doxygen)
+       ("xmlto" ,xmlto)
+       ("libxml2" ,libxml2)             ;for XML_CATALOG_FILES
+       ("libxslt" ,libxslt)
+       ("yelp-tools" ,yelp-tools)))
     (inputs
      `(("expat" ,expat)
-
        ;; Add a dependency on libx11 so that 'dbus-launch' has support for
        ;; '--autolaunch'.
        ("libx11" ,libx11)))
-
+    (outputs '("out" "doc"))            ;22 MiB of HTML doc
     (home-page "https://www.freedesktop.org/wiki/Software/dbus/")
     (synopsis "Message bus for inter-process communication (IPC)")
     (description
-- 
2.20.1

[bug#34028] [PATCH] gnu: dbus: Build documentation (manpages and html).

[Ludovic Courtès]

Hi Maxim,

Maxim Cournoyer <maxim.cournoyer@gmail.com> skribis:

>>From 2067f89a28a631eb05dd7301c08554bb0e9faa96 Mon Sep 17 00:00:00 2001
> From: Maxim Cournoyer <maxim.cournoyer@gmail.com>
> Date: Thu, 10 Jan 2019 07:35:38 -0500
> Subject: [PATCH] gnu: dbus: Build documentation (manpages and html).
>
> * gnu/packages/glib.scm (dbus)[native-inputs]: Add docbook-xml-4.4,
> docbook-xsl, doxygen, xmlto, libxml2, libxslt and yelp-tools.
> [outputs]: Add a "doc" output to hold the large HTML documentation.

LGTM, and OK for ‘core-updates’.

Thank you,
Ludo’.

bug#34028: [PATCH] gnu: dbus: Build documentation (manpages and html).

[Maxim Cournoyer]

Hey!

Ludovic Courtès <ludo@gnu.org> writes:

> Hi Maxim,
>
> Maxim Cournoyer <maxim.cournoyer@gmail.com> skribis:
>
>>>From 2067f89a28a631eb05dd7301c08554bb0e9faa96 Mon Sep 17 00:00:00 2001
>> From: Maxim Cournoyer <maxim.cournoyer@gmail.com>
>> Date: Thu, 10 Jan 2019 07:35:38 -0500
>> Subject: [PATCH] gnu: dbus: Build documentation (manpages and html).
>>
>> * gnu/packages/glib.scm (dbus)[native-inputs]: Add docbook-xml-4.4,
>> docbook-xsl, doxygen, xmlto, libxml2, libxslt and yelp-tools.
>> [outputs]: Add a "doc" output to hold the large HTML documentation.
>
> LGTM, and OK for ‘core-updates’.
>
> Thank you,
> Ludo’.

Thanks for taking a look! I've test building on core-updates and pushed as
commit cff1927f30c00e6df5a3be5bd7cb769cd1345873.

Thank you!

Maxim