From 797414be05220fa371972606d7a6c2e94dd6d8db Mon Sep 17 00:00:00 2001
From: Jakub Jelen <jjelen@redhat.com>
Date: Wed, 22 Apr 2020 16:48:40 +0200
Subject: [PATCH] Create missing man pages (goid needs some work)

---
 doc/tools/goid-tool.1.xml       | 126 ++++++++++++++++++++++++++++++++
 doc/tools/pkcs11-register.1.xml | 124 +++++++++++++++++++++++++++++++
 2 files changed, 250 insertions(+)
 create mode 100644 doc/tools/goid-tool.1.xml
 create mode 100644 doc/tools/pkcs11-register.1.xml

diff --git a/doc/tools/goid-tool.1.xml b/doc/tools/goid-tool.1.xml
new file mode 100644
index 00000000..53e23140
--- /dev/null
+++ b/doc/tools/goid-tool.1.xml
@@ -0,0 +1,126 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<refentry id="goid-tool">
+	<refmeta>
+		<refentrytitle>goid-tool</refentrytitle>
+		<manvolnum>1</manvolnum>
+		<refmiscinfo class="productname">OpenSC</refmiscinfo>
+		<refmiscinfo class="manual">OpenSC Tools</refmiscinfo>
+		<refmiscinfo class="source">opensc</refmiscinfo>
+	</refmeta>
+
+	<refnamediv>
+		<refname>goid-tool</refname>
+		<refpurpose>???</refpurpose>
+	</refnamediv>
+
+	<refsynopsisdiv>
+		<cmdsynopsis>
+			<command>goid-tool</command>
+			<arg choice="opt"><replaceable class="option">OPTIONS</replaceable></arg>
+			<arg><replaceable class="option">mode</replaceable></arg>
+		</cmdsynopsis>
+	</refsynopsisdiv>
+
+	<refsect1>
+		<title>Description</title>
+		<para>
+			The <command>goid-tool</command> utility can be used from
+			the command line to ???
+		</para>
+	</refsect1>
+
+	<refsect1>
+		<title>Options</title>
+		<para>
+			<variablelist>
+				<varlistentry>
+					<term>
+						<option>--help</option>,
+						<option>-h</option>
+					</term>
+					<listitem><para>Print help message on screen.</para></listitem>
+				</varlistentry>
+				<varlistentry>
+					<term>
+						<option>--version</option>,
+						<option>-V</option>
+					</term>
+					<listitem><para>Print the OpenSC package release version.</para></listitem>
+				</varlistentry>
+				<varlistentry>
+					<term>
+						<option>--reader</option> <replaceable>string</replaceable>,
+						<option>-r</option> <replaceable>string</replaceable>
+					</term>
+					<listitem><para>
+						Specify the number of the reader to use. By default, the
+						first reader with present card is used. If
+						the arguement is an ATR, the reader with a
+						matching card will be chosen.
+					</para></listitem>
+				</varlistentry>
+				<varlistentry>
+					<term>
+						<option>--verbose</option>,
+						<option>-v</option>
+					</term>
+					<listitem><para>
+						Cause <command>goid-tool</command> to be
+						more verbose. Use it multiple times to be even more
+						verbose.
+					</para></listitem>
+				</varlistentry>
+				<varlistentry>
+					<term>
+						<option>--verify-pin</option>,
+						<option>-p</option>
+					</term>
+					<listitem><para>
+						Verify PIN.
+					</para></listitem>
+				</varlistentry>
+				<varlistentry>
+					<term>
+						<option>--verify-bio</option>,
+						<option>-b</option>
+					</term>
+					<listitem><para>
+						Verify finger print.
+					</para></listitem>
+				</varlistentry>
+				<varlistentry>
+					<term>
+						<option>--verify-pin-or-bio</option>
+					</term>
+					<listitem><para>
+						Verify PIN or finger print (user's choice).
+					</para></listitem>
+				</varlistentry>
+			</variablelist>
+		</para>
+	</refsect1>
+<!-- TODO modes -->
+	<refsect1>
+		<title>See also</title>
+		<para>
+			<citerefentry>
+				<refentrytitle>pkcs11-tool</refentrytitle>
+				<manvolnum>1</manvolnum>
+			</citerefentry>
+			<citerefentry>
+				<refentrytitle>opensc.conf</refentrytitle>
+				<manvolnum>5</manvolnum>
+			</citerefentry>
+		</para>
+	</refsect1>
+
+	<refsect1>
+		<title>Authors</title>
+		<para><command>pkcs11-register</command> was written by
+		Frank Morgner <email>frankmorgner@gmail.com</email>.</para>
+	</refsect1>
+
+</refentry>
+
+
+
diff --git a/doc/tools/pkcs11-register.1.xml b/doc/tools/pkcs11-register.1.xml
new file mode 100644
index 00000000..a3da7546
--- /dev/null
+++ b/doc/tools/pkcs11-register.1.xml
@@ -0,0 +1,124 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<refentry id="pkcs11-register">
+	<refmeta>
+		<refentrytitle>pkcs11-register</refentrytitle>
+		<manvolnum>1</manvolnum>
+		<refmiscinfo class="productname">OpenSC</refmiscinfo>
+		<refmiscinfo class="manual">OpenSC Tools</refmiscinfo>
+		<refmiscinfo class="source">opensc</refmiscinfo>
+	</refmeta>
+
+	<refnamediv>
+		<refname>pkcs11-register</refname>
+		<refpurpose>Simple tool to install PKCS#11 modules to known applications.</refpurpose>
+	</refnamediv>
+
+	<refsynopsisdiv>
+		<cmdsynopsis>
+			<command>pkcs11-register</command>
+			<arg choice="opt"><replaceable class="option">OPTIONS</replaceable></arg>
+		</cmdsynopsis>
+	</refsynopsisdiv>
+
+	<refsect1>
+		<title>Description</title>
+		<para>
+			The <command>pkcs11-register</command> utility can be used from
+			the command line to register PKCS#11 modules to various applications
+		</para>
+	</refsect1>
+
+	<refsect1>
+		<title>Options</title>
+		<para>
+			<variablelist>
+				<varlistentry>
+					<term>
+						<option>--help</option>,
+						<option>-h</option>
+					</term>
+					<listitem><para>Print help message on screen.</para></listitem>
+				</varlistentry>
+				<varlistentry>
+					<term>
+						<option>--version</option>,
+						<option>-V</option>
+					</term>
+					<listitem><para>Print the OpenSC package release version.</para></listitem>
+				</varlistentry>
+				<varlistentry>
+					<term>
+						<option>--module</option> <replaceable>filename</replaceable>,
+						<option>-m</option> <replaceable>filename</replaceable>
+					</term>
+					<listitem><para>
+						Path to the PKCS#11 module to load. The default
+						is OpenSC PKCS#11 module.
+					</para></listitem>
+				</varlistentry>
+				<varlistentry>
+					<term>
+						<option>--skip-chrome</option>
+					</term>
+					<listitem><para>
+						Don't install module for Chrome browser. By default,
+						the tool attempts to install the module for Chrome
+						browser.
+					</para></listitem>
+				</varlistentry>
+				<varlistentry>
+					<term>
+						<option>--skip-firefox</option>
+					</term>
+					<listitem><para>
+						Don't install module for Firefox browser. By default,
+						the tool attempts to install the module for Firefox
+						browser.
+					</para></listitem>
+				</varlistentry>
+				<varlistentry>
+					<term>
+						<option>--skip-thunderbird</option>
+					</term>
+					<listitem><para>
+						Don't install module for Thunderbird mail client.
+						By default, the tool attempts to install the module
+						for Thunderbird mail client.
+					</para></listitem>
+				</varlistentry>
+				<varlistentry>
+					<term>
+						<option>--skip-seamonkey</option>
+					</term>
+					<listitem><para>
+						Don't install module for Seamonkey. By default,
+						the tool attempts to install the module Seamonkey.
+					</para></listitem>
+				</varlistentry>
+			</variablelist>
+		</para>
+	</refsect1>
+
+	<refsect1>
+		<title>See also</title>
+		<para>
+			<citerefentry>
+				<refentrytitle>pkcs11-tool</refentrytitle>
+				<manvolnum>1</manvolnum>
+			</citerefentry>
+			<citerefentry>
+				<refentrytitle>opensc.conf</refentrytitle>
+				<manvolnum>5</manvolnum>
+			</citerefentry>
+		</para>
+	</refsect1>
+
+	<refsect1>
+		<title>Authors</title>
+		<para><command>pkcs11-register</command> was written by
+		Frank Morgner <email>frankmorgner@gmail.com</email>.</para>
+	</refsect1>
+
+</refentry>
+
+