[vala/wip/dbusgen: 67/78] doc: Add valadbusgen manpage

[Rico Tzschichholz <ricotz src gnome org>]

commit 95f79a833969e48be28f73bd04702a70bff833a4
Author: Rico Tzschichholz <ricotz ubuntu com>
Date:   Wed Sep 19 14:22:26 2018 +0200

    doc: Add valadbusgen manpage

 doc/Makefile.am     | 12 ++++++++++--
 doc/valadbusgen.1   | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++
 doc/valadbusgen.h2m | 23 +++++++++++++++++++++++
 3 files changed, 84 insertions(+), 2 deletions(-)
---
diff --git a/doc/Makefile.am b/doc/Makefile.am
index d2684a0e0..6e500a8cd 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -6,6 +6,7 @@ SUBDIRS = \
 
 dist_man_MANS = \
        valac.1 \
+       valadbusgen.1 \
        vala-gen-introspect.1 \
        vapigen.1 \
        $(NULL)
@@ -18,6 +19,7 @@ endif
 
 EXTRA_DIST = \
        valac.h2m \
+       valadbusgen.h2m \
        valadoc.h2m \
        vala-gen-introspect.h2m \
        vapigen.h2m \
@@ -25,9 +27,9 @@ EXTRA_DIST = \
 
 if HAVE_HELP2MAN
 if ENABLE_VALADOC
-manpages: valac.1 valadoc.1 vala-gen-introspect.1 vapigen.1
+manpages: valac.1 valadbusgen.1 valadoc.1 vala-gen-introspect.1 vapigen.1
 else
-manpages: valac.1 vala-gen-introspect.1 vapigen.1
+manpages: valac.1 valadbusgen.1 vala-gen-introspect.1 vapigen.1
 endif
        @rm $^
        $(MAKE) $(AM_MAKEFLAGS) $^
@@ -37,6 +39,11 @@ valac.1:
                --include $(srcdir)/valac.h2m \
                --libtool --no-info \
                --output=$@
+valadbusgen.1:
+       $(HELP2MAN) $(top_builddir)/dbusgen/valadbusgen \
+               --include $(srcdir)/valadbusgen.h2m \
+               --libtool --no-info \
+               --output=$@
 if ENABLE_VALADOC
 valadoc.1:
        $(HELP2MAN) $(top_builddir)/valadoc/valadoc \
@@ -60,6 +67,7 @@ endif
 if ENABLE_UNVERSIONED
 install-data-hook:
        cd $(DESTDIR)$(man1dir) && $(LN_S) -f valac@PACKAGE_SUFFIX@.1 valac.1
+       cd $(DESTDIR)$(man1dir) && $(LN_S) -f valadbusgen@PACKAGE_SUFFIX@.1 valadbusgen.1
 if ENABLE_VALADOC
        cd $(DESTDIR)$(man1dir) && $(LN_S) -f valadoc@PACKAGE_SUFFIX@.1 valadoc.1
 endif
diff --git a/doc/valadbusgen.1 b/doc/valadbusgen.1
new file mode 100644
index 000000000..738509d57
--- /dev/null
+++ b/doc/valadbusgen.1
@@ -0,0 +1,51 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.12.
+.TH VALADBUSGEN "1" "January 2020" "valadbusgen DBus Interface Generator 0.47.2" "User Commands"
+.SH NAME
+valadbusgen \- generate a Vala API from DBus xml
+.SH SYNOPSIS
+.B valadbusgen \fISOURCE\fP \fIPKGBASE\fP
+[\fIOPTION\fR]... [\fIFILE\fR]...
+.SH DESCRIPTION
+.B valadbusgen
+is a utility which generates Vala API (VAPI) files from DBus xml files.
+.SS "Usage:"
+.IP
+valadbusgen [OPTION?] FILE... \- Vala DBus Interface Generator
+.SS "Help Options:"
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Show help options
+.SS "Application Options:"
+.TP
+\fB\-\-vapidir\fR=\fI\,DIRECTORY\/\fR...
+Look for package bindings in DIRECTORY
+.TP
+\fB\-\-nostdpkg\fR
+Do not include standard packages
+.TP
+\fB\-\-pkg\fR=\fI\,PACKAGE\/\fR...
+Include binding for PACKAGE
+.TP
+\fB\-d\fR, \fB\-\-directory\fR=\fI\,DIRECTORY\/\fR
+Output directory
+.TP
+\fB\-\-disable\-warnings\fR
+Disable warnings
+.TP
+\fB\-\-dbus\-timeout\fR
+DBus timeout
+.TP
+\fB\-\-version\fR
+Display version number
+.TP
+\fB\-q\fR, \fB\-\-quiet\fR
+Do not print messages to the console
+.SH BUGS
+https://gitlab.gnome.org/GNOME/vala/issues
+.SH "HOMEPAGE OR CONTACT"
+https://wiki.gnome.org/Projects/Vala
+.SH AUTHORS
+Chris Daley, Rico Tzschichholz.
+.SH EXAMPLES
+This can then be converted to a Vala API as follows:
+.B valadbusgen /usr/share/dbus-1/interfaces/org.freedesktop.GeoClue2.xml
diff --git a/doc/valadbusgen.h2m b/doc/valadbusgen.h2m
new file mode 100644
index 000000000..632978351
--- /dev/null
+++ b/doc/valadbusgen.h2m
@@ -0,0 +1,23 @@
+[NAME]
+valadbusgen \- generate a Vala API from DBus xml
+
+[SYNOPSIS]
+.B valadbusgen \fISOURCE\fP \fIPKGBASE\fP
+[\fIOPTION\fR]... [\fIFILE\fR]...
+
+[DESCRIPTION]
+.B valadbusgen
+is a utility which generates Vala API (VAPI) files from DBus xml files.
+
+[EXAMPLES]
+This can then be converted to a Vala API as follows:
+.B valadbusgen /usr/share/dbus-1/interfaces/org.freedesktop.GeoClue2.xml
+
+[BUGS]
+https://gitlab.gnome.org/GNOME/vala/issues
+
+[HOMEPAGE or CONTACT]
+https://wiki.gnome.org/Projects/Vala
+
+[AUTHORS]
+Chris Daley, Rico Tzschichholz.