Provided by: nmh_1.3-1build1_i386 bug

NAME

       dist - redistribute a message to additional addresses

SYNOPSIS

       dist [+folder] [msgs] [-form formfile] [-annotate | -noannotate]
            [-inplace | -noinplace] [-draftfolder +folder] [-draftmessage msg]
            [-nodraftfolder] [-editor editor] [-noedit] [-whatnowproc program]
            [-nowhatnowproc] [-version] [-help]

DESCRIPTION

       Dist is similar  to  forw.   It  prepares  the  specified  message  for
       redistribution  to  addresses that (presumably) are not on the original
       address list.

       The default message form contains the following elements:

            Resent-To:
            Resent-cc:
            Resent-fcc:

       If a file named "distcomps" exists in the user's nmh directory, it will
       be  used  instead  of  this default form.  You may specify an alternate
       forms file with the switch -form  formfile.   The  form  used  will  be
       prepended to the message being resent.

       If the draft already exists, dist will ask you as to the disposition of
       the draft.  A reply of quit will abort dist, leaving the draft  intact;
       replace will replace the existing draft with a blank skeleton; and list
       will display the draft.

       Only those addresses in "Resent-To:", "Resent-cc:",  and  "Resent-Bcc:"
       will  be  sent.   Also,  a  "Resent-Fcc:  folder"  will be honored (see
       send(1)).   Note  that  with  dist,  the  draft  should  contain   only
       "Resent-xxx:"  fields  and  no  body.   The headers and the body of the
       original message are copied to the draft when the message is sent.  Use
       care in constructing the headers for the redistribution.

       If  the  -annotate switch is given, the  message being distributed will
       be annotated with the lines:

            Resent: date
            Resent: addrs

       where each address list contains  as  many  lines  as  required.   This
       annotation will be done only if the message is sent directly from dist.
       If the message is not sent immediately from dist, "comp  -use"  may  be
       used  to  re-edit and send the constructed message, but the annotations
       won't take place.  Normally annotations are done inplace  in  order  to
       preserve  any  links to the message.  You may use the -noinplace switch
       to change this.

       See comp(1) for a description of  the  -editor  and  -noedit  switches.
       Note  that  while  in the editor, the message being resent is available
       through a link  named  "@"  (assuming  the  default  whatnowproc).   In
       addition,  the  actual  pathname  of  the  message  is  stored  in  the
       environment  variable  $editalt,  and  the  pathname  of   the   folder
       containing the message is stored in the environment variable $mhfolder.

       The  -draftfolder +folder and -draftmessage msg switches invoke the nmh
       draft folder  facility.   This  is  an  advanced  (and  highly  useful)
       feature.  Consult the mh-draft(5) man page for more information.

       Upon  exiting  from  the  editor, dist will invoke the whatnow program.
       See whatnow(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 whatnow program which starts  the  initial
       edit.  Hence, -nowhatnowproc will prevent any edit from occurring.)

FILES

       /etc/nmh/distcomps         The standard message skeleton
       or <mh-dir>/distcomps      Rather than the standard skeleton
       $HOME/.mh_profile          The user profile
       <mh-dir>/draft             The draft file

PROFILE COMPONENTS

       Path:                To determine the user's nmh directory
       Current-Folder:      To find the default current folder
       Draft-Folder:        To find the default draft-folder
       Editor:              To override the default editor
       fileproc:            Program to refile the message
       whatnowproc:         Program to ask the "What now?" questions

SEE ALSO

       comp(1), forw(1), repl(1), send(1), whatnow(1)

DEFAULTS

       `+folder' defaults to the current folder
       `msg' defaults to cur
       `-noannotate'
       `-nodraftfolder'
       `-inplace'

CONTEXT

       If  a  folder is given, it will become the current folder.  The message
       distributed will become the current message.

HISTORY

       Dist originally used headers of the form "Distribute-xxx:"  instead  of
       "Resent-xxx:".   In  order  to conform with the ARPA Internet standard,
       RFC-822, the "Resent-xxx:" form  is  now  used.   Dist  will  recognize
       "Distribute-xxx:"  type  headers  and  automatically  convert  them  to
       "Resent-xxx:".

BUGS

       Dist does not  rigorously  check  the  message  being  distributed  for
       adherence to the transport standard, but post called by send does.  The
       post program will balk (and rightly so) at poorly  formatted  messages,
       and dist won't correct things for you.

       If  whatnowproc  is whatnow, then comp uses a built-in whatnow, it does
       not actually run the whatnow program.  Hence, if you  define  your  own
       whatnowproc, don't call it whatnow since comp won't run it.

       If  your  current working directory is not writable, the link named "@"
       is not available.