aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSergey Poznyakoff <gray@gnu.org.ua>2008-03-10 18:43:23 +0000
committerSergey Poznyakoff <gray@gnu.org.ua>2008-03-10 18:43:23 +0000
commitda3381a039b1ab4878baa9e5fc9be39284a154f2 (patch)
tree70c9f4c025b24cebbf745ae331c6fec0ff851f5e
parent78cd4c22e42f520482f0b462b3f000eadd18b910 (diff)
downloadmailfromd-da3381a039b1ab4878baa9e5fc9be39284a154f2.tar.gz
mailfromd-da3381a039b1ab4878baa9e5fc9be39284a154f2.tar.bz2
doc/mailfromd.texi: Spell check. Add missing acknowledgments.
git-svn-id: file:///svnroot/mailfromd/branches/release_4_4_patches@1640 7a8a7f39-df28-0410-adc6-e0d955640f24
-rw-r--r--ChangeLog4
-rw-r--r--doc/mailfromd.texi42
2 files changed, 26 insertions, 20 deletions
diff --git a/ChangeLog b/ChangeLog
index 0b98c98e..3602649b 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
12008-03-10 Sergey Poznyakoff <gray@gnu.org.ua> 12008-03-10 Sergey Poznyakoff <gray@gnu.org.ua>
2 2
3 * doc/mailfromd.texi: Spell check. Add missing acknowledgments.
4
52008-03-10 Sergey Poznyakoff <gray@gnu.org.ua>
6
3 -= Release 4.4 =- 7 -= Release 4.4 =-
4 8
52008-03-10 Sergey Poznyakoff <gray@gnu.org.ua> 92008-03-10 Sergey Poznyakoff <gray@gnu.org.ua>
diff --git a/doc/mailfromd.texi b/doc/mailfromd.texi
index 9cf4871e..368f890d 100644
--- a/doc/mailfromd.texi
+++ b/doc/mailfromd.texi
@@ -338,7 +338,7 @@ Invoke external programs or other mail filters.
338@unnumberedsec Short history of @command{mailfromd}. 338@unnumberedsec Short history of @command{mailfromd}.
339 339
340 The idea of the utility appeared in 2005, and its first version 340 The idea of the utility appeared in 2005, and its first version
341appeared soon afterwards. Back then it was a simple implementation of 341appeared soon afterward. Back then it was a simple implementation of
342Sender Address Verification (@pxref{SAV}) for @samp{Sendmail} (hence 342Sender Address Verification (@pxref{SAV}) for @samp{Sendmail} (hence
343its name -- @command{mailfromd}) with rudimentary tuning 343its name -- @command{mailfromd}) with rudimentary tuning
344possibilities. 344possibilities.
@@ -381,7 +381,7 @@ Another major feature was the @option{--dump-macros} option and
381@option{macros} to @command{rc.mailfromd} script, that were intended 381@option{macros} to @command{rc.mailfromd} script, that were intended
382to facilitate the configuration on @samp{Sendmail} side. 382to facilitate the configuration on @samp{Sendmail} side.
383 383
384 The development of 3.@i{x} (more propery, 3.1.@i{x}) series 384 The development of 3.@i{x} (more properly, 3.1.@i{x}) series
385concentrated mainly on bug-fixes, while the main development was done 385concentrated mainly on bug-fixes, while the main development was done
386on the next branch. 386on the next branch.
387 387
@@ -481,9 +481,11 @@ and helpful comments for various versions of the program:
481@cindex Brent Spencer 481@cindex Brent Spencer
482@cindex Jeff Ballard 482@cindex Jeff Ballard
483@cindex Nacho Gonz@'alez L@'opez 483@cindex Nacho Gonz@'alez L@'opez
484@cindex Phil Miller
484@cindex Simon Christian 485@cindex Simon Christian
486@cindex Thomas Lynch
485Alan Dobkin, Brent Spencer, Jeff Ballard, Nacho Gonz@'alez L@'opez, 487Alan Dobkin, Brent Spencer, Jeff Ballard, Nacho Gonz@'alez L@'opez,
486Simon Christian. 488Phil Miller, Simon Christian, Thomas Lynch.
487 489
488@node Intro, Building, Preface, Top 490@node Intro, Building, Preface, Top
489@chapter Introduction to @command{mailfromd} 491@chapter Introduction to @command{mailfromd}
@@ -1019,10 +1021,10 @@ became @code{e_divzero}, etc. The @code{ioerr} exception code is renamed to
1019 1021
1020@cindex @code{OLD_EXCEPTION_CODES}, preprocessor symbol 1022@cindex @code{OLD_EXCEPTION_CODES}, preprocessor symbol
1021 For consistency, the following most often used codes are available without 1023 For consistency, the following most often used codes are available without
1022the @samp{e_} previx: success, not_found, failure, temp_failure. This 1024the @samp{e_} prefix: @code{success}, @code{not_found}, @code{failure},
1023makes most existing user scripts suitable for use with version 4.4 1025@code{temp_failure}. This makes most existing user scripts suitable for use
1024without any modification. If your script refers to any exception 1026with version 4.4 without any modification. If your script refers to any
1025codes other than these four, you can still use it by defining a 1027exception codes other than these four, you can still use it by defining a
1026preprocessor symbol @code{OLD_EXCEPTION_CODES}, for example: 1028preprocessor symbol @code{OLD_EXCEPTION_CODES}, for example:
1027 1029
1028@smallexample 1030@smallexample
@@ -1043,7 +1045,7 @@ on some systems (notably on Solaris), so this release does not enable
1043it by default. The previous meaning of the @option{--enable-syslog-async} 1045it by default. The previous meaning of the @option{--enable-syslog-async}
1044configuration option is also restored. Use this option in order to 1046configuration option is also restored. Use this option in order to
1045enable asynchronous syslog feature. To set default syslog 1047enable asynchronous syslog feature. To set default syslog
1046implemetation, use @code{DEFAULT_SYSLOG_ASYNC} configuration variable 1048implementation, use @code{DEFAULT_SYSLOG_ASYNC} configuration variable
1047(@pxref{syslog-async}). 1049(@pxref{syslog-async}).
1048 1050
1049@node 410-420 1051@node 410-420
@@ -3456,7 +3458,7 @@ do
3456done 3458done
3457@end smallexample 3459@end smallexample
3458 3460
3459Problems begin when we need tp expand a constant in a 3461Problems begin when we need to expand a constant in a
3460literal string. The only way to do so is by prefixing its name with a 3462literal string. The only way to do so is by prefixing its name with a
3461@samp{%}, just as if it were variable, and that produces the 3463@samp{%}, just as if it were variable, and that produces the
3462ambiguity. 3464ambiguity.
@@ -5092,7 +5094,7 @@ None.
5092@item Invocation: 5094@item Invocation:
5093This header is called zero or more times, for each piece of the 5095This header is called zero or more times, for each piece of the
5094message body obtained from the remote host. 5096message body obtained from the remote host.
5095@item Araguments: 5097@item Arguments:
5096@enumerate 1 5098@enumerate 1
5097@item @code{string}; Piece of body text. See @samp{Notes} below. 5099@item @code{string}; Piece of body text. See @samp{Notes} below.
5098@item @code{number}; Length of @code{$1}, in bytes. 5100@item @code{number}; Length of @code{$1}, in bytes.
@@ -5210,7 +5212,7 @@ blocks are executed is not defined. It is only warranted that all
5210@samp{begin} blocks are executed at startup and all @samp{end} blocks 5212@samp{begin} blocks are executed at startup and all @samp{end} blocks
5211are executed at shutdown. It is also warranted that all @samp{begin} 5213are executed at shutdown. It is also warranted that all @samp{begin}
5212and @samp{end} blocks defined within a compilation unit (i.e. a single 5214and @samp{end} blocks defined within a compilation unit (i.e. a single
5213abstract source file, whith all @code{#include} and 5215abstract source file, with all @code{#include} and
5214@code{#include_once} statements expanded in place) are executed in 5216@code{#include_once} statements expanded in place) are executed in
5215order of their appearance in the unit. 5217order of their appearance in the unit.
5216 5218
@@ -5670,7 +5672,7 @@ than the field width, it will be padded with spaces on the left (or
5670right, if the left-adjustment flag has been given). Instead of a 5672right, if the left-adjustment flag has been given). Instead of a
5671decimal digit string one may write @samp{*} or @samp{*@var{m}$} (for 5673decimal digit string one may write @samp{*} or @samp{*@var{m}$} (for
5672some decimal integer @var{m}) to specify that the field width is given 5674some decimal integer @var{m}) to specify that the field width is given
5673in the next argument, or in the @var{m}-th argument, respectively, 5675in the next argument, or in the @var{m}th argument, respectively,
5674which must be of numeric type. A negative field width is taken as a 5676which must be of numeric type. A negative field width is taken as a
5675@samp{-} flag followed by a positive field width. In no case does a 5677@samp{-} flag followed by a positive field width. In no case does a
5676non-existent or small field width cause truncation of a field; if the 5678non-existent or small field width cause truncation of a field; if the
@@ -5682,7 +5684,7 @@ An optional precision, in the form of a period (@samp{.}) followed by
5682an optional decimal digit string. Instead of a decimal digit string 5684an optional decimal digit string. Instead of a decimal digit string
5683one may write @samp{*} or @samp{*@var{m}$} (for some decimal integer 5685one may write @samp{*} or @samp{*@var{m}$} (for some decimal integer
5684@var{m}) to specify that the precision is given in the next argument, 5686@var{m}) to specify that the precision is given in the next argument,
5685or in the @var{m}-th argument, respectively, which must be of numeric 5687or in the @var{m}th argument, respectively, which must be of numeric
5686type. If the precision is given as just @samp{.}, or the precision is 5688type. If the precision is given as just @samp{.}, or the precision is
5687negative, the precision is taken to be zero. This gives the minimum number 5689negative, the precision is taken to be zero. This gives the minimum number
5688of digits to appear for @samp{d}, @samp{i}, @samp{o}, @samp{u}, 5690of digits to appear for @samp{d}, @samp{i}, @samp{o}, @samp{u},
@@ -6247,7 +6249,7 @@ type is}:
6247@end multitable 6249@end multitable
6248 6250
6249 If the lookup key is present in the database and its expiration time 6251 If the lookup key is present in the database and its expiration time
6250is not yet reached, the coresponding answer from the database is 6252is not yet reached, the corresponding answer from the database is
6251returned. Otherwise, the function performs actual @acronym{DNS} lookup, stores 6253returned. Otherwise, the function performs actual @acronym{DNS} lookup, stores
6252the obtained data in the database and returns it. 6254the obtained data in the database and returns it.
6253 6255
@@ -7960,8 +7962,8 @@ do
7960 7962
7961 Within a function body, optional arguments are referenced 7963 Within a function body, optional arguments are referenced
7962exactly the same way as the mandatory ones. Attempt to dereference an 7964exactly the same way as the mandatory ones. Attempt to dereference an
7963optional argument for which no actual aparameter was supplied, results 7965optional argument for which no actual parameter was supplied, results
7964in an undefined value, so be sure to chech whether a parameter is 7966in an undefined value, so be sure to check whether a parameter is
7965passed before dereferencing it. 7967passed before dereferencing it.
7966 7968
7967@cindex return statement, defined 7969@cindex return statement, defined
@@ -8655,7 +8657,7 @@ This may change in future releases.
8655@item variable -- variable 8657@item variable -- variable
8656@cindex variable shadowing 8658@cindex variable shadowing
8657@cindex shadowing, variable 8659@cindex shadowing, variable
8658Defining a variable havinf the same name as an already defined one results 8660Defining a variable having the same name as an already defined one results
8659in a warning message being displayed. The compilation succeeds. The 8661in a warning message being displayed. The compilation succeeds. The
8660second variable @dfn{shadows} the first, that is any subsequent 8662second variable @dfn{shadows} the first, that is any subsequent
8661references to the variable name will refer to the second variable. 8663references to the variable name will refer to the second variable.
@@ -9917,7 +9919,7 @@ compilation error.
9917@cindex m4 9919@cindex m4
9918 Before compiling the script file, @command{mailfromd} preprocesses 9920 Before compiling the script file, @command{mailfromd} preprocesses
9919it. The built-in preprocessor handles only file inclusion 9921it. The built-in preprocessor handles only file inclusion
9920(@pxref{include}), while the rest of traditional facililities, such as 9922(@pxref{include}), while the rest of traditional facilities, such as
9921macro expansion, are supported via @command{m4}, which is used as an 9923macro expansion, are supported via @command{m4}, which is used as an
9922external preprocessor. 9924external preprocessor.
9923 9925
@@ -9929,14 +9931,14 @@ acquainted with @command{m4} macro processor.
9929 9931
9930@flindex pp-setup 9932@flindex pp-setup
9931 The external preprocessor is invoked with @option{-s} flag, instructing 9933 The external preprocessor is invoked with @option{-s} flag, instructing
9932it to include line synchornizattion information in its output, which 9934it to include line synchronization information in its output, which
9933is subsequently used by @acronym{MFL} compiler for purposes of error 9935is subsequently used by @acronym{MFL} compiler for purposes of error
9934reporting. The initial set of macro definitions is supplied in file 9936reporting. The initial set of macro definitions is supplied in file
9935@file{pp-setup}, located in the library search path@footnote{It is 9937@file{pp-setup}, located in the library search path@footnote{It is
9936usually located in 9938usually located in
9937@file{/usr/local/share/mailfromd/@value{VERSION}/include/pp-setup}.}, 9939@file{/usr/local/share/mailfromd/@value{VERSION}/include/pp-setup}.},
9938which is fed to the preprocessor input before the script file itself. 9940which is fed to the preprocessor input before the script file itself.
9939The default @file{pp-setup} file renames all @command{m4} builtin 9941The default @file{pp-setup} file renames all @command{m4} built-in
9940macro names so they all start with the prefix @samp{m4_}@footnote{This 9942macro names so they all start with the prefix @samp{m4_}@footnote{This
9941is similar to GNU m4 @option{--pre