adding man page, sample conf, makefile

[sitarba.git] / shbackup.docbook

diff --git a/shbackup.docbook b/shbackup.docbook
new file mode 100644 (file)
index 0000000..73b2fe8
--- /dev/null
+++ b/shbackup.docbook
@@ -0,0 +1,130 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.4//EN"
+"file:///usr/share/xml/docbook/schema/dtd/4.4/docbookx.dtd"
+[]>
+
+<refentry>
+
+       <refentryinfo>
+               <author>
+                       <firstname>Stefan</firstname>
+                       <surname>Huber</surname>
+               </author>
+               <date>2012-05-13</date>
+       </refentryinfo>
+
+       <refmeta>
+               <refentrytitle>shbackup</refentrytitle>
+               <manvolnum>1</manvolnum>
+       </refmeta>
+
+       <refnamediv>
+               <refname>shbackup</refname> 
+               <refpurpose>a simple backup solution</refpurpose>
+       </refnamediv>
+
+       <refsynopsisdiv>
+               <cmdsynopsis>
+                       <command>shbackup</command>
+                       <arg>options</arg>
+                       <arg choice="req"><replaceable>command</replaceable></arg>
+               </cmdsynopsis>
+       </refsynopsisdiv>
+  
+       <refsect1>
+               <title>DESCRIPTION</title>
+       
+               <para>
+                       <command>shbackup</command> is a simple backup solution
+                       which packs user-defined file sets with tar. Each
+                       backup belongs to an epoch, which can be year, month,
+                       week, day, hour or sporadic. The backup can be made
+                       either full, differential or incremental.
+
+                       <command>shbackup</command> takes care for pruning old
+                       backups. The user defines for each epoch the number of
+                       backups to keep, except for 'sporadic'. Sporadic
+                       backups need to be removed manually.
+               </para>
+       
+       </refsect1>
+
+       <refsect1>
+               <title>COMMANDS</title>
+       
+               <variablelist>
+       
+               <varlistentry>
+                       <term><option>backup</option></term>
+                       <listitem>
+                               <para>Make a backup</para>
+                       </listitem>
+               </varlistentry>
+
+               <varlistentry>
+                       <term><option>list</option></term>
+                       <listitem>
+                               <para>List all backups</para>
+                       </listitem>
+               </varlistentry>
+
+               <varlistentry>
+                       <term><option>prune</option></term>
+                       <listitem>
+                               <para>Prune outdated/stale backups</para>
+                       </listitem>
+               </varlistentry>
+
+               </variablelist>
+       </refsect1>
+  
+
+       <refsect1>
+               <title>OPTIONS</title>
+       
+               <variablelist>
+       
+               <varlistentry>
+                       <term><option>-h, --help</option></term>
+                       <listitem>
+                               <para>Print out a help summary.</para>
+                       </listitem>
+               </varlistentry>
+       
+               <varlistentry>
+                       <term><option>-c, --conf FILE</option></term>
+                       <listitem>
+                               <para>Use given configuration file instead of
+                                       /etc/shbackup.conf.</para>
+                       </listitem>
+               </varlistentry>
+       
+               <varlistentry>
+                       <term><option>-e, --epoch EPOCH</option></term>
+                       <listitem>
+                               <para>Do not determine epoch automatically, but
+                                       use EPOCH, which can be year, month,
+                                       week, day, hour, sporadic.</para>
+                       </listitem>
+               </varlistentry> 
+       
+               <varlistentry>
+                       <term><option>-m, --mode MODE</option></term>
+                       <listitem>
+                               <para>Instead of configured mode use MODE,
+                                       which can be full, diff or incr.</para>
+                       </listitem>
+               </varlistentry>
+
+       </variablelist>
+       </refsect1>
+
+       <refsect1>
+               <title>AUTHOR</title>
+       
+               <para>
+                       Stefan HUBER
+               </para>
+       </refsect1>
+</refentry>