From fb16b58b55d7d072a6666566c5526a271dbbb561 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jos=C3=A9=20Fonseca?= Date: Tue, 24 Jun 2003 15:09:18 +0000 Subject: Beautification of the manpage. Updated the news. --- NEWS | 5 +- esmtp.1 | 303 ++++++++++++++++++++++------------------------------------------ 2 files changed, 104 insertions(+), 204 deletions(-) diff --git a/NEWS b/NEWS index a802cba..80af49a 100644 --- a/NEWS +++ b/NEWS @@ -1,6 +1,7 @@ -Version 0.4 +Version 0.4 (under development) * Debian packaging. + * Fixes to compile on FreeBSD (Tim Hemel). Version 0.3 @@ -8,7 +9,7 @@ Version 0.3 * Capability to generate log files. * Better verbose output. * Minor bug fixes and documentation enhancements. - * Multiple identities. + * Multiple identities (Jerome). Version 0.2: diff --git a/esmtp.1 b/esmtp.1 index 4d46ea5..713b878 100644 --- a/esmtp.1 +++ b/esmtp.1 @@ -11,319 +11,219 @@ .SH NAME esmtp - -.SH SUMMARY +\- libESMTP to Sendmail compatibility interface .SH SYNOPSIS -.B esmtp -.RI "[ " flags " ] [ " address " " ... " ]" -.br +\fBesmtp\fR [\fIflags\fR] [\fIaddress ...\fR] .SH DESCRIPTION -.B Esmtp -is a send-only -.B sendmail -emulator for machines which normally retrieve their mail -up from a centralized mailhub -using programs such as -.B fetchmail . -.PP -.B Esmtp -does not attempt to provide all the functionality of -.B sendmail -: it is intended to be used by other -mail user agents as -.B mutt . +\fBEsmtp\fR is a send-only \fBsendmail\fR emulator for machines which normally +retrieve their mail up from a centralized mailhub using programs such as +\fBfetchmail\fR. + +\fBEsmtp\fR does not attempt to provide all the functionality of +\fBsendmail\fR: it is intended to be used by other mail user agents as +\fBmutt\fR. .SH OPTIONS -Most -.B sendmail -options are irrelevent to -.B esmtp . -Those marked ``ignored'' or ``default'' have no effect on mail transfer. -Those marked ``unsupported'' are fatal errors. +Most \fBsendmail\fR options are irrelevent to \fBesmtp\fR . Those marked +``ignored'' or ``default'' have no effect on mail transfer. Those marked +``unsupported'' are fatal errors. .TP -.B \-Ac -(ignored) -Use submit.cf even if the operation mode does not indicate -an initial mail submission. +\fB\-Ac\fR (ignored) +Use submit.cf even if the operation mode does not indicate an initial mail +submission. .TP -.B \-Am -(ignored) -Use sendmail.cf even if the operation mode indicates -an initial mail submission. +\fB\-Am\fR (ignored) +Use sendmail.cf even if the operation mode indicates an initial mail +submission. .TP -.BI \-B type -(ignored) -Set the body type to -.IR type . -Current legal values are -7BIT -or -8BITMIME. +\fB\-B\fR \fItype\fR (ignored) +Set the body type to \fItype\fR. Current legal values are 7BIT or 8BITMIME. .TP -.B \-ba -(unsupported) -Go into -ARPANET -mode. +\fB\-ba\fR (unsupported) +Go into ARPANET mode. .TP -.B \-bd -(unsupported) +\fB\-bd\fR (unsupported) Run as a daemon. .TP -.B \-bD -(unsupported) -Same as -.B \-bd -except runs in foreground. +\fB\-bD\fR (unsupported) +Same as \fB\-bd\fR except runs in foreground. .TP -.B \-bh -(unsupported) +\fB\-bh\fR (unsupported) Print the persistent host status database. .TP -.B \-bH -(unsupported) +\fB\-bH\fR (unsupported) Purge expired entries from the persistent host status database. .TP -.B \-bi -(ignored) +\fB\-bi\fR (ignored) Initialize the alias database. .TP -.B \-bm -(default) +\fB\-bm\fR (default) Deliver mail in the usual way. .TP -.B \-bp -(unsupported) +\fB\-bp\fR (unsupported) Print a listing of the queue(s). .TP -.B \-bP -(unsupported) -Print number of entries in the queue(s); -only available with shared memory support. +\fB\-bP\fR (unsupported) +Print number of entries in the queue(s); only available with shared memory +support. .TP -.B \-bs -(unsupported) -Use the -SMTP -protocol as described in -RFC821 -on standard input and output. +\fB\-bs\fR (unsupported) +Use the SMTP protocol as described in RFC821 on standard input and output. .TP -.B \-bt -(unsupported) +\fB\-bt\fR (unsupported) Run in address test mode. .TP -.B \-bv -(unsupported) +\fB\-bv\fR (unsupported) Verify names only \- do not try to collect or deliver a message. .TP -.BI \-C file +\fB\-C\fR \fIfile\fR Use alternate configuration file. .TP -.BI \-d X -(ignored) +\fB\-d\fR \fIX\fR (ignored) Set debugging value to -.IR X . -.ne 1i +\fIX\fR. .TP -.BI \-F fullname +\fB\-F\fR \fIfullname\fR Set the full name of the sender. .TP -.BI \-f name -Sets the name of the ``from'' person -(i.e., the envelope sender of the mail). -This address may also be used in the From: header -if that header is missing during initial submission. -The envelope sender address is used as the recipient -for delivery status notifications -and may also appear in a Return-Path: header. -.PP +\fB\-f\fR \fIname\fR +Sets the name of the ``from'' person (i.e., the envelope sender of the mail). +This address may also be used in the From: header if that header is missing +during initial submission. The envelope sender address is used as the +recipient for delivery status notifications and may also appear in a +Return-Path: header. + This address is also used to select from different identities in the configuration file. .TP -.BI \-G -(ignored) +\fB\-G\fR (ignored) Relay (gateway) submission of a message. .TP -.BI \-h N -(ignored) -Set the hop count to -.IR N . +\fB\-h\fR \fIN\fR (ignored) +Set the hop count to \fIN\fR. .TP -.B \-i -(ignored) +\fB\-i\fR (ignored) Ignore dots alone on lines by themselves in incoming messages. This should be set if you are reading data from a file. .TP -.BI "\-L " tag -(ignored) -Set the identifier used in syslog messages to the supplied -.IR tag . +\fB\-L\fR \fItag\fR (ignored) +Set the identifier used in syslog messages to the supplied \fItag\fR. .TP -.BI "\-N " dsn -Set delivery status notification conditions to -.IR dsn , -which can be -`never' -for no notifications -or a comma separated list of the values -`failure' -to be notified if delivery failed, -`delay' -to be notified if delivery is delayed, and -`success' -to be notified when the message is successfully delivered. +\f\-N\fR \fIdsn\fR +Set delivery status notification conditions to \fIdsn\fR, which can be `never' +for no notifications or a comma separated list of the values `failure' to be +notified if delivery failed, `delay' to be notified if delivery is delayed, and +`success' to be notified when the message is successfully delivered. .TP -.B \-n -(default) +\fB\-n\fR (default) Don't do aliasing. .TP -\fB\-O\fP \fIoption\fR=\fIvalue\fR -(ignored) -Set option -.I option -to the specified -.IR value . -This form uses long names. +\fB\-O\fP \fIoption\fR=\fIvalue\fR (ignored) +Set option \fIoption\fR to the specified \fIvalue\fR. This form uses long +names. .TP -.BI \-o "x value" -(ignored) -Set option -.I x -to the specified -.IR value . -This form uses single character names only. +\fB\-o\fR \fIx value\fR (ignored) +Set option \fIx\fR to the specified \fIvalue\fR. This form uses single +character names only. .TP -.BI \-p protocol -(ignored) +\fB\-p\fR \fIprotocol\fR (ignored) Set the name of the protocol used to receive the message. .TP -\fB\-q\fR[\fItime\fR] -(ignored) +\fB\-q\fR[\fItime\fR] (ignored) Process saved messages in the queue at given intervals. .TP -\fB\-qp\fR[\fItime\fR] -(ignored) -Similar to \fB\-q\fItime\fR, -except that instead of periodically forking a child to process the queue, -sendmail forks a single persistent child for each queue -that alternates between processing the queue and sleeping. +\fB\-qp\fR[\fItime\fR] (ignored) +Similar to \fB\-q\fItime\fR, except that instead of periodically forking a +child to process the queue, forks a single persistent child for each queue that +alternates between processing the queue and sleeping. .TP -\fB\-q\fRf -(ignored) -Process saved messages in the queue once and do not fork(), -but run in the foreground. +\fB\-qf\fR (ignored) +Process saved messages in the queue once and do not fork(), but run in the +foreground. .TP -\fB\-q\fRG name -(ignored) -Process jobs in queue group called -.I name -only. +\fB\-qG\fR \fIname\fR (ignored) +Process jobs in queue group called \fIname\fR only. .TP -\fB\-q\fR[\fI!\fR]I substr -(ignored) -Limit processed jobs to those containing -.I substr -as a substring of the queue id or not when -.I ! -is specified. +\fB\-q\fR[\fI!\fR]\fBI\fR \fIsubstr\fR (ignored) +Limit processed jobs to those containing \fIsubstr\fR as a substring of the +queue id or not when \fI!\fR is specified. .TP -\fB\-q\fR[\fI!\fR]R substr -(ignored) -Limit processed jobs to those containing -.I substr -as a substring of one of the recipients or not when -.I ! -is specified. +\fB\-q\fR[\fI!\fR]\fBR\fR \fIsubstr\fR (ignored) +Limit processed jobs to those containing \fIsubstr\fR as a substring of one of +the recipients or not when \fI!\fR is specified. .TP -\fB\-q\fR[\fI!\fR]S substr -(ignored) -Limit processed jobs to those containing -.I substr -as a substring of the sender or not when -.I ! -is specified. +\fB\-q\fR[\fI!\fR]\fBS\fR \fIsubstr\fR (ignored) +Limit processed jobs to those containing \fIsubstr\fR as a substring of the +sender or not when \fI!\fR is specified. .TP -.BI "\-R " return -(ignored) -Set the amount of the message to be returned -if the message bounces. -The -.I return -parameter can be -`full' -to return the entire message or -`hdrs' -to return only the headers. -In the latter case also local bounces return only the headers. +\fB\-R\fR \fIreturn\fR (ignored) +Set the amount of the message to be returned if the message bounces. The +\fIreturn\fR parameter can be `full' to return the entire message or `hdrs' to +return only the headers. In the latter case also local bounces return only the +headers. .TP -.BI \-r name -An alternate and obsolete form of the -.B \-f -flag. +\fB\-r\fR \fIname\fR +An alternate and obsolete form of the \fB\-f\fR flag. .TP -.B \-t -(unsupported) -Read message for recipients. -To:, Cc:, and Bcc: lines will be scanned for recipient addresses. -The Bcc: line will be deleted before transmission. +\fB\-t\fR (unsupported) +Read message for recipients. To:, Cc:, and Bcc: lines will be scanned for +recipient addresses. The Bcc: line will be deleted before transmission. .TP -.BI "\-V " envid -(ignored) +\fB\-V\fR \fIenvid\fR (ignored) Set the original envelope id. .TP -.B \-v +\fB\-v\fR Go into verbose mode. .TP -.BI "\-X " logfile +\fB\-X\fR \fIlogfile\fR Log all traffic in and out of mailers in the indicated log file. .TP -.B \-\- +\fB\-\-\fR Stop processing command flags and use the rest of the arguments as addresses. @@ -333,10 +233,9 @@ addresses. configuration file .SH SEE ALSO +sendmail(1), fetchmail(1) -.SH DIAGNOSTICS - .SH AUTHORS José Fonseca .PP -- cgit v1.2.3