From 75db20c08335a7c3322d2050fdb41414a16b9c63 Mon Sep 17 00:00:00 2001
From: Nalin Dahyabhai <nalin@dahyabhai.net>
Date: Tue, 19 Apr 2011 13:56:12 -0400
Subject: - try to add a man page for nisserver-plugin-defs

---
 src/Makefile.am                |  2 ++
 src/nisserver-plugin-defs.1.in | 37 +++++++++++++++++++++++++++++++++++++
 2 files changed, 39 insertions(+)
 create mode 100644 src/nisserver-plugin-defs.1.in

(limited to 'src')

diff --git a/src/Makefile.am b/src/Makefile.am
index 908e6d5..684dbbc 100644
--- a/src/Makefile.am
+++ b/src/Makefile.am
@@ -18,6 +18,8 @@ sbin_PROGRAMS = nisserver-plugin-defs
 nisserver_plugin_defs_CFLAGS = $(AM_CFLAGS) -DDEFS_NIS_MAIN
 nisserver_plugin_defs_SOURCES = defs-nis.c
 
+man_MANS = nisserver-plugin-defs.1
+
 noinst_PROGRAMS = portmap
 portmap_CFLAGS = $(AM_CFLAGS) -DPORTMAP_MAIN
 portmap_SOURCES = portmap.c
diff --git a/src/nisserver-plugin-defs.1.in b/src/nisserver-plugin-defs.1.in
new file mode 100644
index 0000000..0668a4d
--- /dev/null
+++ b/src/nisserver-plugin-defs.1.in
@@ -0,0 +1,37 @@
+.TH nisserver-plugin-defs 1 2011/04/19 "slapi-nis" "System Administrator's Manual"
+
+.SH NAME
+nisserver-plugin-defs \- print default settings for the NIS server plugin
+
+.SH SYNOPSIS
+nisserver-plugin-defs [-d \fIdomain\fP ] [-m \fImap\fP ] [-s \fIsuffix\fP ]
+
+.SH DESCRIPTION
+The \fInisserver-plugin-defs\fP command produces example configuration entries
+containing the default settings which the NIS server plugin will use for all
+maps for which it has built-in defaults, or if a particular map name is
+specified, for one map.
+
+.SH ARGUMENTS
+.TP
+-d DOMAIN
+By default, \fInisserver-plugin-defs\fP uses a placeholder for the NIS domain
+name when it prints example configuration entries.  This option allows a
+particular domain name to be specified.
+.TP
+-m MAP
+By default, \fInisserver-plugin-defs\fP prints example configuration entries
+for all of the maps for which it has built-in defaults.  This option can be
+used to examine the defaults associated with a particular map name.
+.TP
+-m SUFFIX
+By default, \fInisserver-plugin-defs\fP uses a placeholder for the base DN
+under which it expects to find entries which are relevant for the map.  This
+option allows a particular search base to be specified.
+
+.SH BUGS
+Probably, but let's hope not.  If you find any, please file them in the
+bug database at http://slapi-nis.fedorahosted.org/.
+
+.SH AUTHOR
+Nalin Dahyabhai <nalin@redhat.com>
-- 
cgit