share/doc/usd/07.mail/mail3.nr

   1 .\" Copyright (c) 1980, 1993
   2 .\"     The Regents of the University of California.  All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. Neither the name of the University nor the names of its contributors
  13 .\"    may be used to endorse or promote products derived from this software
  14 .\"    without specific prior written permission.
  15 .\"
  16 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  17 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  19 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  20 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  22 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  23 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  24 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  26 .\" SUCH DAMAGE.
  27 .\"
  28 .\"     @(#)mail3.nr    8.1 (Berkeley) 6/8/93
  29 .\"
  30 .sh 1 "Maintaining folders"
  31 .pp
  32 .i Mail
  33 includes a simple facility for maintaining groups of messages together
  34 in folders.  This section describes this facility.
  35 .pp
  36 To use the folder facility, you must tell
  37 .i Mail
  38 where you wish to keep your folders.  Each folder of messages will
  39 be a single file.  For convenience, all of your folders are kept in
  40 a single directory of your choosing.  To tell
  41 .i Mail
  42 where your folder directory is, put a line of the form
  43 .(l
  44 set folder=letters
  45 .)l
  46 in your
  47 .i .mailrc
  48 file.  If, as in the example above, your folder directory does not
  49 begin with a `/,'
  50 .i Mail
  51 will assume that your folder directory is to be found starting from
  52 your home directory.  Thus, if your home directory is
  53 .b /home/person
  54 the above example told
  55 .i Mail
  56 to find your folder directory in
  57 .b /home/person/letters .
  58 .pp
  59 Anywhere a file name is expected, you can use a folder name, preceded
  60 with `+.'  For example, to put a message into a folder with the
  61 .b save
  62 command, you can use:
  63 .(l
  64 save +classwork
  65 .)l
  66 to save the current message in the
  67 .i classwork
  68 folder.  If the
  69 .i classwork
  70 folder does not yet exist, it will be created.  Note that messages
  71 which are saved with the
  72 .b save
  73 command are automatically removed from your system mailbox.
  74 .pp
  75 In order to make a copy of a message in a folder without causing
  76 that message to be removed from your system mailbox, use the
  77 .b copy
  78 command, which is identical in all other respects to the
  79 .b save
  80 command.  For example,
  81 .(l
  82 copy +classwork
  83 .)l
  84 copies the current message into the
  85 .i classwork
  86 folder and leaves a copy in your system mailbox.
  87 .pp
  88 The
  89 .b folder
  90 command
  91 can be used to direct
  92 .i Mail
  93 to the contents of a different folder.
  94 For example,
  95 .(l
  96 folder +classwork
  97 .)l
  98 directs
  99 .i Mail
 100 to read the contents of the
 101 .i classwork
 102 folder.  All of the commands that you can use on your system
 103 mailbox are also applicable to folders, including
 104 .b type ,
 105 .b delete ,
 106 and
 107 .b reply .
 108 To inquire which folder you are currently editing, use simply:
 109 .(l
 110 folder
 111 .)l
 112 .pp
 113 To list your current set of folders, use the
 114 .b folders
 115 command.
 116 .pp
 117 To start
 118 .i Mail
 119 reading one of your folders, you can use the
 120 .b \-f
 121 option described in section 2.  For example:
 122 .(l
 123 % Mail \-f +classwork
 124 .)l
 125 will cause
 126 .i Mail
 127 to read your
 128 .i classwork
 129 folder without looking at your system mailbox.