Ubuntu Feisty 7.04 manual page repository

Ubuntu is a free computer operating system based on the Linux kernel. Many IT companies, like DeployIS is using it to provide an up-to-date, stable operating system.

Provided by: nmh_1.2-1_i386

 

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  redis‐
        tribution  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 anno‐
        tation 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.
 
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  addi‐
        tion,  the  actual pathname of the message is stored in the environment
        variable $editalt, and the pathname of the folder containing  the  mes‐
        sage 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)  fea‐
mh-draft(5) man page for more information.
 
        Upon  exiting  from  the  editor, dist will invoke the whatnow program.
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
        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
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 “Dis‐
        tribute-xxx:”   type   headers   and   automatically  convert  them  to
        “Resent-xxx:”.
 

BUGS

        Dist does not rigorously check the message being distributed for adher‐
        ence 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.
 

Sections

What does Ubuntu mean?
Ubuntu is an African word meaning 'Humanity to others', or 'I am what I am because of who we all are'. The Ubuntu distribution brings the spirit of Ubuntu to the software world.