Re: OpenSMTPD docs: aliases.5

2021-02-12 Thread Jason McIntyre
On Fri, Feb 12, 2021 at 03:14:26PM +, Larry Hynes wrote:
> 

hi.

i've taken the changes in the first sentence - i agree that the comma
placement reads better in your version.

i'm working my way through your diffs just now, but to be honest most of
these changes (like the rest in this diff) look like changing words
needlessly. i don;t want to change stuff unless there seems to be a
clear improvement.

jmc

> Index: aliases.5
> ===
> RCS file: /cvs/src/usr.sbin/smtpd/aliases.5,v
> retrieving revision 1.16
> diff -u -p -r1.16 aliases.5
> --- aliases.5 23 Apr 2020 21:28:10 -  1.16
> +++ aliases.5 12 Feb 2021 15:12:41 -
> @@ -25,19 +25,18 @@ This manual page describes the format of
>  .Nm
>  file, as used by
>  .Xr smtpd 8 .
> -An alias in its simplest form is used to assign an arbitrary name
> -to an email address, or a group of email addresses.
> -This provides a convenient way to send mail.
> -For example an alias could refer to all users of a group:
> +An alias, in its simplest form, is used to assign an arbitrary name
> +to an email address or a group of email addresses.
> +For example, an alias can refer to all users in a group:
>  email to that alias would be sent to all members of the group.
> -Much more complex aliases can be defined however:
> +More complex aliases can be defined, however:
>  an alias can refer to other aliases,
> -be used to send mail to a file instead of another person,
> +be used to write mail to a file,
>  or to execute various commands.
>  .Pp
>  Within the file,
>  .Ql #
> -is a comment delimiter; anything placed after it is discarded.
> +is a comment delimiter; anything placed after it is ignored.
>  The file consists of key/value mappings of the form:
>  .Bd -filled -offset indent
>  key: value1, value2, value3, ...
> 



OpenSMTPD docs: aliases.5

2021-02-12 Thread Larry Hynes


Index: aliases.5
===
RCS file: /cvs/src/usr.sbin/smtpd/aliases.5,v
retrieving revision 1.16
diff -u -p -r1.16 aliases.5
--- aliases.5   23 Apr 2020 21:28:10 -  1.16
+++ aliases.5   12 Feb 2021 15:12:41 -
@@ -25,19 +25,18 @@ This manual page describes the format of
 .Nm
 file, as used by
 .Xr smtpd 8 .
-An alias in its simplest form is used to assign an arbitrary name
-to an email address, or a group of email addresses.
-This provides a convenient way to send mail.
-For example an alias could refer to all users of a group:
+An alias, in its simplest form, is used to assign an arbitrary name
+to an email address or a group of email addresses.
+For example, an alias can refer to all users in a group:
 email to that alias would be sent to all members of the group.
-Much more complex aliases can be defined however:
+More complex aliases can be defined, however:
 an alias can refer to other aliases,
-be used to send mail to a file instead of another person,
+be used to write mail to a file,
 or to execute various commands.
 .Pp
 Within the file,
 .Ql #
-is a comment delimiter; anything placed after it is discarded.
+is a comment delimiter; anything placed after it is ignored.
 The file consists of key/value mappings of the form:
 .Bd -filled -offset indent
 key: value1, value2, value3, ...