nmh-workers
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Nmh-workers] Changes to rcvdist.man


From: Larry Hynes
Subject: [Nmh-workers] Changes to rcvdist.man
Date: Thu, 29 Dec 2016 21:03:38 +0000

A cleanup, and possibly some controversy: I've replaced

        Rather than standard message skeleton

with

        User message skeleton

My thinking here is that a) we can do away with the kinda weird
'Rather than', b) I find the distinction between 'default' and
'standard' to be vague and c) it only appears in a few pages
and is easily remedied. It turns up in comp(1) as "An alternative
to the standard skeleton.", where 'standard' is used in the same
way as 'default' is used in rcvdist(1), so I think it's worth
settling on something 'better' and applying it consistently.

My proposal is 'Default foo', for the foo in %nmhetcdir% and
'User foo' for the foo in the user's <mh-dir>.

(It occurs to me that in barging in here with my keyboard blazing
I am quite possibly stepping on venerable toes. I apologise for
any discomfort caused, however inadvertently, to those who may
have come before me.)

David - README.manpages states that I shouldn't be changing the
dates on these, as I'm only really tweaking formatting. I can revert
the date changes if you like?
        
diff --git a/man/rcvdist.man b/man/rcvdist.man
index 125fc180..2a2fd49f 100644
--- a/man/rcvdist.man
+++ b/man/rcvdist.man
@@ -18,24 +18,20 @@ rcvdist \- asynchronously redistribute new mail
 \&...
 .ad
 .SH DESCRIPTION
-The
 .B rcvdist
-program will accept a message on its standard input
-and resend a copy of this message to all of the addresses listed on its
-command line.
+accepts a message on its standard input and resends a copy of
+the message to all of the addresses listed on its command line.
 .PP
-When a message is redistributed with the
-.B rcvdist
-command, the
-format of the Resent-xxx header fields is controlled by the forms files
+The format of the Resent-xxx header fields is specified by the form file
 .RI \*(lq rcvdistcomps \*(rq.
 If a file named
 .RI \*(lq rcvdistcomps \*(rq
-exists in the user's nmh
-directory, it will be used instead of the default one.  You may specify
-an alternate forms file with the switch
+exists in the user's nmh directory, it will be used instead of the
+default file.
+You may specify an alternate forms file with the
 .B \-form
-.IR formfile .
+.IR formfile
+switch.
 .PP
 The
 .RI \*(lq rcvdistcomps \*(rq
@@ -43,7 +39,7 @@ file uses the format string facility described in
 .IR mh\-format (5).
 In addition to the standard format escapes,
 .B rcvdist
-also recognizes the following additional
+also recognizes the following
 .I component
 escape:
 .PP
@@ -57,10 +53,10 @@ addresses   string  the addresses to distribute to
 .PP
 By default,
 .B rcvdist
-uses the program
+uses the
 .B post
-to do the actual
-delivery of the message, although this can be changed by defining the
+program to deliver the message, although this can be changed by
+defining the
 .I postproc
 profile component.
 .SH FILES
@@ -68,14 +64,14 @@ profile component.
 .nf
 .ta \w'%nmhetcdir%/ExtraBigFileName  'u
 ^%nmhetcdir%/rcvdistcomps~^Default message skeleton
-^or <mh\-dir>/rcvdistcomps~^Rather than standard message skeleton
+^or <mh\-dir>/rcvdistcomps~^User message skeleton
 ^%nmhetcdir%/mts.conf~^nmh mts configuration file
 ^$HOME/\&.maildelivery~^The file controlling local delivery
-^%nmhetcdir%/maildelivery~^Rather than the standard file
+^%nmhetcdir%/maildelivery~^User delivery file
 .fi
 .SH "SEE ALSO"
 .IR rcvpack (1),
 .IR rcvstore (1),
-.IR rcvtty (1), 
+.IR rcvtty (1),
 .IR slocal (1),
 .IR mh\-format (5)



reply via email to

[Prev in Thread] Current Thread [Next in Thread]