From 8f3e81e47edd347ace18ca274e1bd7474004fe08 Mon Sep 17 00:00:00 2001
From: Michael Prokop <mika@grml.org>
Date: Sun, 22 Jul 2018 13:51:04 +0200
Subject: [PATCH] Provide manpage for update-grml-rescueboot

---
 debian/control                  |  1 +
 debian/grml-rescueboot.manpages |  1 +
 man/update-grml-rescueboot.xml  | 87 +++++++++++++++++++++++++++++++++++++++++
 3 files changed, 89 insertions(+)
 create mode 100644 debian/grml-rescueboot.manpages
 create mode 100644 man/update-grml-rescueboot.xml

diff --git a/debian/control b/debian/control
index 2c0761f..402399f 100644
--- a/debian/control
+++ b/debian/control
@@ -9,6 +9,7 @@ Uploaders:
  Ulrich Dangel <mru@spamt.net>,
 Build-Depends:
  debhelper (>= 10~),
+ xmltoman,
 Standards-Version: 4.1.5
 Homepage: http://git.grml.org/?p=grml-rescueboot.git
 Vcs-git: git://git.grml.org/grml-rescueboot.git
diff --git a/debian/grml-rescueboot.manpages b/debian/grml-rescueboot.manpages
new file mode 100644
index 0000000..a09becb
--- /dev/null
+++ b/debian/grml-rescueboot.manpages
@@ -0,0 +1 @@
+man/update-grml-rescueboot.en.8
diff --git a/man/update-grml-rescueboot.xml b/man/update-grml-rescueboot.xml
new file mode 100644
index 0000000..901572b
--- /dev/null
+++ b/man/update-grml-rescueboot.xml
@@ -0,0 +1,87 @@
+<?xml version="1.0" standalone='no'?>
+<!DOCTYPE manpage SYSTEM "http://masqmail.cx/xmltoman/xmltoman.dtd">
+<?xml-stylesheet type="text/xsl" href="http://masqmail.cx/xmltoman/xmltoman.xsl" ?>
+
+<manpage name="update-grml-rescueboot" section="8" desc="Script to integrate Grml ISO for booting via GRUB">
+
+<synopsis>
+  <cmd>update-grml-rescueboot [-f] [-a <arg>32|64|96</arg>] [-t <arg>small|full</arg>]</cmd>
+</synopsis>
+
+<description>
+  <p>
+    grml-rescueboot integrates Grml ISO booting into GRUB.
+    It provides a script for update-grub which looks for Grml ISO images in <file>/boot/grml</file>,
+    and automatically adds an entry for each image.
+    The purpose is to use one of those images to boot a Grml rescue system without using a CD, USB stick or network boot (PXE).
+
+    <file>update-grml-rescueboot</file> is a script which checks for the latest stable version of Grml (via download.grml.org),
+    ensures there's enough free disk space in <file>/boot/grml</file> and downloads the ISO to <file>/boot/grml</file>.
+    It verifies the ISO signature and upon success executes update-grub then.
+    Everything should be ready for booting a Grml ISO via GRUB then.
+
+    This script makes integration of a Grml ISO into GRUB via grml-rescueboot even easier.
+    All that needs to be done is install grml-rescueboot and invoke update-grml-rescueboot afterwards.
+    Using the <arg>-a</arg> and <arg>-t</arg> options it's possible to use specific Grml ISOs.
+    If none of those options is specific it defaults to the grml-full flavour,
+    matching the currently running hardware architecture (i?86 or x86_64).
+  </p>
+</description>
+
+<options>
+
+<option>
+  <p><opt>-a <arg>arg</arg></opt></p>
+  <optdesc>
+    <p>
+      Choose Grml architecture, specified via <arg>arg</arg>.
+      Supported flavours are '32', '64' and '96'.
+      If unset defaults to the currently running architecture.
+    </p>
+  </optdesc>
+</option>
+
+<option>
+  <p><opt>-f</opt></p>
+  <optdesc>
+    <p>
+      Force execution, ignoring, e.g. existing ISO files and disk space checks for <file>/boot/grml</file>.
+    </p>
+  </optdesc>
+</option>
+
+<option>
+  <p><opt>-h</opt></p>
+  <optdesc>
+    <p>
+      Display usage information and exit script.
+    </p>
+  </optdesc>
+</option>
+
+<option>
+  <p><opt>-t <arg>arg</arg></opt></p>
+  <optdesc>
+    <p>
+      Choose Grml flavour, specified via <arg>arg</arg>.
+      Supported flavours are 'small' and 'full'.
+      If unset defaults to 'full'.
+    </p>
+  </optdesc>
+</option>
+
+</options>
+
+<section name = "Author">
+  <p>
+    update-grml-rescueboot was written by Michael Prokop, based on a script by Felipe Sateler.
+  </p>
+</section>
+
+<section name = "Bugs">
+  <p>
+    Please report them towards Debian's BTS, see https://bugs.debian.org/grml-rescueboot.
+  </p>
+</section>
+
+</manpage>
-- 
2.1.4