From 5b3b2b1fa3e00f1978d5c8abd16469ff7197e5a2 Mon Sep 17 00:00:00 2001
From: Pierre Pronchery <khorben@defora.org>
Date: Sun, 18 Oct 2015 22:53:21 +0200
Subject: [PATCH] Add a manual page for compare(1)

---
 doc/compare.css.xml |  7 ++++
 doc/compare.xml     | 93 +++++++++++++++++++++++++++++++++++++++++++++
 doc/project.conf    | 16 +++++++-
 3 files changed, 114 insertions(+), 2 deletions(-)
 create mode 100644 doc/compare.css.xml
 create mode 100644 doc/compare.xml

diff --git a/doc/compare.css.xml b/doc/compare.css.xml
new file mode 100644
index 0000000..08d8dd3
--- /dev/null
+++ b/doc/compare.css.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0"?>
+<!-- $Id$ -->
+<!DOCTYPE style [
+<!ENTITY manual "manual.css.xml">
+]>
+<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="&manual;"/>
+<!-- vim: set noet ts=1 sw=1 sts=1 tw=80: -->
diff --git a/doc/compare.xml b/doc/compare.xml
new file mode 100644
index 0000000..1c83736
--- /dev/null
+++ b/doc/compare.xml
@@ -0,0 +1,93 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- $Id$ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+	<!ENTITY firstname "Pierre">
+	<!ENTITY surname   "Pronchery">
+	<!ENTITY username  "khorben">
+	<!ENTITY email     "khorben@defora.org">
+	<!ENTITY section   "1">
+	<!ENTITY title     "Accessories User Manual">
+	<!ENTITY package   "DeforaOS Accessories">
+	<!ENTITY name      "compare">
+	<!ENTITY purpose   "String comparison">
+]>
+<refentry>
+	<refentryinfo>
+		<title>&title;</title>
+		<productname>&package;</productname>
+		<authorgroup>
+			<author>
+				<firstname>&firstname;</firstname>
+				<surname>&surname;</surname>
+				<contrib>Code and documentation.</contrib>
+				<address>
+					<email>&email;</email>
+				</address>
+			</author>
+		</authorgroup>
+		<copyright>
+			<year>2015</year>
+			<holder>&firstname; &surname; &lt;&email;&gt;</holder>
+		</copyright>
+		<legalnotice>
+			<para>This manual page was written for the DeforaOS Project (and may be
+				used by others).</para>
+			<para>Permission is granted to copy, distribute and/or modify this
+				document under the terms of the GNU General Public License,
+				Version 3 as published by the Free Software Foundation.</para>
+		</legalnotice>
+	</refentryinfo>
+	<refmeta>
+		<refentrytitle>&name;</refentrytitle>
+		<manvolnum>&section;</manvolnum>
+	</refmeta>
+	<refnamediv>
+		<refname>&name;</refname>
+		<refpurpose>&purpose;</refpurpose>
+	</refnamediv>
+	<refsynopsisdiv>
+		<cmdsynopsis>
+			<command>&name;</command>
+			<arg choice="opt"><replaceable>string1</replaceable>
+				<arg choice="opt"><replaceable>string2</replaceable></arg></arg>
+		</cmdsynopsis>
+	</refsynopsisdiv>
+	<refsect1 id="description">
+		<title>Description</title>
+		<para><command>&name;</command> is a graphical string comparison tool. It is
+			especially useful when comparing fingerprints, digests and so on.</para>
+	</refsect1>
+	<refsect1 id="options">
+		<title>Options</title>
+		<para><command>&name;</command> can be optionally be called with one or two
+			strings to compare directly.</para>
+	</refsect1>
+	<refsect1 id="bugs">
+		<title>Bugs</title>
+		<para>Issues can be listed and reported at <ulink
+				url="http://www.defora.org/os/project/bug_list/235/Accessories"/>.</para>
+	</refsect1>
+	<refsect1 id="see_also">
+		<title>See also</title>
+		<para>
+			<citerefentry>
+				<refentrytitle>cksum</refentrytitle>
+				<manvolnum>1</manvolnum>
+			</citerefentry>,
+			<citerefentry>
+				<refentrytitle>digest</refentrytitle>
+				<manvolnum>1</manvolnum>
+			</citerefentry>,
+			<citerefentry>
+				<refentrytitle>openssl</refentrytitle>
+				<manvolnum>1</manvolnum>
+			</citerefentry>,
+			<citerefentry>
+				<refentrytitle>ssh-keygen</refentrytitle>
+				<manvolnum>1</manvolnum>
+			</citerefentry>
+	</para>
+	</refsect1>
+</refentry>
+<!-- vim: set noet ts=1 sw=1 sts=1 tw=80: -->
diff --git a/doc/project.conf b/doc/project.conf
index 19e86db..7853cab 100644
--- a/doc/project.conf
+++ b/doc/project.conf
@@ -1,5 +1,17 @@
-targets=fontsel.1,fontsel.html,progress.1,progress.html
-dist=Makefile,docbook.sh,fontsel.css.xml,fontsel.xml,progress.css.xml,progress.xml,manual.css.xml
+targets=compare.1,compare.html,fontsel.1,fontsel.html,progress.1,progress.html
+dist=Makefile,compare.css.xml,compare.xml,docbook.sh,fontsel.css.xml,fontsel.xml,progress.css.xml,progress.xml,manual.css.xml
+
+[compare.1]
+type=script
+script=./docbook.sh
+install=
+depends=compare.xml
+
+[compare.html]
+type=script
+script=./docbook.sh
+install=
+depends=compare.css.xml,compare.xml,manual.css.xml
 
 [fontsel.1]
 type=script