forw.man

早期freebsd实现

FORW(1)                BSD Reference Manual               FORW(1)


NNAAMMEE
       forw - forward messages

SSYYNNOOPPSSIISS
       forw    [+folder]    [msgs]    [-annotate]   [-noannotate]
            [-draftfolder +folder]            [-draftmessage msg]
            [-nodraftfolder]      [-editor editor]      [-noedit]
            [-filter filterfile]    [-form formfile]    [-format]
            [-noformat] [-inplace] [-noinplace] [-mime] [-nomime]
            [-whatnowproc program] [-nowhatnowproc] [-help]

     forw   [+folder]   [msgs]   [-digest list]   [-issue number]
            [-volume number] [other switches for _f_o_r_w] [-help]

DDEESSCCRRIIPPTTIIOONN
       _F_o_r_w  may  be  used  to prepare a message containing other
       messages.  It constructs the new message from  the  compo-
       nents  file  or  `-form formfile' (see _c_o_m_p ), with a body
       composed of the message(s) to be forwarded.  An editor  is
       invoked  as  in  _c_o_m_p,  and after editing is complete, the
       user is prompted before the message is sent.

       The default message form contains the following elements:

            To:
            cc:
            Subject:
            --------

       If the file named "forwcomps"  exists  in  the  user's  MH
       directory,  it  will  be  used  instead  of this form.  In
       either case, the file specified by  `-form formfile'  will
       be used if given.

       If  the  draft already exists, _f_o_r_w will ask you as to the
       disposition of the draft.  A  reply  of  qquuiitt  will  abort
       _f_o_r_w,  leaving  the draft intact; rreeppllaaccee will replace the
       existing draft with a blank skeleton; and lliisstt  will  dis-
       play the draft.

       If  the  `-annotate'  switch  is given, each message being
       forwarded will be annotated with the lines

            Forwarded: date
            Forwarded: addrs

       where  each  address  list  contains  as  many  lines   as
       required.   This  annotation will be done only if the mes-
       sage is sent directly from _f_o_r_w.  If the  message  is  not
       sent  immediately  from  _f_o_r_w,  "comp -use" may be used to
       re-edit  and  send  the  constructed  message,   but   the



[mh.6]                        MH.6.8                            1








FORW(1)                BSD Reference Manual               FORW(1)


       annotations  won't  take  place.   The  '-inplace'  switch
       causes annotation to be done in place in order to preserve
       links to the annotated message.

       See  _c_o_m_p (1)  for  a  description  of  the  `-editor' and
       `-noedit' switches.

       Although _f_o_r_w uses the `-form formfile' switch  to  direct
       it  how  to  construct  the  beginning  of  the draft, the
       `-filter filterfile', `-format', and `-noformat'  switches
       direct  _f_o_r_w  as  to  how each forwarded message should be
       formatted in the body of the  draft.   If  `-noformat'  is
       specified,  then  each forwarded message is output exactly
       as it appears.  If `-format'  or  `-filter filterfile'  is
       specified,   then   each  forwarded  message  is  filtered
       (re-formatted) prior to being output to the  body  of  the
       draft.  The filter file for _f_o_r_w should be a standard form
       file for _m_h_l, as _f_o_r_w will invoke _m_h_l to format  the  for-
       warded messages.  The default message filter (what you get
       with `-format') is:

            width=80,overflowtext=,overflowoffset=10
            leftadjust,compress,compwidth=9
            Date:formatfield="%<(nodate{text})%{text}%|%(tws{text})%>"
            From:
            To:
            cc:
            Subject:
            :
            body:nocomponent,overflowoffset=0,noleftadjust,nocompress

       If the file named "mhl.forward" exists in  the  user's  MH
       directory,  it  will  be  used  instead  of this form.  In
       either case, the file  specified  by  `-filter filterfile'
       will  be  used  if  given.  To summarize: `-noformat' will
       reproduce each forwarded message exactly,  `-format'  will
       use _m_h_l and a default filterfile, "mhl.forward", to format
       each forwarded message, and `-filter filterfile' will  use
       the named filterfile to format each forwarded message with
       _m_h_l.

       Each forwarded message is separated with an  encapsulation
       delimiter  and dashes in the first column of the forwarded
       messages  will  be  prepended  with  `- '  so  that   when
       received,   the   message  is  suitable  for  bursting  by
       _b_u_r_s_t (1).  This follows the Internet RFC-934  guidelines.

       For   users  of  _p_r_o_m_p_t_e_r (1),  by  specifying  prompter's
       `-prepend' switch in the .mh_profile file, any  commentary
       text  is  entered before the forwarded messages.  (A major
       win!)



[mh.6]                        MH.6.8                            2








FORW(1)                BSD Reference Manual               FORW(1)


       To use the  MIME  rules  for  encapsulation,  specify  the
       `-mime' switch.  This directs _f_o_r_w to generate an _m_h_n com-
       position file.  Note that MH will not invoke _m_h_n automati-
       cally, unless you  add this line to your .mh_profile file:

            automhnproc: mhn

       Otherwise, you must specifically give the command

            What now? edit mhn

       prior to sending the draft.

       To automate this  somewhat,  create  a  link  to  _p_r_o_m_p_t_e_r
       called _r_a_p_i_d and put these lines in your .mh_profile file:

            forw: -editor rapid -mime
            rapid: -rapid
            rapid-next: mhn

       Then, you can simply do:

            _f_o_r_w _m_s_g_s
            To: _m_a_i_l_b_o_x
            cc:
            Subject: _w_h_a_t_e_v_e_r

            --------Enter initial text

            _b_l_a_h_, _b_l_a_h_, _b_l_a_h_.
            <CTRL-D>
            --------

            What now? _e_d_i_t
            What now? _s_e_n_d

       The _e_d_i_t command invokes _m_h_n automatically.

       The   `-draftfolder +folder'    and    `-draftmessage msg'
       switches  invoke the _M_H draft folder facility.  This is an
       advanced  (and  highly  useful)  feature.    Consult   the
       AAddvvaanncceedd FFeeaattuurreess section of the _M_H manual for more infor-
       mation.

       Upon exiting from the editor, _f_o_r_w will invoke the _w_h_a_t_n_o_w
       program.   See  _w_h_a_t_n_o_w (1)  for a discussion of available
       options.  The invocation of this program can be  inhibited
       by  using the `-nowhatnowproc' switch.  (In truth of fact,
       it is the _w_h_a_t_n_o_w program which starts the  initial  edit.
       Hence,  `-nowhatnowproc' will prevent any edit from occur-
       ring.)



