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

   1 .\"     $NetBSD: mail1.nr,v 1.3 1998/01/09 08:05:52 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 .\"     @(#)mail1.nr    8.1 (Berkeley) 6/8/93
  31 .\"
  32 .sh 1 Introduction
  33 .pp
  34 .i Mail
  35 provides a simple and friendly environment for sending and receiving mail.
  36 It divides incoming mail into
  37 its constituent messages and allows the user to deal with them
  38 in any order.  In addition, it provides a set of
  39 .i ed -\c
  40 like commands for manipulating messages and sending mail.
  41 .i Mail
  42 offers the user simple editing capabilities to ease the composition
  43 of outgoing messages, as well as providing the ability to define and send
  44 to names which address groups of users.  Finally,
  45 .i Mail
  46 is able to send and receive messages across such networks as the
  47 ARPANET, UUCP, and Berkeley network.
  48 .pp
  49 This document describes how to use the
  50 .i Mail
  51 program to send and receive messages.  The reader is not assumed to
  52 be familiar with other message handling systems, but should be
  53 familiar with the \s-2UNIX\s0\**
  54 .(f
  55 \** \s-1UNIX\s0 is a trademark of Bell Laboratories.
  56 .)f
  57 shell, the text editor, and some of the common \s-2UNIX\s0 commands.
  58 .q "The \s-2UNIX\s0 Programmer's Manual,"
  59 .q "An Introduction to Csh,"
  60 and
  61 .q "Text Editing with Ex and Vi"
  62 can be consulted for more information on these topics.
  63 .pp
  64 Here is how messages are handled:
  65 the mail system accepts incoming
  66 .i messages
  67 for you from other people
  68 and collects them in a file, called your
  69 .i "system mailbox" .
  70 When you login, the system notifies you if there are any messages
  71 waiting in your system mailbox.  If you are a
  72 .i csh
  73 user, you will be notified when new mail arrives if you inform
  74 the shell of the location of your mailbox.  On NetBSD systems,
  75 your system mailbox is located in the directory /var/mail
  76 in a file with your login name.  If your login name is
  77 .q sam,
  78 then you can make
  79 .i csh
  80 notify you of new mail by including the following line in your .cshrc
  81 file:
  82 .(l
  83 set mail=/var/mail/sam
  84 .)l
  85 When you read your mail using
  86 .i Mail ,
  87 it reads your system mailbox and separates that file into the
  88 individual messages that have been sent to you.  You can then
  89 read, reply to, delete, or save these messages.
  90 Each message is marked with its author and the date they sent it.