-.TH mlmmj-bounce "1" "September 2004" mlmmj-bounce
-.SH NAME
-mlmmj-bounce \- bounce handling utility for mlmmj
-.SH SYNOPSIS
-.B mlmmj-bounce
-\fI\-L /path/to/list \fR[\fI\-a john=doe.org | \-d\fR]\fI \fR[\fI\-n num | \-p\fR]
-.HP
-\fB\-a\fR: Address string that bounces
-.HP
-\fB\-d\fR: Parse the mail to extract the address via the DSN (RFC1891)
-.HP
-\fB\-h\fR: This help
-.HP
-\fB\-L\fR: Full path to list directory
-.HP
-\fB\-n\fR: Message number in the archive that bounced
-.HP
-\fB\-p\fR: Send out a probe
-.HP
-\fB\-V\fR: Print version
-.SH DESCRIPTION
-mlmmj-bounce is used to handle mails that are bouncing. When a mail arrives to
-the system, mlmmj-bounce will register in <listdir>/bounce/<addrstring> info
-about which number that bounced at what time. An example of such a line could
-be:
-.LP
+.Dd September 1, 2004
+.Dt mlmmj-bounce 1
+.Os
+.Sh NAME
+.Nm mlmmj-bounce
+.Nd bounce handling utility for mlmmj
+.Sh SYNOPSIS
+.Nm
+.Fl -L Ar /path/to/list
+.Op Fl a Ar john=doe.org | Fl d
+.Op Fl n Ar num | Fl p
+.Sh DESCRIPTION
+.Bl -tag -width pathXXX
+.It Fl a
+Address string that bounces
+.It Fl d
+Parse the mail to extract the address via the DSN
+.Pq RFC1891
+.It Fl h
+Print help
+.It Fl L Ar path
+Full path to list directory
+.It Fl n
+Message number in the archive that bounced
+.It Fl p
+Send out a probe
+.It Fl V
+Print version
+.El
+.Pp
+.Nm
+is used to handle mails that are bouncing.
+When a mail arrives to the system, mlmmj-bounce will register in
+.Pa <listdir>/bounce/<addrstring>
+info about which number that bounced at what time.
+An example of such a line could be:
+.Bd -literal -offset indent
109:1094409801 # Sun Sep 5 20:43:21 2004
-
+.Ed
+.Pp
The above shows that message number 109 bounced 1094409801 seconds after epoch
which is in human date stamps is Sunday September 5th 20:43:21 2004.
-
-The last bounce mail received to the address is saved in <listdir>/bounce/<addrstring>.lastmsg.
-
-When the \fB\-p\fR option is used it sends out a probe email including info
-that it's a bounce probe and a list of the bounced message numbers. The
-existance of a <listdir>/bounce/<addrstring>.probe file indicates that a probe have been sent out.
-.SH AUTHORS
+.Pp
+The last bounce mail received to the address is saved in
+.Pa <listdir>/bounce/<addrstring>.lastmsg .
+.Pp
+When the
+.Fl p
+option is used it sends out a probe email including info
+that it's a bounce probe and a list of the bounced message numbers.
+The existance of a
+.Pa <listdir>/bounce/<addrstring>.probe
+file indicates that a probe have been sent out.
+.Sh AUTHORS
This manual page was written by the following persons:
-.HP
-S\[/o]ren Boll Overgaard <boll@debian.org> (based on html2man output)
-.HP
-Mads Martin J\[/o]rgensen <mmj@mmj.dk>
+.An S\[/o]ren Boll Overgaard Aq Mt boll@debian.org
+(based on html2man output)
+.An Mads Martin J\[/o]rgensen Aq Mt mmj@mmj.dk
.Dt mlmmj-list "1"
.Os
.Sh NAME
-.Nm "mlmmj-list
+.Nm mlmmj-list
.Nd list people / subscribers associated with a list
.Sh SYNOPSIS
.Nm
-.Op Fl L Ar /path/to/listdir
+.Fl L Ar /path/to/listdir
.Op Fl cdhmosV
.Sh DESCRIPTION
.Bl -tag -width pathXXX
-.TH mlmmj-maintd "1" "September 2004" mlmmj-maintd
-.SH NAME
-mlmmj-maintd \- maintenance for mlmmj maintained lists
-.SH SYNOPSIS
-.B mlmmj-maintd
-[\fI\-F\fR] \fI[\-d\fR | \fI\-L\fR] /path/to/dir
-.HP
-\fB\-d\fR: Full path to directory with lists
-.HP
-\fB\-L\fR: Full path to list directory
-.HP
-\fB\-F\fR: Don't fork, performing one maintenance run only.
-.SH DESCRIPTION
-This is the program doing the maintenance for an mlmmj based mailing list. It
-will unsubscribe people who have bounced for long enough, send out bounce
+.Dd September 1, 2004
+.Dt mlmmj-maintd 1
+.Os
+.Sh NAME
+.Nm mlmmj-maintd
+.Nd maintenance for mlmmj maintained lists
+.Sh SYNOPSIS
+.Nm
+.Op Fl F
+.Op Fl d Ar /path/to/dir | Fl L Ar /path/to/dir
+.Sh DESCRIPTION
+.Bl -tag -width pathXXXXX
+.It Fl d Ar <path>
+Full path to directory with lists
+.It Fl L Ar <path>
+Full path to list directory
+.It Fl F
+Don't fork, performing one maintenance run only.
+.El
+.Pp
+This is the program doing the maintenance for an mlmmj based mailing list.
+It will unsubscribe people who have bounced for long enough, send out bounce
probes, resend mails that couldn't be delivered to relayhost, clean out stale
requests for e.g. subscription, resend list mails and clean up leftover files
etc.
-
-If a directory containing several lists exists, the \fB\-d\fR can be used to
+.Pp
+If a directory containing several lists exists, the
+.Fl d
+can be used to
specify this, making mlmmj-maintd perform a maintenance run in every listdir
below the specified one.
-
-Only either \fB\-d\fR or \fB\-L\fR can be specified at the same time.
-
-It will run as a daemon, unless the \fB\-F\fR switch is specified, in which
-case it just runs once. The \fB\-F\fR option should be used when one wants to
-avoid running another daemon, and use e.g. cron to control it instead. In case
-cron is used, mlmmj-maintd should be run every 2 hours or so. An example
-crontab entry:
-
-.LP
+.Pp
+Only either
+.Fl d
+or
+.Fl L
+can be specified at the same time.
+.Pp
+It will run as a daemon, unless the
+.Fl F
+switch is specified, in which case it just runs once.
+The
+.Fl F
+option should be used when one wants to
+avoid running another daemon, and use e.g. cron to control it instead.
+In case cron is used,
+.Nm
+should be run every 2 hours or so.
+An example crontab entry:
+.Bd -literal -offset indent
0 */2 * * * /usr/bin/mlmmj-maintd \-F \-L /path/to/list
-.SH AUTHORS
+.Ed
+.Sh AUTHORS
This manual page was written by the following persons:
-.HP
-S\[/o]ren Boll Overgaard <boll@debian.org> (based on html2man output)
-.HP
-Mads Martin J\[/o]rgensen <mmj@mmj.dk>
+.An S\[/o]ren Boll Overgaard Aq Mt boll@debian.org
+.Pq based on html2man output
+.An Mads Martin J\[/o]rgensen Aq Mt mmj@mmj.dk
-.TH mlmmj-make-ml "1" "September 2004" mlmmj-make-ml
-.SH NAME
-mlmmj-make-ml \- create a mailing list for mlmmj
-.SH SYNOPSIS
-.B mlmmj-make-ml
-[\fI\-h\fR] [\fI\-L listname\fR] [\fI\-s spooldir\fR] [\fI\-a\fR] [\fI\-c user\fR] [\fI\-z\fR]
-.HP
-\fB\-h\fR: Display help
-.HP
-\fB\-L\fR: The name of the mailing list
-.HP
-\fB\-s\fR: Your spool directory (default /var/spool/mlmmj)
-.HP
-\fB\-a\fR: Create the needed entries in your /etc/aliases file
-.HP
-\fB\-c\fR: User to chown the spool directory to (default not to chown at all)
-.HP
-\fB\-z\fR: Do nothing for now
-.SH DESCRIPTION
+.Dd September 1, 2004
+.Dt mlmmj-make-ml 1
+.Os
+.Sh NAME
+.Nm mlmmj-make-ml
+.Nd create a mailing list for mlmmj
+.Sh SYNOPSIS
+.Nm
+.Op Fl h
+.Op Fl L Ar listname
+.Op Fl s Ar spooldir
+.Op Fl a
+.Op Fl user
+.Op Fl z
+.Sh DESCRIPTION
+.Bl -tag -width pathXXXXXXX
+.It Fl h
+Display help
+.It Fl L Ar listname
+The name of the mailing list
+.It Fl s Ar spooldir
+Your spool directory
+.Po
+default
+.Pa /var/spool/mlmmj
+.Pc
+.It Fl a
+Create the needed entries in your
+.Pa /etc/aliases
+file
+.It Fl c
+User to chown the spool directory to
+.Pq default not to chown at all
+.It Fl z
+Do nothing for now
+.El
+.Pp
This is an interactive script which creates the mailing list directory and thus
the list itself for being run by mlmmj.
-.SH BUGS
-It's not possible to create a list entirely on the command line.
-.SH AUTHORS
+.Sh AUTHORS
This manual page was written by the following persons:
-.HP
-S\[/o]ren Boll Overgaard <boll@debian.org> (based on html2man output)
-.HP
-Mads Martin J\[/o]rgensen <mmj@mmj.dk>
+.An S\[/o]ren Boll Overgaard Aq Mt boll@debian.org
+.Pq based on html2man output
+.An Mads Martin J\[/o]rgensen Aq Mt mmj@mmj.dk
+.Sh BUGS
+It's not possible to create a list entirely on the command line.
-.TH mlmmj-process "1" "September 2004" mlmmj-process
-.SH NAME
-mlmmj-process \- process mail for an mlmmj managed mailinglist
-.SH SYNOPSIS
-.B mlmmj-process
-\fI\-L /path/to/list \-m /path/to/mail \fR[\fI\-h\fR] [\fI\-P\fR] [\fI\-V\fR]
-.HP
-\fB\-h\fR: This help
-.HP
-\fB\-L\fR: Full path to list directory
-.HP
-\fB\-m\fR: Full path to mail file
-.HP
-\fB\-P\fR: Don't execute mlmmj-send (debugging only)
-.HP
-\fB\-V\fR: Print version
-.SH DESCRIPTION
-This is the binary which processes a mail. Examples of what such processing
-is:
-.RS 0
-.IP \(bu 4
-.B
-Access control
-
-Using the access rules specified in <listdir>/control/access to perform access
-control to the list. This is done before headers are stripped, so one can
-create allow rules based on headers that are later stripped.
-.IP \(bu 4
-.B
-Header stripping
-
-Headers specified in <listdir>/control/delheaders are deleted from the mail.
-.IP \(bu 4
-.B
-Header addition
-
-Headers specified in <listdir>/control/customheaders are added to the mail.
-This could be headers like List-ID: or Reply-To:
-.IP \(bu 4
-.B
-List control
-
+.Dd September 1, 2004
+.Dt mlmmj-process 1
+.Os
+.Sh NAME
+.Nm mlmmj-process
+.Nd process mail for an mlmmj managed mailinglist
+.Sh SYNOPSIS
+.Nm
+.Fl Ar /path/to/list
+.Fl m /path/to/mail
+.Op Fl h
+.Op Fl P
+.Op Fl V
+.Sh DESCRIPTION
+.Bl -tag -width pathXXX
+.It Fl h
+Print help
+.It Fl L Ar path
+Full path to list directory
+.It Fl m Ar mail
+Full path to mail file
+.It Fl P
+Don't execute mlmmj-send
+.Pq debugging only
+.It Fl V
+Print version
+.El
+.Pp
+This is the binary which processes a mail.
+Examples of what such processing is:
+.Bl -tag -width 6n
+.It Access control
+Using the access rules specified in
+.Pa <listdir>/control/access
+to perform access control to the list.
+This is done before headers are stripped, so one can create allow rules based
+on headers that are later stripped.
+.It Header stripping
+Headers specified in
+.Pa <listdir>/control/delheaders
+are deleted from the mail.
+.It Header addition
+Headers specified in
+.Pa <listdir>/control/customheaders
+are added to the mail.
+This could be headers like
+.Qq List-ID:
+or
+.Qq Reply-To:
+.It List control
In case there's a mail with a recipient delimiter it's not a regular list mail.
-Processing of these happens in mlmmj-receive as well. Examples of such are
-subscription requests, mails to owner etc.
-It will base it's recipient delimiter detection on the Delivered-To: header if
-present. If not, the To: header is used.
-.IP \(bu 4
-.B
-Moderation
-
+Processing of these happens in mlmmj-receive as well.
+.Pp
+Examples of such are: subscription requests, mails to owner etc.
+.Pp
+It will base it's recipient delimiter detection on the
+.Qq Delivered-To:
+header if present. If not, the
+.Qq To:
+header is used.
+.It Moderation
If the list is moderated, it will happen in mlmmj-process.
-.RE
-
+.El
+.Pp
When processing is done, it will invoke the needed binary according to whatever
-mail it is. If it's a subscription request it will invoke mlmmj-sub, if it's a
-regular list mail it will invoke mlmmj-send.
-.SH "SEE ALSO"
+mail it is.
+If it's a subscription request it will invoke mlmmj-sub, if it's a regular list
+mail it will invoke
+.Xr mlmmj-send 1 .
+.Sh SEE ALSO
The file TUNABLES from the mlmmj source distribution or in the documentation
directory of the operating system distribution.
-.SH AUTHORS
+.Sh AUTHORS
This manual page was written by the following persons:
-.HP
-S\[/o]ren Boll Overgaard <boll@debian.org> (based on html2man output)
-.HP
-Mads Martin J\[/o]rgensen <mmj@mmj.dk>
+.An S\[/o]ren Boll Overgaard Aq Mt boll@debian.org
+.Pq based on html2man output
+.An Mads Martin J\[/o]rgensen Aq Mt mmj@mmj.dk
-.TH mlmmj-receive "1" "September 2004" mlmmj-receive
-.SH NAME
-mlmmj-receive \- receive mails for an mlmmj managed mailinglist
-.SH SYNOPSIS
-.B mlmmj-receive
-\fI\-L /path/to/listdir \fR[\fI\-h\fR] [\fI\-V\fR] [\fI\-P\fR] [\fI\-F\fR]
-.HP
-\fB\-h\fR: This help
-.HP
-\fB\-F\fR: Don't fork in the background (debugging only)
-.HP
-\fB\-L\fR: Full path to list directory
-.HP
-\fB\-P\fR: Don't execute mlmmj-process (debugging only)
-.HP
-\fB\-V\fR: Print version
-.SH DESCRIPTION
+.Dd September 1, 2004
+.Dt mlmmj-receive 1
+.Os
+.Sh NAME
+.Nm mlmmj-receive
+.Nd receive mails for an mlmmj managed mailinglist
+.Sh SYNOPSIS
+.Nm
+.Fl L Ar /path/to/listdir
+.Op Fl h
+.Op Fl V
+.Op Fl P
+.Op Fl F
+.Sh DESCRIPTION
+.Bl -tag -width pathXXXXX
+.It Fl h
+Print help
+.It Fl F
+Don't fork in the background
+.Qq debugging only
+.It Fl L Ar path
+Full path to list directory
+.It Fl P
+Don't execute
+.Xr mlmmj-process 1
+.Qq debugging only
+.It Fl V
+Print version
+.El
+.Pp
The mlmmj-receive binary is the one specified in the mailserver configuration
-file (aliases file), which writes the mail to the <listdir>/incoming directory
-and invokes mlmmj-process unless the \fB\-P\fR option is specified. On systems
-using mailservers supporting the \fB/etc/aliases\fR file, a line to activate
-an mlmmj managed mailinglist would look like this:
-.LP
+file
+.Pq aliases file ,
+which writes the mail to the
+.Pa <listdir>/incoming directory
+and invokes
+.Xr mlmmj-process 1
+unless the
+.Fl P
+option is specified.
+On systems using mailservers supporting the
+.Pa /etc/aliases
+file, a line to activate an mlmmj managed mailinglist would look like this:
+.Bd -literal -offset indent
list: "|/usr/bin/mlmmj-receive \-L /var/spool/mlmmj/list/"
-
+.Ed
+.Pp
It's very important to specify the full path to the binary, or the mailinglist
will not function.
-
-When the \fB\-F\fR option is used, it will not fork in the background. The
-reason it forks is that if delivery of a mail takes longer time than the mail
-server will allow a command to be idle before presumed dead, the mail server
-would kill it.
-
-.SH "SEE ALSO"
-mlmmj-process(1)
-.SH AUTHORS
+.Pp
+When the
+.Fl F
+option is used, it will not fork in the background.
+The reason it forks is that if delivery of a mail takes longer time than the
+mail server will allow a command to be idle before presumed dead, the mail
+server would kill it.
+.Sh SEE ALSO
+.Xr mlmmj-process 1
+.Sh AUTHORS
This manual page was written by the following persons:
-.HP
-S\[/o]ren Boll Overgaard <boll@debian.org> (based on html2man output)
-.HP
-Mads Martin J\[/o]rgensen <mmj@mmj.dk>
+.An S\[/o]ren Boll Overgaard Aq Mt boll@debian.org
+.Pq based on html2man output
+.An Mads Martin J\[/o]rgensen Aq Mt mmj@mmj.dk
-.TH mlmmj-send "1" "January 2010" mlmmj-send
-.SH NAME
-mlmmj-send \- send mail to a mailinglist or similar
-.SH SYNOPSIS
-.B mlmmj-send
-[\fI\-L\fR /path/to/list | \fI\-l\fR listctrl] \fI\-m\fR /path/to/mail
-[\fI\-a\fR] [\fI\-D\fR] [\fI\-F\fR] [\fI\-h\fR] [\fI\-o\fR] [\fI\-r\fR] [\fI\-R\fR]
-[\fI\-s\fR] [\fI\-T\fR] [\fI\-V\fR]
-.HP
-\fB\-a\fR: Don't archive the mail
-.HP
-\fB\-D\fR: Don't delete the mail after it's sent
-.HP
-\fB\-F\fR: What to use as MAIL FROM:
-.HP
-\fB\-h\fR: This help
-.HP
-\fB\-l\fR: List control variable.
-.HP
-\fB\-L\fR: Full path to list directory
-.HP
-\fB\-m\fR: Full path to mail file
-.HP
-\fB\-o\fR: Address to omit from distribution (normal mail only)
-.HP
-\fB\-r\fR: Relayhost IP address (defaults to 127.0.0.1)
-.HP
-\fB\-R\fR: What to use as Reply-To: header
-.HP
-\fB\-s\fR: Subscribers file name
-.HP
-\fB\-T\fR: What to use as RCPT TO:
-.HP
-\fB\-V\fR: Print version
-.SH DESCRIPTION
+.Dd September 1, 2004
+.Dt mlmmj-send 1
+.Os
+.Sh NAME
+.Nm mlmmj-send
+.Nd send mail to a mailinglist or similar
+.Sh SYNOPSIS
+.Nm
+.Op Fl L Ar /path/to/list | Fl l Ar listctrl
+.Fl m Ar mail
+.Op Fl aDFhorsTV
+.Sh DESCRIPTION
+.Bl -tag -width pathXXXXX
+.It Fl a
+Don't archive the mail
+.It Fl D
+Don't delete the mail after it's sent
+.It Fl F
+What to use as MAIL FROM:
+.It Fl h
+Print help
+.It Fl l
+List control variable.
+.It Fl L path
+Full path to list directory
+.It Fl m
+Full path to mail file
+.It Fl o
+Address to omit from distribution
+.Pq normal mail only
+.It Fl r
+Relayhost IP address
+.Pq defaults to 127.0.0.1
+.It Fl R
+What to use as
+.Qq Reply-To:
+header
+.It Fl s
+Subscribers file name
+.It Fl T
+What to use as RCPT TO:
+.It Fl V
+Print version
+.El
+.Pp
This binary is used to send all kinds of mail to mlmmj managed mailinglists,
but can potentially be used standalone for sending mails.
-
-The only option that is not self explanatory is the \fB\-l\fR list control
-option:
-.IP
-\&'1' means 'send a single mail'
-
+.Pp
+The only option that is not self explanatory is the
+.Fl l list control option:
+.Bl -tag -width 1 -offset indent
+.It Ar 1
+send a single mail.
+.Pp
This is used together with \fB\-F\fR and \fB\-T\fR to send one mail to one
recipient.
-
-\&'2' means 'mail to moderators'
-
+.It Ar 2
+mail to moderators.
+.Pp
Used for sending mails to the moderators of a list.
-
-\&'3' means 'resend failed list mail'
-
-\&'4' means 'send to file with recipients'
-
-\&'5' means 'bounceprobe'
-
-\&'6' means 'single listmail to single recipient'
-
-.SH BUGS
-This manual page is very scarce documentation of the mlmmj-send binary. The
-reason for this is that it's really not supposed to be used by any human, but
-only supposed to be invoked from other mlmmj binaries. So in case more
-documentation is needed, please read the source.
-.SH AUTHORS
+.It Ar 3
+resend failed list mail
+.It Ar 4
+send to file with recipients
+.It Ar 5
+bounceprobe
+.It Ar 6
+single listmail to single recipient
+.El
+.Sh AUTHORS
This manual page was written by the following persons:
-.HP
-S\[/o]ren Boll Overgaard <boll@debian.org> (based on html2man output)
-.HP
-Mads Martin J\[/o]rgensen <mmj@mmj.dk>
+.An S\[/o]ren Boll Overgaard Aq Mt boll@debian.org
+.Pq based on html2man output
+.An Mads Martin J\[/o]rgensen Aq Mt mmj@mmj.dk
+.Sh BUGS
+This manual page is very scarce documentation of the mlmmj-send binary.
+The reason for this is that it's really not supposed to be used by any human,
+but only supposed to be invoked from other mlmmj binaries.
+So in case more documentation is needed, please read the source.
-.TH mlmmj-sub "1" "January 2010" mlmmj-sub
-.SH NAME
-mlmmj-sub \- subscribe address to a mailinglist run by mlmmj
-.SH SYNOPSIS
-.B mlmmj-sub
-\fI\-L /path/to/list\fR [\fI\-a john@doe.org\fR | \fI\-m str\fR]
-[\fI\-c\fR] [\fI\-C\fR] [\fI\-d\fR | \fI\-n\fR] [\fI\-f\fR] [\fI\-h\fR] [\fI\-q\fR] \fR[\fI\-r\fR | \fI\-R\fR] [\fI\-s\fR] [\fI\-U\fR] [\fI\-V\fR]
-.HP
-\fB\-a\fR: Email address to subscribe
-.HP
-\fB\-c\fR: Send welcome mail (unless requesting confirmation)
-.HP
-\fB\-C\fR: Request mail confirmation (unless switching versions)
-.HP
-\fB\-d\fR: Subscribe to digest version of the list
-.HP
-\fB\-f\fR: Force subscription (do not moderate)
-.HP
-\fB\-h\fR: This help
-.HP
-\fB\-L\fR: Full path to list directory
-.HP
-\fB\-m\fR: Moderation string
-.HP
-\fB\-n\fR: Subscribe to nomail version of the list
-.HP
-\fB\-q\fR: Be quiet (don't notify owner about the subscription)
-.HP
-\fB\-r\fR: Behave as if request arrived via email (internal use)
-.HP
-\fB\-R\fR: Behave as if confirmation arrived via email (internal use)
-.HP
-\fB\-s\fR: Don't send a mail to the subscriber if already subscribed
-.HP
-\fB\-U\fR: Don't switch to the user id of the listdir owner
-.HP
-\fB\-V\fR: Print version
-.SH DESCRIPTION
-This utility is used to subscribe people to the specified mailinglist. It will
-write the email address in a file with the name of the beginning letter of the
-email address getting subscribed in the <listdir>/subscribers.d/ directory.
-
+.Dd September 1, 2004
+.Dt mlmmj-sub 1
+.Os
+.Sh NAME
+.Nm mlmmj-sub
+.Nd subscribe address to a mailinglist run by mlmmj
+.Sh SYNOPSIS
+.Nm
+.Fl L Ar /path/to/list
+.Op Fl a Ar john@doe.org | Fl m Ar str
+.Op Fl cCdnfhqrRsUV
+.Sh DESCRIPTION
+.Bl -tag -width pathXXX
+.It Fl a Ar email
+Email address to subscribe
+.It Fl c
+Send welcome mail
+.Pq unless requesting confirmation
+.It Fl C
+Request mail confirmation
+.Pq unless switching versions
+.It Fl d
+Subscribe to digest version of the list
+.It Fl f
+Force subscription
+.Pq do not moderate
+.It Fl h
+Print help
+.It Fl L Ar path
+Full path to list directory
+.It Fl m Ar str
+Moderation string
+.It Fl n
+Subscribe to nomail version of the list
+.It Fl q
+Be quiet
+.Pq don't notify owner about the subscription
+.It Fl r
+Behave as if request arrived via email
+.Pq internal use
+.It Fl R
+Behave as if confirmation arrived via email
+.Pq internal use
+.It Fl s
+Don't send a mail to the subscriber if already subscribed
+.It Fl U
+Don't switch to the user id of the listdir owner
+.It Fl V
+Print version
+.El
+.Pp
+This utility is used to subscribe people to the specified mailinglist.
+It will write the email address in a file with the name of the beginning letter
+of the email address getting subscribed in the
+.Pa <listdir>/subscribers.d/
+directory.
+.Pp
The digest version of the list is a list version where people receive postings
-to the list periodically (e.g. once a day) or when a large number of posts have
-accumulated. Digest subscribers are in the <listdir>/digesters.d/ directory.
-
+to the list periodically
+.Pq e.g. once a day
+or when a large number of posts have accumulated.
+Digest subscribers are in the
+.Pa <listdir>/digesters.d/
+directory.
+.Pp
The nomail version of the list is a list version where people are subscribed
-like usual, but they won't receive any postings to the list. This is useful for
+like usual, but they won't receive any postings to the list.
+This is useful for
people who read the mailinglist through a news gateway, but want to be able to
-post to the list. Nomail subscribers are in the <listdir>/nomailsubs.d/
+post to the list.
+Nomail subscribers are in the
+.Pa <listdir>/nomailsubs.d/
+directory.
+.Pp
+Unless the
+.Fl U
+switch is used it will switch its user id to the user id owning the list
directory.
-
-Unless the \fB\-U\fR switch is used it will switch its user id to the user id
-owning the list directory. This is done to make sure that new files created are
-having correct permissions.
-
+This is done to make sure that new files created are having correct permissions.
+.Pp
If the given address is already subscribed to the list, but to a different
version, the subscription is switched to that version, and confirmation and
-moderation are bypassed. If the address is already subscribed to the version
-requested, a mail is sent to the subscriber, unless the \fB\-s\fR switch is
-used.
-
-Subscription may be moderated (if <listdir>/control/submod exists) unless the
-\fB\-f\fR switch is given. When a subscription is permitted by a gatekeeper,
-welcome messages are sent to the subscriber as usual, regardless of options
-given now.
-
+moderation are bypassed.
+If the address is already subscribed to the version requested, a mail is sent
+to the subscriber, unless the
+.Fl s
+switch is used.
+.Pp
+Subscription may be moderated
+.Po if
+.Pa <listdir>/control/submod exists
+.Pc
+unless the
+.Fl f
+switch is given.
+When a subscription is permitted by a gatekeeper, welcome messages are sent to
+the subscriber as usual, regardless of options given now.
+.Pp
To ensure subscription is silent from the point of view of the subscriber, use
-\fB\-f\fR, but neither \fB\-c\fR nor \fB\-C\fR. To inhibit notification of the
-owner, use \fB\-q\fR. Use of \fB\-s\fR is recommended to ensure you don't spam
-already-subscribed addresses by accident.
-.SH "SEE ALSO"
-mlmmj-unsub(1), setuid(2)
-.SH AUTHORS
+.Fl f ,
+but neither
+.Fl c
+nor
+.Fl C .
+To inhibit notification of the owner, use
+.Fl q .
+Use of
+.Fl s
+is recommended to ensure you don't spam already-subscribed addresses by
+accident.
+.Sh "SEE ALSO"
+.Xr mlmmj-unsub 1 ,
+.Xr setuid 2
+.Sh AUTHORS
This manual page was written by the following persons:
-.HP
-S\[/o]ren Boll Overgaard <boll@debian.org> (based on html2man output)
-.HP
-Mads Martin J\[/o]rgensen <mmj@mmj.dk>
+.An S\[/o]ren Boll Overgaard Aq Mt boll@debian.org
+.Pq based on html2man output
+.An Mads Martin J\[/o]rgensen Aq Mt mmj@mmj.dk
-.TH mlmmj-unsub "1" "September 2004" mlmmj-unsub
-.SH NAME
-mlmmj-unsub \- unsubscribe address from a mailinglist run by mlmmj
-.SH SYNOPSIS
-.B mlmmj-unsub
-\fI\-L /path/to/list \-a john@doe.org\fR [\fI\-c\fR | \fI\-C\fR]
-[\fI\-d\fR | \fI\-n\fR | \fI\-N\fR] [\fI\-h\fR] [\fI\-q\fR] [\fI\-r\fR | \fI\-R\fR] [\fI\-s\fR] [\fI\-U\fR] [\fI\-V\fR]
-.HP
-\fB\-a\fR: Email address to unsubscribe
-.HP
-\fB\-c\fR: Send goodbye mail
-.HP
-\fB\-C\fR: Request mail confirmation
-.HP
-\fB\-d\fR: Unsubscribe from the digest version of the list
-.HP
-\fB\-h\fR: This help
-.HP
-\fB\-L\fR: Full path to list directory
-.HP
-\fB\-n\fR: Unsubscribe from the nomail version of the list
-.HP
-\fB\-N\fR: Unsubscribe from the normal version of the list
-.HP
-\fB\-q\fR: Be quiet (don't notify owner about the unsubscribe)
-.HP
-\fB\-r\fR: Behave as if request arrived via email (internal use)
-.HP
-\fB\-R\fR: Behave as if confirmation arrived via email (internal use)
-.HP
-\fB\-s\fR: Don't send a mail to the address if not subscribed
-.HP
-\fB\-U\fR: Don't switch to the user id of the listdir owner
-.HP
-\fB\-V\fR: Print version
-.SH DESCRIPTION
-This utility is used to unsubscribe people from the specified mailinglist. It
-will remove the specified email address from every file in the
-<listdir>/subscribers.d/, <listdir>/digesters.d/ and <listdir>/nomailsubs.d/
-directories (or if the \-d, \-n or \-N switch is given, only the one relevant
-directory).
-
-Unless the \fB\-U\fR switch is used it will switch its user id to the user id
-owning the list directory. This is done to make sure that new files created are
-having correct permissions.
-
+.Dd September 1, 2004
+.Dt mlmmj-unsub 1
+.Os
+.Sh NAME
+.Nm mlmmj-unsub
+.Nd unsubscribe address from a mailinglist run by mlmmj
+.Sh SYNOPSIS
+.Nm
+.Fl L Ar /path/to/list
+.Fl a Ar john@doe.org
+.Op Fl cCdnNhqrRsUV
+.Sh DESCRIPTION
+.Bl -tag -width pathXXX
+.It Fl a Ar email
+Email address to unsubscribe
+.It Fl c
+Send goodbye mail
+.It Fl C
+Request mail confirmation
+.It Fl d
+Unsubscribe from the digest version of the list
+.It Fl h
+Print help
+.It Fl L Ar path
+Full path to list directory
+.It Fl n
+Unsubscribe from the nomail version of the list
+.It Fl N
+Unsubscribe from the normal version of the list
+.It Fl q
+Be quiet
+.Pq don't notify owner about the unsubscribe
+.It Fl r
+Behave as if request arrived via email
+.Pq internal use
+.It Fl R
+Behave as if confirmation arrived via email
+.Pq internal use
+.It Fl s
+Don't send a mail to the address if not subscribed
+.It Fl U
+Don't switch to the user id of the listdir owner
+.It Fl V
+Print version
+.El
+.Pp
+This utility is used to unsubscribe people from the specified mailinglist.
+It will remove the specified email address from every file in the
+.Pa <listdir>/subscribers.d/ ,
+.Pa <listdir>/digesters.d/
+and
+.Pa <listdir>/nomailsubs.d/
+directories
+.Po
+or if the
+.Fl d ,
+.Fl n
+or
+.Fl N
+switch is given, only the one relevant directory
+.Pc .
+.Pp
+Unless the
+.Fl U
+switch is used it will switch its user id to the user id owning the list
+directory.
+This is done to make sure that new files created are having correct
+permissions.
+.Pp
Normally a mail is sent to the person being unsubscribed if the address is not
-subscribed to the list. If the \fB\-s\fR switch is used such a mail will not be
-sent.
-
-When neither \fB\-c\fR nor \fB\-C\fR is specified, unsubscription happens
-silently from the point of view of the subscriber. When \fB\-q\fR is specified,
-unsubscription happens silently from the point of view of the list owner. Use
-of \fB\-s\fR is recommended to ensure you don't spam unsubscribed addresses by
-accident.
-.SH "SEE ALSO"
-mlmmj-sub(1)
-.SH AUTHORS
+subscribed to the list.
+If the
+.Fl s
+switch is used such a mail will not be sent.
+.Pp
+When neither
+.Fl c
+nor
+.Fl C
+is specified, unsubscription happens silently from the point of view of the
+subscriber.
+When
+.Fl q
+is specified, unsubscription happens silently from the point of view of the
+list owner.
+Use of
+.Fl s
+is recommended to ensure you don't spam unsubscribed addresses by accident.
+.Sh SEE ALSO
+.Xr mlmmj-sub 1
+.Sh AUTHORS
This manual page was written by the following persons:
-.HP
-S\[/o]ren Boll Overgaard <boll@debian.org> (based on html2man output)
-.HP
-Mads Martin J\[/o]rgensen <mmj@mmj.dk>
+.An S\[/o]ren Boll Overgaard Aq Mt boll@debian.org
+.Pq based on html2man output
+.An Mads Martin J\[/o]rgensen Aq Mt mmj@mmj.dk
projects / thirdparty / mlmmj.git / commitdiff
