]> diplodocus.org Git - nmh/blobdiff - man/repl.man
Add a new base64 CTE test.
[nmh] / man / repl.man
index 4163b695084a5b04f41e96c3869c14cd37c47f2c..245d45aeb68cf8b94f61bbca7c5f085b412a4747 100644 (file)
@@ -1,4 +1,4 @@
-.TH REPL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH REPL %manext1% "April 9, 2013" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
@@ -10,7 +10,7 @@ repl \- reply to a message
 .B repl
 .RI [ +folder ]
 .RI [ msgs ]
-.RB [ \-annotate " | " \-noannotate ] 
+.RB [ \-annotate " | " \-noannotate ]
 .RB [ \-group " | " \-nogroup ]
 .RB [ \-cc
 all/to/cc/me]
@@ -66,7 +66,7 @@ uses
 a reply template to guide its actions.  A reply template is simply a
 .B mhl
 format file (see
-.BR mh\-format (5)
+.IR mh\-format (5)
 for details).
 .PP
 If the switch
@@ -94,7 +94,7 @@ Subject: Re: <Subject>
 In\-Reply\-To: <Message\-Id>
 References: <Message\-Id>
 Comments: In\-Reply\-To <From> or <apparently from> or <Sender>
-.ti +3 
+.ti +3
 message dated <date>
 --------
 .fi
@@ -109,8 +109,8 @@ addresses to this default with the
 .B \-cc
 .I type
 switch.  This switch takes an
-argument (
-.IR all / to / cc / me )
+argument
+.RI ( all / to / cc / me )
 which specifies who gets added to the default
 \*(lqcc:\*(rq list of the reply.  You may give this switch multiple times (with
 different arguments) if you wish to add multiple types of addresses.
@@ -119,7 +119,7 @@ If the switch
 .B \-group
 is given, then
 .B repl
-will use the the
+will use the
 standard forms file \*(lqreplgroupcomps\*(rq.  This will construct a
 draft message that is intended as a group or followup reply.  If a file
 named \*(lqreplgroupcomps\*(rq exists in the user's nmh directory, it
@@ -212,12 +212,14 @@ skeleton; and
 will display the draft.
 .PP
 See
-.BR comp (1)
+.IR comp (1)
 for a description of the
 .B \-editor
 and
 .B \-noedit
-switches.  Note that while in the editor, the message being replied
+switches.  Note that while in the editor, with
+.B \-atfile
+and if the current directory is writable, the message being replied
 to is available through a link named \*(lq@\*(rq (assuming the default
 .IR whatnowproc ).
 In addition, the actual pathname of the message is
@@ -226,8 +228,7 @@ stored in the environment variable
 and the pathname of
 the folder containing the message is stored in the environment variable
 .BR $mhfolder .
-The creation of the \*(lq@\*(rq file and associated environment variables
-can be controlled via the
+The creation of the \*(lq@\*(rq file is controlled via the
 .B \-atfile
 and
 .B \-noatfile
@@ -328,7 +329,7 @@ body:component=\*(lq>\*(rq,\|nowrap,\|format
 .RE
 .PP
 See the
-.BR mhl(1)
+.IR mhl(1)
 documentation for more information.  The format program can be changed by
 the
 .B \-fmtproc
@@ -349,16 +350,7 @@ Note that
 .B nmh
 will not invoke
 .B mhbuild
-automatically, unless you
-add this line to your
-.I \&.mh\(ruprofile
-file:
-.PP
-.RS 5
-automimeproc: 1
-.RE
-.PP
-Otherwise, you must specifically give the command
+automatically; you must specifically give the command
 .PP
 .RS 5
 What now? mime
@@ -402,7 +394,7 @@ can
 be named.
 .PP
 In addition to the standard
-.BR mh\-format (5)
+.IR mh\-format (5)
 escapes,
 .B repl
 also recognizes the following additional
@@ -435,7 +427,7 @@ the
 .B nmh
 draft folder facility.  This is an advanced (and highly
 useful) feature.  Consult the
-.BR mh-draft (5)
+.IR mh-draft (5)
 man page for more
 information.
 .PP
@@ -444,7 +436,7 @@ Upon exiting from the editor,
 will invoke the
 .B whatnow
 program.  See
-.BR whatnow (1)
+.IR whatnow (1)
 for a discussion of available
 options.  The invocation of this program can be inhibited by using the
 .B \-nowhatnowproc
@@ -471,19 +463,27 @@ No mail is actually sent.
 The
 .B \-file
 .I msgfile
-switch specifies the message to be replied to as an 
+switch specifies the message to be replied to as an
 exact filename rather than as an
 .B nmh
-folder and message number. It is 
+folder and message number. It is
 intended to be used by the
 .B msh
 interface to
-.BR nmh . 
+.BR nmh .
 The same caveats apply to this option as to the
 .B \-build
 switch.
-
 .SH FILES
+.B repl
+looks for all format, filter and template files in multiple locations:
+absolute pathnames are accessed directly, tilde expansion is done on
+usernames, and files are searched for in the user's
+.I Mail
+directory as specified in their profile.  If not found there, the directory
+.RI \*(lq %etcdir% \*(rq
+is checked.
+.PP
 .fc ^ ~
 .nf
 .ta \w'%etcdir%/ExtraBigFileName  'u
@@ -496,7 +496,6 @@ switch.
 ^$HOME/\&.mh\(ruprofile~^The user profile
 ^<mh\-dir>/draft~^The draft file
 .fi
-
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
@@ -512,10 +511,13 @@ switch.
 ^mhlproc:~^Program to filter message being replied\-to
 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
 .fi
-
 .SH "SEE ALSO"
-mhbuild(1), comp(1), forw(1), send(1), whatnow(1), mh\-format(5)
-
+.IR comp (1),
+.IR forw (1),
+.IR mhbuild (1),
+.IR send (1),
+.IR whatnow (1),
+.IR mh\-format (5)
 .SH DEFAULTS
 .nf
 .RB ` +folder "' defaults to the current folder"
@@ -531,11 +533,9 @@ mhbuild(1), comp(1), forw(1), send(1), whatnow(1), mh\-format(5)
 .RB ` \-noatfile '
 .RB ` "\-width\ 72" '
 .fi
-
 .SH CONTEXT
 If a folder is given, it will become the current folder.  The message
 replied\-to will become the current message.
-
 .SH BUGS
 If any addresses occur in the reply template, addresses in the template
 that do not contain hosts are defaulted incorrectly.  Instead of using
@@ -569,6 +569,3 @@ don't call it
 since
 .B repl
 won't run it.
-.PP
-If your current working directory is not writable, the link named
-\*(lq@\*(rq is not available.