diff options
author | Sergey Poznyakoff <gray@gnu.org.ua> | 2008-03-10 18:43:23 +0000 |
---|---|---|
committer | Sergey Poznyakoff <gray@gnu.org.ua> | 2008-03-10 18:43:23 +0000 |
commit | da3381a039b1ab4878baa9e5fc9be39284a154f2 (patch) | |
tree | 70c9f4c025b24cebbf745ae331c6fec0ff851f5e | |
parent | 78cd4c22e42f520482f0b462b3f000eadd18b910 (diff) | |
download | mailfromd-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-- | ChangeLog | 4 | ||||
-rw-r--r-- | doc/mailfromd.texi | 42 |
2 files changed, 26 insertions, 20 deletions
@@ -1,5 +1,9 @@ | |||
1 | 2008-03-10 Sergey Poznyakoff <gray@gnu.org.ua> | 1 | 2008-03-10 Sergey Poznyakoff <gray@gnu.org.ua> |
2 | 2 | ||
3 | * doc/mailfromd.texi: Spell check. Add missing acknowledgments. | ||
4 | |||
5 | 2008-03-10 Sergey Poznyakoff <gray@gnu.org.ua> | ||
6 | |||
3 | -= Release 4.4 =- | 7 | -= Release 4.4 =- |
4 | 8 | ||
5 | 2008-03-10 Sergey Poznyakoff <gray@gnu.org.ua> | 9 | 2008-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 |
341 | appeared soon afterwards. Back then it was a simple implementation of | 341 | appeared soon afterward. Back then it was a simple implementation of |
342 | Sender Address Verification (@pxref{SAV}) for @samp{Sendmail} (hence | 342 | Sender Address Verification (@pxref{SAV}) for @samp{Sendmail} (hence |
343 | its name -- @command{mailfromd}) with rudimentary tuning | 343 | its name -- @command{mailfromd}) with rudimentary tuning |
344 | possibilities. | 344 | possibilities. |
@@ -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 |
382 | to facilitate the configuration on @samp{Sendmail} side. | 382 | to 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 |
385 | concentrated mainly on bug-fixes, while the main development was done | 385 | concentrated mainly on bug-fixes, while the main development was done |
386 | on the next branch. | 386 | on 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 | ||
485 | Alan Dobkin, Brent Spencer, Jeff Ballard, Nacho Gonz@'alez L@'opez, | 487 | Alan Dobkin, Brent Spencer, Jeff Ballard, Nacho Gonz@'alez L@'opez, |
486 | Simon Christian. | 488 | Phil 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 |
1022 | the @samp{e_} previx: success, not_found, failure, temp_failure. This | 1024 | the @samp{e_} prefix: @code{success}, @code{not_found}, @code{failure}, |
1023 | makes most existing user scripts suitable for use with version 4.4 | 1025 | @code{temp_failure}. This makes most existing user scripts suitable for use |
1024 | without any modification. If your script refers to any exception | 1026 | with version 4.4 without any modification. If your script refers to any |
1025 | codes other than these four, you can still use it by defining a | 1027 | exception codes other than these four, you can still use it by defining a |
1026 | preprocessor symbol @code{OLD_EXCEPTION_CODES}, for example: | 1028 | preprocessor 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 | |||
1043 | it by default. The previous meaning of the @option{--enable-syslog-async} | 1045 | it by default. The previous meaning of the @option{--enable-syslog-async} |
1044 | configuration option is also restored. Use this option in order to | 1046 | configuration option is also restored. Use this option in order to |
1045 | enable asynchronous syslog feature. To set default syslog | 1047 | enable asynchronous syslog feature. To set default syslog |
1046 | implemetation, use @code{DEFAULT_SYSLOG_ASYNC} configuration variable | 1048 | implementation, 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 | |||
3456 | done | 3458 | done |
3457 | @end smallexample | 3459 | @end smallexample |
3458 | 3460 | ||
3459 | Problems begin when we need tp expand a constant in a | 3461 | Problems begin when we need to expand a constant in a |
3460 | literal string. The only way to do so is by prefixing its name with a | 3462 | literal 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 |
3462 | ambiguity. | 3464 | ambiguity. |
@@ -5092,7 +5094,7 @@ None. | |||
5092 | @item Invocation: | 5094 | @item Invocation: |
5093 | This header is called zero or more times, for each piece of the | 5095 | This header is called zero or more times, for each piece of the |
5094 | message body obtained from the remote host. | 5096 | message 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 |
5211 | are executed at shutdown. It is also warranted that all @samp{begin} | 5213 | are executed at shutdown. It is also warranted that all @samp{begin} |
5212 | and @samp{end} blocks defined within a compilation unit (i.e. a single | 5214 | and @samp{end} blocks defined within a compilation unit (i.e. a single |
5213 | abstract source file, whith all @code{#include} and | 5215 | abstract 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 |
5215 | order of their appearance in the unit. | 5217 | order 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 | |||
5670 | right, if the left-adjustment flag has been given). Instead of a | 5672 | right, if the left-adjustment flag has been given). Instead of a |
5671 | decimal digit string one may write @samp{*} or @samp{*@var{m}$} (for | 5673 | decimal digit string one may write @samp{*} or @samp{*@var{m}$} (for |
5672 | some decimal integer @var{m}) to specify that the field width is given | 5674 | some decimal integer @var{m}) to specify that the field width is given |
5673 | in the next argument, or in the @var{m}-th argument, respectively, | 5675 | in the next argument, or in the @var{m}th argument, respectively, |
5674 | which must be of numeric type. A negative field width is taken as a | 5676 | which 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 |
5676 | non-existent or small field width cause truncation of a field; if the | 5678 | non-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 | |||
5682 | an optional decimal digit string. Instead of a decimal digit string | 5684 | an optional decimal digit string. Instead of a decimal digit string |
5683 | one may write @samp{*} or @samp{*@var{m}$} (for some decimal integer | 5685 | one 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, |
5685 | or in the @var{m}-th argument, respectively, which must be of numeric | 5687 | or in the @var{m}th argument, respectively, which must be of numeric |
5686 | type. If the precision is given as just @samp{.}, or the precision is | 5688 | type. If the precision is given as just @samp{.}, or the precision is |
5687 | negative, the precision is taken to be zero. This gives the minimum number | 5689 | negative, the precision is taken to be zero. This gives the minimum number |
5688 | of digits to appear for @samp{d}, @samp{i}, @samp{o}, @samp{u}, | 5690 | of 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 |
6250 | is not yet reached, the coresponding answer from the database is | 6252 | is not yet reached, the corresponding answer from the database is |
6251 | returned. Otherwise, the function performs actual @acronym{DNS} lookup, stores | 6253 | returned. Otherwise, the function performs actual @acronym{DNS} lookup, stores |
6252 | the obtained data in the database and returns it. | 6254 | the 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 |
7962 | exactly the same way as the mandatory ones. Attempt to dereference an | 7964 | exactly the same way as the mandatory ones. Attempt to dereference an |
7963 | optional argument for which no actual aparameter was supplied, results | 7965 | optional argument for which no actual parameter was supplied, results |
7964 | in an undefined value, so be sure to chech whether a parameter is | 7966 | in an undefined value, so be sure to check whether a parameter is |
7965 | passed before dereferencing it. | 7967 | passed 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 |
8658 | Defining a variable havinf the same name as an already defined one results | 8660 | Defining a variable having the same name as an already defined one results |
8659 | in a warning message being displayed. The compilation succeeds. The | 8661 | in a warning message being displayed. The compilation succeeds. The |
8660 | second variable @dfn{shadows} the first, that is any subsequent | 8662 | second variable @dfn{shadows} the first, that is any subsequent |
8661 | references to the variable name will refer to the second variable. | 8663 | references 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 |
9919 | it. The built-in preprocessor handles only file inclusion | 9921 | it. 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 |
9921 | macro expansion, are supported via @command{m4}, which is used as an | 9923 | macro expansion, are supported via @command{m4}, which is used as an |
9922 | external preprocessor. | 9924 | external 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 |
9932 | it to include line synchornizattion information in its output, which | 9934 | it to include line synchronization information in its output, which |
9933 | is subsequently used by @acronym{MFL} compiler for purposes of error | 9935 | is subsequently used by @acronym{MFL} compiler for purposes of error |
9934 | reporting. The initial set of macro definitions is supplied in file | 9936 | reporting. 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 |
9936 | usually located in | 9938 | usually located in |
9937 | @file{/usr/local/share/mailfromd/@value{VERSION}/include/pp-setup}.}, | 9939 | @file{/usr/local/share/mailfromd/@value{VERSION}/include/pp-setup}.}, |
9938 | which is fed to the preprocessor input before the script file itself. | 9940 | which is fed to the preprocessor input before the script file itself. |
9939 | The default @file{pp-setup} file renames all @command{m4} builtin | 9941 | The default @file{pp-setup} file renames all @command{m4} built-in |
9940 | macro names so they all start with the prefix @samp{m4_}@footnote{This | 9942 | macro names so they all start with the prefix @samp{m4_}@footnote{This |
9941 | is similar to GNU m4 @option{--pre |