From 402220b467a6dc48e68812ac91c49d175a0764fc Mon Sep 17 00:00:00 2001 From: micah Date: Sun, 25 Dec 2005 03:31:51 +0000 Subject: [PATCH] r197@um: micah | 2005-12-24 22:06:47 -0500 Added ninjahelper man page... git-svn-id: http://code.autistici.org/svn/backupninja/trunk@266 758a04ac-41e6-0310-8a23-8373a73cc35d --- man/ninjahelper.1 | 62 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 62 insertions(+) create mode 100644 man/ninjahelper.1 diff --git a/man/ninjahelper.1 b/man/ninjahelper.1 new file mode 100644 index 0000000..fdc10b7 --- /dev/null +++ b/man/ninjahelper.1 @@ -0,0 +1,62 @@ +.\" Hey, EMACS: -*- nroff -*- +.\" First parameter, NAME, should be all caps +.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection +.\" other parameters are allowed: see man(7), man(1) +.TH NINJAHELPER 1 "December 24, 2005" "riseup" "backupninja package" +.\" Please adjust this date whenever revising the manpage. +.\" +.\" Some roff macros, for reference: +.\" .nh disable hyphenation +.\" .hy enable hyphenation +.\" .ad l left justify +.\" .ad b justify to both left and right margins +.\" .nf disable filling +.\" .fi enable filling +.\" .br insert line break +.\" .sp insert n+1 empty lines +.\" for manpage-specific macros, see man(7) +.SH NAME +NINJAHELPER \- A menu driven curses-based interface to walk you through +backupninja configuration. +.br +.SH SYNOPSIS +.B "ninjahelper" +.br +.SH DESCRIPTION +.B Ninjahelper +is an helper script to walk you through configuration of the backup +tasks for backupninja. It is a curses based "wizard" with an intuitive +menu-driven interface. +.PP +.SH ADDING NEW HELPERS +.br +To add an additional 'wizard' to ninjahelper, follow these steps: +.IP (1) +create a file in the handlers directory (eg. /usr/share/backupninja) using +the .helper extention. For example, if you wish to create a helper for the +handler "blue", create the file /usr/share/backupninja/blue.helper. +.IP (2) +next, add your helper to the global HELPERS variable and define the main +function for your helper (the function name is always _wizard). To +use the blue.helper as an example: +HELPERS="$HELPERS blue:description_of_this_helper" + blue_wizard() { + ... do work here ... + } +.IP (3) +look at the existing helpers to see how they are written. Try to re-use +functions, such as the dialog functions that are defined in easydialog.sh, +or the vserver functions defined in lib/vserver +.IP (4) +test, re-test, and test again. Try to break the helper by going backwards, +try to think like someone who has no idea how to configure your handler +would think, try to make your helper as simple as possible. Walk like a cat, +become your shadow, don't let your senses betray you. + +.SH SEE ALSO +.BR backupninja (1), +.BR backupninja.conf (5), +.BR backup.d (5), +.br +.SH AUTHOR +BACKUPNINJA was written by the riseup.net collective. -- 2.30.2