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>

1 files changed, 0 insertions, 207 deletions

diff --git a/pam_cifscreds.8 b/pam_cifscreds.8
deleted file mode 100644
index 619cc7c..0000000
--- a/pam_cifscreds.8
+++ /dev/null
@@ -1,207 +0,0 @@
-.\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28)
-.\"
-.\" Standard preamble:
-.\" ========================================================================
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Vb \" Begin verbatim text
-.ft CW
-.nf
-.ne \\$1
-..
-.de Ve \" End verbatim text
-.ft R
-.fi
-..
-.\" Set up some character translations and predefined strings.  \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
-.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
-.ie n \{\
-.    ds -- \(*W-
-.    ds PI pi
-.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
-.    ds L" ""
-.    ds R" ""
-.    ds C` ""
-.    ds C' ""
-'br\}
-.el\{\
-.    ds -- \|\(em\|
-.    ds PI \(*p
-.    ds L" ``
-.    ds R" ''
-.    ds C`
-.    ds C'
-'br\}
-.\"
-.\" Escape single quotes in literal strings from groff's Unicode transform.
-.ie \n(.g .ds Aq \(aq
-.el       .ds Aq '
-.\"
-.\" If the F register is turned on, we'll generate index entries on stderr for
-.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
-.\" entries marked with X<> in POD.  Of course, you'll have to process the
-.\" output yourself in some meaningful fashion.
-.\"
-.\" Avoid warning from groff about undefined register 'F'.
-.de IX
-..
-.nr rF 0
-.if \n(.g .if rF .nr rF 1
-.if (\n(rF:(\n(.g==0)) \{
-.    if \nF \{
-.        de IX
-.        tm Index:\\$1\t\\n%\t"\\$2"
-..
-.        if !\nF==2 \{
-.            nr % 0
-.            nr F 2
-.        \}
-.    \}
-.\}
-.rr rF
-.\"
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
-.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
-.    \" fudge factors for nroff and troff
-.if n \{\
-.    ds #H 0
-.    ds #V .8m
-.    ds #F .3m
-.    ds #[ \f1
-.    ds #] \fP
-.\}
-.if t \{\
-.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
-.    ds #V .6m
-.    ds #F 0
-.    ds #[ \&
-.    ds #] \&
-.\}
-.    \" simple accents for nroff and troff
-.if n \{\
-.    ds ' \&
-.    ds ` \&
-.    ds ^ \&
-.    ds , \&
-.    ds ~ ~
-.    ds /
-.\}
-.if t \{\
-.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
-.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
-.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
-.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
-.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
-.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
-.\}
-.    \" troff and (daisy-wheel) nroff accents
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
-.ds ae a\h'-(\w'a'u*4/10)'e
-.ds Ae A\h'-(\w'A'u*4/10)'E
-.    \" corrections for vroff
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
-.    \" for low resolution devices (crt and lpr)
-.if \n(.H>23 .if \n(.V>19 \
-\{\
-.    ds : e
-.    ds 8 ss
-.    ds o a
-.    ds d- d\h'-1'\(ga
-.    ds D- D\h'-1'\(hy
-.    ds th \o'bp'
-.    ds Th \o'LP'
-.    ds ae ae
-.    ds Ae AE
-.\}
-.rm #[ #] #H #V #F C
-.\" ========================================================================
-.\"
-.IX Title "PAM_CIFSCREDS 8"
-.TH PAM_CIFSCREDS 8 "2013-12-13" "" ""
-.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
-.\" way too many mistakes in technical documents.
-.if n .ad l
-.nh
-.SH "NAME"
-pam_cifscreds \- PAM module to manage NTLM credentials in kernel keyring
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-Edit the \s-1PAM\s0 configuration files for the systems that you want to
-automatically register \s-1NTLM\s0 credentials for, e.g. /etc/pam.d/login,
-and modify as follows:
-.PP
-.Vb 5
-\&        ...
-\&        auth       substack     system\-auth
-\&    +++ auth       optional     pam_cifscreds.so
-\&        auth       include      postlogin
-\&        ...
-\&
-\&        ...
-\&        session    include      system\-auth
-\&    +++ session    optional     pam_cifscreds.so domain=DOMAIN
-\&        session    include      postlogin
-\&        ...
-.Ve
-.PP
-Change \s-1DOMAIN\s0 to the name of you Windows domain, or use host= as
-described below.
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The \fBpam_cifscreds\fR \s-1PAM\s0 module is a tool for automatically adding
-credentials (username and password) for the purpose of establishing
-sessions in multiuser mounts.
-.PP
-When a cifs filesystem is mounted with the \*(L"multiuser\*(R" option, and does
-not use krb5 authentication, it needs to be able to get the credentials
-for each user from somewhere. The \fBpam_cifscreds\fR module can be used
-to provide these credentials to the kernel automatically at login.
-.PP
-In the session section of the \s-1PAM\s0 configuration file, the module can
-either an \s-1NT\s0 domain name or a list of hostname or addresses.
-.SH "OPTIONS"
-.IX Header "OPTIONS"
-\&\fBpam_cifscreds\fR supports a couple options which can be set in the \s-1PAM\s0
-configuration files.  You must have one (and only one) of domain= or
-host=.
-.IP "\fBdebug\fR" 4
-.IX Item "debug"
-Turns on some extra debug logging.
-.IP "\fBdomain\fR=<\s-1NT\s0 domain name>" 4
-.IX Item "domain=<NT domain name>"
-Credentials will be added for the specified \s-1NT\s0 domain name.
-.IP "\fBhost\fR=<hostname or \s-1IP\s0 address>[,...]" 4
-.IX Item "host=<hostname or IP address>[,...]"
-Credentials will be added for the specified hostnames or \s-1IP\s0 addresses.
-.SH "NOTES"
-.IX Header "NOTES"
-The pam_cifscreds \s-1PAM\s0 module requires a kernel built with support for
-the \fBlogin\fR key type. That key type was added in v3.3 in mainline Linux
-kernels.
-.PP
-Since \fBpam_cifscreds\fR adds keys to the session keyring, it is highly
-recommended that one use \fBpam_keyinit\fR to ensure that a session keyring
-is established at login time.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fIcifscreds\fR\|(1), \fIpam_keyinit\fR\|(8)
-.SH "AUTHOR"
-.IX Header "AUTHOR"
-The pam_cifscreds \s-1PAM\s0 module was developed by Orion Poplawski
-<orion@nwra.com>.