From 6537f4cfd63c00812584f1325a19615541f6417a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jos=C3=A9=20Fonseca?= Date: Mon, 14 Jul 2003 13:10:29 +0000 Subject: Add a man page for the configuration file. --- Makefile.am | 2 +- NEWS | 7 +++++++ README | 66 ++----------------------------------------------------------- TODO | 6 ++---- esmtp.1 | 13 ++++++++---- 5 files changed, 21 insertions(+), 73 deletions(-) diff --git a/Makefile.am b/Makefile.am index eca6734..2f83b99 100644 --- a/Makefile.am +++ b/Makefile.am @@ -1,6 +1,6 @@ bin_PROGRAMS = esmtp -dist_man_MANS = esmtp.1 +dist_man_MANS = esmtp.1 esmtprc.5 esmtp_SOURCES = \ lexer.l \ diff --git a/NEWS b/NEWS index 92a8bdb..289c796 100644 --- a/NEWS +++ b/NEWS @@ -1,6 +1,13 @@ News ~~~~ + * Version 0.4.1 (under development): + + * Packaging fixes. + + * Esmtprc man page. + + * Version 0.4 (2003-07-12): * Debian packaging. diff --git a/README b/README index 89b26ef..9e3c896 100644 --- a/README +++ b/README @@ -46,70 +46,8 @@ mda "/usr/bin/procmail -d %T" * Configuration options ~~~~~~~~~~~~~~~~~~~~~~~ - Options are specified by giving a in the configuration - file. The equal sign is optional and can be replaced by whitespace. The - value may be enclose in simple or double quotes, in which case special - characters can be escaped as in normal strings. - - [hostname] - set SMTP host and service (port). - - This is specified in the format <<>> with no - whitespace surrounding the colon if service is specified. service may be a - name from <<>> or a decimal port number. If not specified - the port defaults to 587. - - Note (from <> documentation): the default port number is set to - 587 since this is the port that should be used for mail submission, see RFC - 2476. By choosing this default now, the API does not change behavior - unexpectedly in the future as use of the new standard becomes commonplace. - The hostport notation simplifies things for the application, the user can - type <<>> or <<>> where the application - expects a host name. - - [username] - set the user name. - - [password] - set the password. - - [starttls] - determine the usage of the StartTLS extension. - - It can be one of <"enabled">, <"disabled"> or <"required">. It defaults to - disabled. - - [certificate_passphrase] - set the certificate passphrase. - - [identity] - define an identity. - - An identities is a set of options associated with a given address. For - example: - --------------------------------------- -identity = myself@somewhere.com - hostname = smtp.somewhere.com:25 - username = "myself" - password = "secret" --------------------------------------- - - Identities are be selected by the address specified in the <-f> flag. You - can have as many you like. - - The options up to the first option constitute the default - identity. - - - Note: the default identity settings are not shared by the other identities. - Everything (username, password, etc.) must be specified for every identity - even if they don't differ from the default identity. - - [mda] - set the Mail Delivery Agent (MDA). - - Local delivery addresses will be inserted into the MDA command wherever you - place a <%T>. The mail message's From address will be inserted where you - place an <%F>. - - Some common MDAs are <"/usr/bin/procmail -d %T">, - <"/usr/bin/deliver"> and <"/usr/lib/mail.local %T">. - - See below for more information about using <> with an MDA. + See the <> man page for more detailed information on the + configuration options. Invocation diff --git a/TODO b/TODO index a7eed6c..83a2645 100644 --- a/TODO +++ b/TODO @@ -1,13 +1,11 @@ To do ~~~~~ - <> already fulfills all my needs, and I don't plan to spend more time - on it besides bug-fixing and some minor feature enhancements. + <> already fulfills all my needs, and I don't plan to spend much more + time on it besides bug fixing. Here is a list of what can still be done: - * Add a man page for the configuration file. - * Alias expansion. diff --git a/esmtp.1 b/esmtp.1 index e3b9431..31c6036 100644 --- a/esmtp.1 +++ b/esmtp.1 @@ -240,11 +240,16 @@ addresses. .SH FILES .TP ~/.esmtprc -configuration file +user configuration file + +.TP +/etc/esmtprc +system configuration file .SH SEE ALSO -sendmail(1), -fetchmail(1) +esmtprc(5), +fetchmail(1), +sendmail(1) -.SH AUTHORS +.SH AUTHOR José Fonseca -- cgit v1.2.3-2-g168b