[gnome-contacts/wip/nielsdg/update-man] data: Update manpage




commit ff4f494bbf8cbc297751db9f9bc1de761ae399cd
Author: Niels De Graef <nielsdegraef gmail com>
Date:   Fri Dec 4 11:58:31 2020 +0100

    data: Update manpage
    
    * Move to the `data` subfolder
    * Update the maintainer
    * Use a slightly saner indentation

 data/gnome-contacts.xml | 79 +++++++++++++++++++++++++++++++++++++++++++++
 data/meson.build        | 24 ++++++++++++++
 man/gnome-contacts.xml  | 86 -------------------------------------------------
 man/meson.build         | 20 ------------
 meson.build             |  3 --
 5 files changed, 103 insertions(+), 109 deletions(-)
---
diff --git a/data/gnome-contacts.xml b/data/gnome-contacts.xml
new file mode 100644
index 00000000..3357a8f9
--- /dev/null
+++ b/data/gnome-contacts.xml
@@ -0,0 +1,79 @@
+<?xml version='1.0'?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+        "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd";>
+
+<refentry id="gnome-contacts">
+
+    <refentryinfo>
+        <title>gnome-contacts</title>
+        <productname>GNOME</productname>
+
+        <authorgroup>
+            <author>
+                <contrib>Maintainer</contrib>
+                <firstname>Niels</firstname>
+                <surname>De Graef</surname>
+                <email>nielsdegraef gmail com</email>
+            </author>
+        </authorgroup>
+    </refentryinfo>
+
+    <refmeta>
+        <refentrytitle>gnome-contacts</refentrytitle>
+        <manvolnum>1</manvolnum>
+        <refmiscinfo class="manual">User Commands</refmiscinfo>
+    </refmeta>
+
+    <refnamediv>
+        <refname>gnome-contacts</refname>
+        <refpurpose>Access and store information about contacts</refpurpose>
+    </refnamediv>
+
+    <refsynopsisdiv>
+        <cmdsynopsis>
+            <command>gnome-contacts <arg choice="opt" rep="repeat">OPTION</arg></command>
+        </cmdsynopsis>
+    </refsynopsisdiv>
+
+    <refsect1>
+        <title>Description</title>
+
+        <para><command>gnome-contacts</command> is a graphical user interface
+        to access and store information about your contacts.</para>
+
+        <para>gnome-contacts uses the folks library to pull together contact
+        information from various sources, including evolution-data-server, your
+        configured GNOME online accounts, etc.</para>
+    </refsect1>
+
+    <refsect1>
+        <title>Options</title>
+
+        <variablelist>
+            <varlistentry>
+                <term><option>-?</option>, <option>--help</option></term>
+
+                <listitem><para>Prints a short help text and exits.</para></listitem>
+            </varlistentry>
+
+            <varlistentry>
+                <term><option>-e</option>, <option>--email</option></term>
+
+                <listitem><para>Show contact with this email address.</para></listitem>
+            </varlistentry>
+
+            <varlistentry>
+                <term><option>-i</option>, <option>--individual</option></term>
+
+                <listitem><para>Show contact with this individual id.</para></listitem>
+            </varlistentry>
+
+            <varlistentry>
+                <term><option>-v</option>, <option>--version</option></term>
+
+                <listitem><para>Show the current version of Contacts.</para></listitem>
+            </varlistentry>
+        </variablelist>
+    </refsect1>
+
+</refentry>
diff --git a/data/meson.build b/data/meson.build
index d78d47ab..435ff20e 100644
--- a/data/meson.build
+++ b/data/meson.build
@@ -98,3 +98,27 @@ configure_file(
   install: true,
   install_dir: get_option('datadir') / 'gnome-shell' / 'search-providers',
 )
+
+# Manpage
+if get_option('manpage')
+  xsltproc = find_program('xsltproc')
+
+  custom_target('manfile-gnome-contacts',
+    input: 'gnome-contacts.xml',
+    output: 'gnome-contacts.1',
+    install: true,
+    install_dir: get_option('mandir') / 'man1',
+    command: [
+      xsltproc,
+      '--nonet',
+      '--stringparam', 'man.output.quietly', '1',
+      '--stringparam', 'funcsynopsis.style', 'ansi',
+      '--stringparam', 'man.th.extra1.suppress', '1',
+      '--stringparam', 'man.authors.section.enabled', '0',
+      '--stringparam', 'man.copyright.section.enabled', '0',
+      '-o', '@OUTPUT@',
+      'http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl',
+      '@INPUT@'
+    ]
+  )
+endif
diff --git a/meson.build b/meson.build
index eb4da234..15062b4e 100644
--- a/meson.build
+++ b/meson.build
@@ -88,9 +88,6 @@ meson.add_install_script('build-aux/meson_post_install.py')
 subdir('data')
 subdir('po')
 subdir('src')
-if get_option('manpage')
-  subdir('man')
-endif
 if get_option('docs')
   subdir('docs')
 endif


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]