usr.bin/mail/USD.doc/mail3.nr

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