[mh.6]                        MH.6.8                            3








FORW(1)                BSD Reference Manual               FORW(1)


       The `-digest list', `-issue number', and  `-volume number'
       switches  implement  a digest facility for _M_H.  Specifying
       these switches  enables  and/or  overloads  the  following
       escapes:

       _T_y_p_e       _E_s_c_a_p_e  _R_e_t_u_r_n_s  _D_e_s_c_r_i_p_t_i_o_n
       _c_o_m_p_o_n_e_n_t  _d_i_g_e_s_t  string   Argument to `-digest'
       _f_u_n_c_t_i_o_n   _c_u_r     integer  Argument to `-volume'
       _f_u_n_c_t_i_o_n   _m_s_g     integer  Argument to `-issue'

       Consult  the  AAddvvaanncceedd  FFeeaattuurreess  section of the _M_H User's
       Manual for more information on making digests.

FFIILLEESS
       /usr/contrib/mh-6.8/lib/forwcomps         The message skeleton
       or <mh-dir>/forwcomps                     Rather than the standard skeleton
       /usr/contrib/mh-6.8/lib/digestcomps       The message skeleton if `-digest' is given
       or <mh-dir>/digestcomps                   Rather than the standard skeleton
       /usr/contrib/mh-6.8/lib/mhl.forward       The message filter
       or <mh-dir>/mhl.forward                   Rather than the standard filter
       $HOME/.mh_profile                         The user profile
       <mh-dir>/draft                            The draft file

PPRROOFFIILLEE CCOOMMPPOONNEENNTTSS
       Path:                To determine the user's MH directory
       Current-Folder:      To find the default current folder
       Draft-Folder:        To find the default draft-folder
       Editor:              To override the default editor
       Msg-Protect:         To set mode when creating a new message (draft)
       fileproc:            Program to refile the message
       mhlproc:             Program to filter messages being forwarded
       whatnowproc:         Program to ask the "What now?" questions

SSEEEE AALLSSOO
       _P_r_o_p_o_s_e_d _S_t_a_n_d_a_r_d _f_o_r _M_e_s_s_a_g_e _E_n_c_a_p_s_u_l_a_t_i_o_n (aka RFC-934),
       comp(1),    dist(1),    repl(1),    send(1),   whatnow(1),
       mh-format(5)

DDEEFFAAUULLTTSS
       `+folder' defaults to the current folder
       `msgs' defaults to cur
       `-noannotate'
       `-nodraftfolder'
       `-noformat'
       `-noinplace'
       `-nomime'

CCOONNTTEEXXTT
       If a folder is given, it will become the  current  folder.
       The  first  message forwarded will become the current mes-
       sage.



[mh.6]                        MH.6.8                            4








FORW(1)                BSD Reference Manual               FORW(1)


BBUUGGSS
       If _w_h_a_t_n_o_w_p_r_o_c is _w_h_a_t_n_o_w, then _f_o_r_w uses a built-in _w_h_a_t_-
       _n_o_w, it does not actually run the _w_h_a_t_n_o_w program.  Hence,
       if you define your own _w_h_a_t_n_o_w_p_r_o_c, don't call it  _w_h_a_t_n_o_w
       since _f_o_r_w won't run it.

       When _f_o_r_w is told to annotate the messages it forwards, it
       doesn't actually annotate them until the draft is success-
       fully  sent.  If from the _w_h_a_t_n_o_w_p_r_o_c, you _p_u_s_h instead of
       _s_e_n_d, it's possible to confuse  _f_o_r_w  by  re-ordering  the
       file (e.g., by using `folder -pack') before the message is
       successfully sent.  _D_i_s_t and _r_e_p_l don't have this problem.

       To  avoid  prepending  the leading dash characters in for-
       warded messages, there is a `-nodashmunging' option.   See
       the  "Hidden  Features"  section of the _M_H _A_d_m_i_n_i_s_t_r_a_t_o_r_'_s
       _G_u_i_d_e for more details.





































[mh.6]                        MH.6.8                            5