summaryrefslogtreecommitdiff
path: root/idmapwb.pod
diff options
context:
space:
mode:
authorAurelien Aptel <aaptel@suse.com>2017-09-29 16:03:03 +0200
committerJeff Layton <jlayton@samba.org>2017-10-03 06:32:08 -0400
commitd999610bf985f19fcc1984be95f11da7a3e88533 (patch)
treec93b2baeb09842266ba79f1d99f4a0943cde7fbd /idmapwb.pod
parent48d88f946e72a3a8618498524e61f9053bb565f4 (diff)
downloadcifs-utils-d999610bf985f19fcc1984be95f11da7a3e88533.tar.gz
cifs-utils-d999610bf985f19fcc1984be95f11da7a3e88533.tar.bz2
cifs-utils-d999610bf985f19fcc1984be95f11da7a3e88533.zip
man: generate all man pages from POD files when buidling
Move all man pages to easily editable POD files and generate troff source when building. Previous .in troff file are still preprocessed before final generation to use configured path (.pod.in -> .pod -> troff). All temporary files (.pod.in and troff sources) are properly deleted on clean. Remove all troff file, no need to keep generated copies under source control. This commit does not change the content of the man pages but makes future editing easier. Adds a new --enable-man/--disable-man configure option to control the generation and installation of man pages. The option is automatically enabled if the system supports it. Explicitly enabling it will make the configure script fail if pod2man is not installed. Signed-off-by: Aurelien Aptel <aaptel@suse.com>
Diffstat (limited to 'idmapwb.pod')
-rw-r--r--idmapwb.pod26
1 files changed, 0 insertions, 26 deletions
diff --git a/idmapwb.pod b/idmapwb.pod
deleted file mode 100644
index 4cc2b5a..0000000
--- a/idmapwb.pod
+++ /dev/null
@@ -1,26 +0,0 @@
-# turn into a manpage with the following command:
-#
-# pod2man -s 8 -c '' -r '' --stderr idmapwb.pod > idmapwb.8.in
-#
-
-=head1 NAME
-
-idmapwb.so - winbind ID mapping plugin for cifs-utils
-
-=head1 DESCRIPTION
-
-This plugin allows the utilities in cifs-utils to work in conjuction with
-the winbind facility of Samba suite. It handles several functions including
-mapping UID and GID to SIDs and vice versa.
-
-Utilities are usually configured to use the correct plugin by creating a
-symlink at @pluginpath@ that points to the correct plugin that you wish
-to use.
-
-This plugin requires that B<winbindd(8)> be properly configured and running.
-
-=head1 SEE ALSO
-getcifsacl(1), setcifsacl(1), cifs.idmap(8), samba(7), smb.conf(5), winbindd(8)
-
-=head1 AUTHOR
-idmapwb.so was written by Jeff Layton <jlayton@samba.org>