SCCS-vsn: usr.bin/mail/mail.1 6.19
SCCS-vsn: usr.bin/logger/logger.1 6.8
SCCS-vsn: usr.bin/lock/lock.1 6.9
SCCS-vsn: usr.bin/nohup/nohup.1 6.8
SCCS-vsn: usr.bin/leave/leave.1 6.6
SCCS-vsn: usr.bin/lastcomm/lastcomm.1 6.8
.\" Copyright (c) 1980, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" Copyright (c) 1980, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
-.\" %sccs.include.redist.man%
+.\" %sccs.include.redist.roff%
-.\" @(#)lastcomm.1 6.7 (Berkeley) %G%
+.\" @(#)lastcomm.1 6.8 (Berkeley) %G%
.Sh NAME
.Nm lastcomm
.Nd show last commands executed in reverse order
.Sh SYNOPSIS
.Nm lastcomm
.Op Fl f Ar file
.Sh NAME
.Nm lastcomm
.Nd show last commands executed in reverse order
.Sh SYNOPSIS
.Nm lastcomm
.Op Fl f Ar file
-.Op Ar command \&...
-.Op Ar user \&...
-.Op Ar terminal \&...
+.Op Ar command ...
+.Op Ar user ...
+.Op Ar terminal ...
.Sh DESCRIPTION
.Nm Lastcomm
gives information on previously executed commands.
.Sh DESCRIPTION
.Nm Lastcomm
gives information on previously executed commands.
-.Tw Fl
-.Tp Cx Fl f
-.Ws
-.Ar file
-.Cx
+.Bl -tag -width Fl
+.It Fl f Ar file
Read from
.Ar file
rather than the default
accounting file.
Read from
.Ar file
rather than the default
accounting file.
.Pp
If called with arguments, only accounting entries with a
matching
.Pp
If called with arguments, only accounting entries with a
matching
.Pp
For each process entry, the following are printed.
.Pp
.Pp
For each process entry, the following are printed.
.Pp
+.Bl -bullet -offset indent -compact
+.It
The name of the user who ran the process.
The name of the user who ran the process.
Flags, as accumulated by the accounting facilities in the system.
Flags, as accumulated by the accounting facilities in the system.
The command name under which the process was called.
The command name under which the process was called.
The amount of cpu time used by the process (in seconds).
The amount of cpu time used by the process (in seconds).
The time the process exited.
The time the process exited.
.Pp
The flags are encoded as follows: ``S'' indicates the command was
executed by the super-user, ``F'' indicates the command ran after
.Pp
The flags are encoded as follows: ``S'' indicates the command was
executed by the super-user, ``F'' indicates the command ran after
.Pa core
file, and ``X'' indicates the command was terminated with a signal.
.Sh FILES
.Pa core
file, and ``X'' indicates the command was terminated with a signal.
.Sh FILES
-.Dw /var/account/acct
-.Di L
-.Dp Pa /var/account/acct
-.Dp
+.Bl -tag -width /var/account/acct -compact
+.It Pa /var/account/acct
+Default accounting file.
+.El
.Sh SEE ALSO
.Xr last 1 ,
.Xr sigvec 2 ,
.Xr acct 5 ,
.Xr core 5
.Sh HISTORY
.Sh SEE ALSO
.Xr last 1 ,
.Xr sigvec 2 ,
.Xr acct 5 ,
.Xr core 5
.Sh HISTORY
-.Nm Lastcomm
-appeared in 3 BSD.
+The
+.Nm lastcomm
+command appeared in
+.Bx 3.0 .
.\" Copyright (c) 1980, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" Copyright (c) 1980, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
-.\" %sccs.include.redist.man%
+.\" %sccs.include.redist.roff%
-.\" @(#)leave.1 6.5 (Berkeley) %G%
+.\" @(#)leave.1 6.6 (Berkeley) %G%
.Sh NAME
.Nm leave
.Nd remind you when you have to leave
.Sh SYNOPSIS
.Nm leave
.Sh NAME
.Nm leave
.Nd remind you when you have to leave
.Sh SYNOPSIS
.Nm leave
+.Sm off
+.Oo
+.Op Cm \&+
+.Ns Ar hhmm
+.Oc
+.Sm on
.Sh DESCRIPTION
.Nm Leave
waits until the specified time, then reminds you that you
.Sh DESCRIPTION
.Nm Leave
waits until the specified time, then reminds you that you
+.Bl -tag -width flag
+.It Ar hhmm
The time of day is in the form
.Ar hhmm
where
The time of day is in the form
.Ar hhmm
where
are minutes.
All times are converted to a 12 hour clock, and assumed to
be in the next 12 hours.
are minutes.
All times are converted to a 12 hour clock, and assumed to
be in the next 12 hours.
-.Tp Ic \&+
-If the time is preceeded by `+', the alarm will go off in hours and minutes
+.It Cm \&+
+If the time is preceeded by
+.Ql Cm \&+ ,
+the alarm will go off in hours and minutes
.Pp
If no argument is given,
.Nm leave
.Pp
If no argument is given,
.Nm leave
.Sh SEE ALSO
.Xr calendar 1
.Sh HISTORY
.Sh SEE ALSO
.Xr calendar 1
.Sh HISTORY
-.Nm Leave
-appeared in 3 BSD.
+The
+.Nm leave
+command appeared in
+.Bx 3.0 .
.\" Copyright (c) 1987, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" Copyright (c) 1987, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
-.\" %sccs.include.redist.man%
+.\" %sccs.include.redist.roff%
-.\" @(#)lock.1 6.8 (Berkeley) %G%
+.\" @(#)lock.1 6.9 (Berkeley) %G%
.Sh NAME
.Nm lock
.Nd reserve a terminal
.Sh NAME
.Nm lock
.Nd reserve a terminal
There are two other conditions under which it will terminate: it
will timeout after some interval of time and it may be killed by someone
with the appropriate permission.
There are two other conditions under which it will terminate: it
will timeout after some interval of time and it may be killed by someone
with the appropriate permission.
-.Tw Fl
-.Tc Fl t
-.Ws
-.Ar timeout
-.Cx
+.Bl -tag -width Fl
+.It Fl p
+A password is not requested, instead the user's current login password
+is used.
+.It Fl t Ar timeout
The time limit (default 15 minutes) is changed to
.Ar timeout
minutes.
The time limit (default 15 minutes) is changed to
.Ar timeout
minutes.
-.Tp Fl p
-Causes
-.Nm lock
-to use the user's current password instead of requesting another one.
-.Tp
-.Nm Lock
-appeared in 3 BSD.
+The
+.Nm lock
+command appeared in
+.Bx 3.0 .
.\" Copyright (c) 1983, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" Copyright (c) 1983, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
-.\" %sccs.include.redist.man%
+.\" %sccs.include.redist.roff%
-.\" @(#)logger.1 6.7 (Berkeley) %G%
+.\" @(#)logger.1 6.8 (Berkeley) %G%
.Dd
.Dt LOGGER 1
.Os BSD 4.3
.Dd
.Dt LOGGER 1
.Os BSD 4.3
+.Bl -tag -width "message"
+.It Fl i
Log the process id of the logger process
with each line.
Log the process id of the logger process
with each line.
Log the message to standard error, as well as the system log.
Log the message to standard error, as well as the system log.
-.Tc Fl f
-.Ws
-.Ar file
-.Cx
-.Tc Fl p
-.Ws
-.Ar pri
-.Cx
Enter the message with the specified priority.
The priority may be specified numerically or as a ``facility.level''
pair.
For example, ``\-p local3.info'' logs the message(s) as
Enter the message with the specified priority.
The priority may be specified numerically or as a ``facility.level''
pair.
For example, ``\-p local3.info'' logs the message(s) as
level in the
.Ar local3
facility.
The default is ``user.notice.''
level in the
.Ar local3
facility.
The default is ``user.notice.''
-.Tc Fl t
-.Ws
-.Ar tag
-.Cx
Mark every line in the log with the specified
.Ar tag .
Mark every line in the log with the specified
.Ar tag .
Write the message to log; if not specified, and the
.Fl f
flag is not
provided, standard input is logged.
Write the message to log; if not specified, and the
.Fl f
flag is not
provided, standard input is logged.
.Pp
The
.Nm logger
utility exits 0 on success, and >0 if an error occurs.
.Sh EXAMPLES
.Pp
The
.Nm logger
utility exits 0 on success, and >0 if an error occurs.
.Sh EXAMPLES
-.Pp
-.Dl logger System rebooted
-.Pp
-.Dl logger \-p local0.notice \-t HOSTIDM \-f /dev/idmc
+.Bd -literal -offset indent -compact
+logger System rebooted
+
+logger \-p local0.notice \-t HOSTIDM \-f /dev/idmc
+.Ed
.Sh SEE ALSO
.Xr syslog 3 ,
.Xr syslogd 8
.Sh STANDARDS
.Sh SEE ALSO
.Xr syslog 3 ,
.Xr syslogd 8
.Sh STANDARDS
-The logger function is expected to be POSIX 1003.2 compatible.
+The
+.Nm logger
+command is expected to be
+.St -p1003.2
+compatible.
.\" Copyright (c) 1980, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" Copyright (c) 1980, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
-.\" %sccs.include.redist.man%
+.\" %sccs.include.redist.roff%
-.\" @(#)mail.1 6.18 (Berkeley) %G%
+.\" @(#)mail.1 6.19 (Berkeley) %G%
.Op Fl c Ar cc-addr
.Op Fl b Ar bcc-addr
.Ar to-addr...
.Op Fl c Ar cc-addr
.Op Fl b Ar bcc-addr
.Ar to-addr...
.Nm mail
.Op Fl iInNv
.Fl f
.Op Ar name
.Nm mail
.Op Fl iInNv
.Fl f
.Op Ar name
.Nm mail
.Op Fl iInNv
.Op Fl u Ar user
.Nm mail
.Op Fl iInNv
.Op Fl u Ar user
.Nm Mail
is a intelligent mail processing system, which has
a command syntax reminiscent of
.Nm Mail
is a intelligent mail processing system, which has
a command syntax reminiscent of
with lines replaced by messages.
.Pp
with lines replaced by messages.
.Pp
-.Tw Ds
-.Tp Fl v
-Verbose mode. The details of
+.Bl -tag -width flag
+.It Fl v
+Verbose mode.
+The details of
delivery are displayed on the users terminal.
delivery are displayed on the users terminal.
-.Tp Fl i
-Ignore tty interrupt signals. This is
+.It Fl i
+Ignore tty interrupt signals.
+This is
particularly useful when using
.Nm mail
on noisy phone lines.
particularly useful when using
.Nm mail
on noisy phone lines.
Forces mail to run in interactive mode even when
Forces mail to run in interactive mode even when
-input isn't a terminal. In particular, the
+input isn't a terminal.
+In particular, the
.Sq Ic \&~
special
character when sending mail is only active in interactive mode.
.Sq Ic \&~
special
character when sending mail is only active in interactive mode.
Inhibits reading
.Pa /usr/share/misc/Mail.rc
upon startup.
Inhibits reading
.Pa /usr/share/misc/Mail.rc
upon startup.
Inhibits the initial display of message headers
when reading mail or editing a mail folder.
Inhibits the initial display of message headers
when reading mail or editing a mail folder.
Specify subject on command line
(only the first argument after the
.Fl s
flag is used as a subject; be careful to quote subjects
containing spaces.)
Specify subject on command line
(only the first argument after the
.Fl s
flag is used as a subject; be careful to quote subjects
containing spaces.)
Send carbon copies to
.Ar list
of users.
Send carbon copies to
.Ar list
of users.
Send blind carbon copies to
.Ar list .
List should be a comma-separated list of names.
Send blind carbon copies to
.Ar list .
List should be a comma-separated list of names.
Read in the contents of your
.Ar mbox
(or the specified file)
Read in the contents of your
.Ar mbox
(or the specified file)
.Ar quit ,
.Nm mail
writes undeleted messages back to this file.
.Ar quit ,
.Nm mail
writes undeleted messages back to this file.
.Dl mail -f /var/spool/mail/user
.Dl mail -f /var/spool/mail/user
.Ss Sending mail
To send a message to one or more people,
.Nm mail
can be invoked with arguments which are the names of people to
.Ss Sending mail
To send a message to one or more people,
.Nm mail
can be invoked with arguments which are the names of people to
-whom the mail will be sent. You are then expected to type in
+whom the mail will be sent.
+You are then expected to type in
your message, followed
by an
.Sq Li control\-D
your message, followed
by an
.Sq Li control\-D
and can be printed using the
.Ic print
command (which can be abbreviated
and can be printed using the
.Ic print
command (which can be abbreviated
-.Cx \&(
-.Ic p
-.Cx \&)).
-.Cx
You can move among the messages much as you move between lines in
You can move among the messages much as you move between lines in
moving backwards and forwards, and
simple numbers.
.Pp
.Ss Disposing of mail.
After examining a message you can
.Ic delete
moving backwards and forwards, and
simple numbers.
.Pp
.Ss Disposing of mail.
After examining a message you can
.Ic delete
-.Cx \&(
-.Ic d
-.Cx \&)
-.Cx
-.Cx \&(
-.Ic r
-.Cx \&)
-.Cx
to it.
Deletion causes the
.Nm mail
program to forget about the message.
This is not irreversible; the message can be
.Ic undeleted
to it.
Deletion causes the
.Nm mail
program to forget about the message.
This is not irreversible; the message can be
.Ic undeleted
-.Cx \&(
-.Ic u
-.Cx \&)
-.Cx
by giving its number, or the
.Nm mail
session can be aborted by giving the
.Ic exit
by giving its number, or the
.Nm mail
session can be aborted by giving the
.Ic exit
-.Cx \&(
-.Ic x
-.Cx \&)
-.Cx
command.
Deleted messages will, however, usually disappear never to be seen again.
.Pp
command.
Deleted messages will, however, usually disappear never to be seen again.
.Pp
.Dq Li delete 1\-5
deletes messages 1 through 5.
The special name
.Dq Li delete 1\-5
deletes messages 1 through 5.
The special name
addresses all messages, and
addresses all messages, and
addresses
the last message; thus the command
.Ic top
addresses
the last message; thus the command
.Ic top
While you are composing a message,
.Nm mail
treats lines beginning with the character
While you are composing a message,
.Nm mail
treats lines beginning with the character
specially.
For instance, typing
specially.
For instance, typing
(alone on a line) will place a copy
of the current message into the response right shifting it by a tabstop
(see
(alone on a line) will place a copy
of the current message into the response right shifting it by a tabstop
(see
variable, below).
Other escapes will set up subject fields, add and delete recipients
to the message and allow you to escape to an editor to revise the
variable, below).
Other escapes will set up subject fields, add and delete recipients
to the message and allow you to escape to an editor to revise the
-message or to a shell to run some commands. (These options
+message or to a shell to run some commands.
+(These options
are given in the summary below.)
.Pp
.Ss Ending a mail processing session.
are given in the summary below.)
.Pp
.Ss Ending a mail processing session.
.Nm mail
session with the
.Ic quit
.Nm mail
session with the
.Ic quit
-.Cx \&(
-.Ic q
-.Cx \&)
-.Cx
command.
Messages which have been examined go to your
.Ar mbox
file unless they have been deleted in which case they are discarded.
command.
Messages which have been examined go to your
.Ar mbox
file unless they have been deleted in which case they are discarded.
-Unexamined messages go back to the post office. (See the
+Unexamined messages go back to the post office.
+(See the
.Pp
.Nm Mail
has a number of options which can be set in the
.Pp
.Nm Mail
has a number of options which can be set in the
file to alter its behavior; thus
.Dq Li set askcc
enables the
.Ar askcc
file to alter its behavior; thus
.Dq Li set askcc
enables the
.Ar askcc
-feature. (These options are summarized below.)
+feature.
+(These options are summarized below.)
.Sh SUMMARY
(Adapted from the `Mail Reference Manual')
.Pp
Each command is typed on a line by itself, and may take arguments
.Sh SUMMARY
(Adapted from the `Mail Reference Manual')
.Pp
Each command is typed on a line by itself, and may take arguments
-following the command word. The command need not be typed in its
+following the command word.
+The command need not be typed in its
entirety \- the first command which matches the typed prefix is used.
For commands which take message lists as arguments, if no message
list is given, then the next message forward which satisfies the
entirety \- the first command which matches the typed prefix is used.
For commands which take message lists as arguments, if no message
list is given, then the next message forward which satisfies the
-command's requirements is used. If there are no messages forward of
+command's requirements is used.
+If there are no messages forward of
the current message, the search proceeds backwards, and if there are no
good messages at all,
.Nm mail
the current message, the search proceeds backwards, and if there are no
good messages at all,
.Nm mail
.Dq Li No applicable messages
and
aborts the command.
.Dq Li No applicable messages
and
aborts the command.
-.Tp Ic \&\-
-Print out the preceding message. If given a numeric
+.Bl -tag -width delete
+.It Ic \&\-
+Print out the preceding message.
+If given a numeric
argument
.Ar n ,
goes to the
argument
.Ar n ,
goes to the
previous message and prints it.
previous message and prints it.
Prints a brief summary of commands.
Prints a brief summary of commands.
Executes the shell
(see
.Xr sh 1
and
.Xr csh 1 )
command which follows.
Executes the shell
(see
.Xr sh 1
and
.Xr csh 1 )
command which follows.
-.Tp Ic Print
-.Cx \&(
-.Ic P
-.Cx \&)
-.Cx
-but also prints out ignored header fields. See also
+but also prints out ignored header fields.
+See also
.Ic print ,
.Ic ignore
and
.Ic retain .
.Ic print ,
.Ic ignore
and
.Ic retain .
-.Tp Ic Reply
-.Cx \&(
-.Ic R
-.Cx \&)
-.Cx
-Reply to originator. Does not reply to other
+.It Ic Reply
+.Pq Ic R
+Reply to originator.
+Does not reply to other
recipients of the original message.
recipients of the original message.
-.Tp Ic Type
-.Cx \&(
-.Ic T
-.Cx \&)
-.Cx
Identical to the
.Ic Print
command.
Identical to the
.Ic Print
command.
-.Tp Ic alias
-.Cx \&(
-.Ic a
-.Cx \&)
-.Cx
-With no arguments, prints out all currently-defined aliases. With one
-argument, prints out that alias. With more than one argument, creates
+.It Ic alias
+.Pq Ic a
+With no arguments, prints out all currently-defined aliases.
+With one
+argument, prints out that alias.
+With more than one argument, creates
a new alias or changes an old one.
a new alias or changes an old one.
-.Tp Ic alternates
-.Cx \&(
-.Ic alt
-.Cx \&)
-.Cx
+.It Ic alternates
+.Pq Ic alt
The
.Ic alternates
command is useful if you have accounts on several machines.
It can be used to inform
.Nm mail
The
.Ic alternates
command is useful if you have accounts on several machines.
It can be used to inform
.Nm mail
-that the listed addresses are really you. When you
+that the listed addresses are really you.
+When you
.Ic reply
to messages,
.Nm mail
will not send a copy of the message to any of the addresses
listed on the
.Ic alternates
.Ic reply
to messages,
.Nm mail
will not send a copy of the message to any of the addresses
listed on the
.Ic alternates
.Ic alternates
command is given with no argument, the current set of alternate
names is displayed.
.Ic alternates
command is given with no argument, the current set of alternate
names is displayed.
-.Tp Ic chdir
-.Cx \&(
-.Ic c
-.Cx \&)
-.Cx
-Changes the user's working directory to that specified, if given. If
+.It Ic chdir
+.Pq Ic c
+Changes the user's working directory to that specified, if given.
+If
no directory is given, then changes to the user's login directory.
no directory is given, then changes to the user's login directory.
-.Tp Ic copy
-.Cx \&(
-.Ic co
-.Cx \&)
-.Cx
The
.Ic copy
command does the same thing that
.Ic save
does, except that it does not mark the messages it
is used on for deletion when you quit.
The
.Ic copy
command does the same thing that
.Ic save
does, except that it does not mark the messages it
is used on for deletion when you quit.
-.Tp Ic delete
-.Cx \&(
-.Ic d
-.Cx \&)
-.Cx
Takes a list of messages as argument and marks them all as deleted.
Deleted messages will not be saved in
.Ar mbox ,
nor will they be available for most other commands.
Takes a list of messages as argument and marks them all as deleted.
Deleted messages will not be saved in
.Ar mbox ,
nor will they be available for most other commands.
(also
.Ic dt )
Deletes the current message and prints the next message.
If there is no next message,
.Nm mail
says
(also
.Ic dt )
Deletes the current message and prints the next message.
If there is no next message,
.Nm mail
says
-.Dq Li at EOF.
-.Tp Ic edit
-.Cx \&(
-.Ic e
-.Cx \&)
-.Cx
+.Dq Li "at EOF" .
+.It Ic edit
+.Pq Ic e
Takes a list of messages and points the text editor at each one in
Takes a list of messages and points the text editor at each one in
-turn. On return from the editor, the message is read back in.
-.Tp Ic exit
-.Cx \&(
-.Ic ex
-.Cx
+turn.
+On return from the editor, the message is read back in.
+.It Ic exit
+.Pf ( Ic ex
or
.Ic x )
Effects an immediate return to the Shell without
or
.Ic x )
Effects an immediate return to the Shell without
.Ar mbox
file, or his edit file in
.Fl f .
.Ar mbox
file, or his edit file in
.Fl f .
-.Tp Ic file
-.Cx \&(
-.Ic fi
-.Cx )
-.Cx
List the names of the folders in your folder directory.
List the names of the folders in your folder directory.
-.Tp Ic folder
-.Cx \&(
-.Ic fo
-.Cx \&)
-.Cx
+.It Ic folder
+.Pq Ic fo
-command switches to a new mail file or folder. With no
+command switches to a new mail file or folder.
+With no
arguments, it tells you which file you are currently reading.
If you give it an argument, it will write out changes (such
as deletions) you have made in the current file and read in
arguments, it tells you which file you are currently reading.
If you give it an argument, it will write out changes (such
as deletions) you have made in the current file and read in
-the new file. Some special conventions are recognized for
-the name. # means the previous file, % means your system
+the new file.
+Some special conventions are recognized for
+the name.
+# means the previous file, % means your system
mailbox, %user means user's system mailbox, & means
your
.Ar mbox
mailbox, %user means user's system mailbox, & means
your
.Ar mbox
-file, and +folder means a file in your folder
+file, and
+\&+\&folder means a file in your folder
-.Tp Ic from
-.Cx \&(
-.Ic f
-.Cx \&)
-.Cx
Takes a list of messages and prints their message headers.
Takes a list of messages and prints their message headers.
-.Tp Ic headers
-.Cx \&(
-.Ic h
-.Cx \&)
-.Cx
-Lists the current range of headers, which is an 18\-message group. If
+.It Ic headers
+.Pq Ic h
+Lists the current range of headers, which is an 18\-message group.
+If
argument is given, then the next 18\-message group is printed, and if
a
argument is given, then the next 18\-message group is printed, and if
a
argument is given, the previous 18\-message group is printed.
argument is given, the previous 18\-message group is printed.
-.Tp Ic hold
-.Cx \&(
-.Ic ho ,
-.Cx
+.It Ic hold
+.Pf ( Ic ho ,
also
.Ic preserve )
Takes a message list and marks each
also
.Ic preserve )
Takes a message list and marks each
Does not override the
.Ic delete
command.
Does not override the
.Ic delete
command.
Add the list of header fields named to the
.Ar ignored list
Header fields in the ignore list are not printed
Add the list of header fields named to the
.Ar ignored list
Header fields in the ignore list are not printed
-on your terminal when you print a message. This
+on your terminal when you print a message.
+This
command is very handy for suppression of certain machine-generated
command is very handy for suppression of certain machine-generated
.Ic Type
and
.Ic Print
commands can be used to print a message in its entirety, including
.Ic Type
and
.Ic Print
commands can be used to print a message in its entirety, including
.Ic ignore
is executed with no arguments, it lists the current set of
ignored fields.
.Ic ignore
is executed with no arguments, it lists the current set of
ignored fields.
-.Tp Ic mail
-.Cx \&(
-.Ic m
-.Cx \&)
-.Cx
Takes as argument login names and distribution group names and sends
mail to those people.
Takes as argument login names and distribution group names and sends
mail to those people.
Indicate that a list of messages be sent to
.Ic mbox
Indicate that a list of messages be sent to
.Ic mbox
-in your home directory when you quit. This is the default
+in your home directory when you quit.
+This is the default
action for messages if you do
.Em not
have the
.Ic hold
option set.
action for messages if you do
.Em not
have the
.Ic hold
option set.
-.Tp Ic next
-.Cx \&(
-.Ic n
-.Cx
-or CR) Goes to the next message in sequence and types it.
+or
+.Tn CR )
+Goes to the next message in sequence and types it.
With an argument list, types the next matching message.
With an argument list, types the next matching message.
-.Tp Ic preserve
-.Cx \&(
-.Ic pre
-.Cx \&)
-.Cx
+.It Ic preserve
+.Pq Ic pre
-.Tp Ic print
-.Cx \&(
-.Ic p
-.Cx \&)
-.Cx
Takes a message list and types out each message on the user's terminal.
Takes a message list and types out each message on the user's terminal.
-.Tp Ic quit
-.Cx \&(
-.Ic q
-.Cx \&)
-.Cx
Terminates the session, saving all undeleted, unsaved messages in
the user's
.Ar mbox
Terminates the session, saving all undeleted, unsaved messages in
the user's
.Ar mbox
.Ic preserve
or never referenced
in his system mailbox, and removing all other messages from his system
.Ic preserve
or never referenced
in his system mailbox, and removing all other messages from his system
-mailbox. If new mail has arrived during the session, the message
-.Dq Li You have new mail
-is given. If given while editing a
+mailbox.
+If new mail has arrived during the session, the message
+.Dq Li "You have new mail"
+is given.
+If given while editing a
mailbox file with the
.Fl f
mailbox file with the
.Fl f
-flag, then the edit file is rewritten. A return to the Shell is
+flag, then the edit file is rewritten.
+A return to the Shell is
effected, unless the rewrite of edit file fails, in which case the user
can escape with the
.Ic exit
command.
effected, unless the rewrite of edit file fails, in which case the user
can escape with the
.Ic exit
command.
-.Tp Ic reply
-.Cx \&(
-.Ic r
-.Cx \&)
-.Cx
Takes a message list and sends mail to the sender and all
recipients of the specified message.
The default message must not be deleted.
Takes a message list and sends mail to the sender and all
recipients of the specified message.
The default message must not be deleted.
A synonym for
.Ic reply .
A synonym for
.Ic reply .
Add the list of header fields named to the
.Ar retained list
Only the header fields in the retain list
Add the list of header fields named to the
.Ar retained list
Only the header fields in the retain list
.Ic retain
is executed with no arguments, it lists the current set of
retained fields.
.Ic retain
is executed with no arguments, it lists the current set of
retained fields.
-.Tp Ic save
-.Cx \&(
-.Ic s
-.Cx \&)
-.Cx
Takes a message list and a filename and appends each message in
Takes a message list and a filename and appends each message in
-turn to the end of the file. The filename in quotes, followed by the line
+turn to the end of the file.
+The filename in quotes, followed by the line
count and character count is echoed on the user's terminal.
count and character count is echoed on the user's terminal.
-.Tp Ic set
-.Cx \&(
-.Ic se
-.Cx \&)
-.Cx
-With no arguments, prints all variable values. Otherwise, sets
-option. Arguments are of the form
+.It Ic set
+.Pq Ic se
+With no arguments, prints all variable values.
+Otherwise, sets
+option.
+Arguments are of the form
.Ar option=value
(no space before or after =) or
.Ar option .
Quotation marks may be placed around any part of the assignment statement to
quote blanks or tabs, i.e.
.Ar option=value
(no space before or after =) or
.Ar option .
Quotation marks may be placed around any part of the assignment statement to
quote blanks or tabs, i.e.
-.Dq Li set indentprefix="->"
-.Tp Ic saveignore
+.Dq Li "set indentprefix=\*q->\*q"
+.It Ic saveignore
.Ic Saveignore
is to
.Ic save
.Ic Saveignore
is to
.Ic save
.Ic save
or when automatically saving to
.Ar mbox .
.Ic save
or when automatically saving to
.Ar mbox .
.Ic Saveretain
is to
.Ic save
.Ic Saveretain
is to
.Ic save
.Ic Saveretain
overrides
.Ic saveignore .
.Ic Saveretain
overrides
.Ic saveignore .
-.Tp Ic shell
-.Cx \&(
-.Ic sh
-.Cx \&)
-.Cx
Invokes an interactive version of the shell.
Invokes an interactive version of the shell.
Takes a message list and prints out the size in characters of each
message.
Takes a message list and prints out the size in characters of each
message.
-.Tp Ic source
-.Cx \&(
-.Ic so
-.Cx \&)
The
.Ic source
command reads
The
.Ic source
command reads
-.Tp Ic top
-Takes a message list and prints the top few lines of each. The number of
+.It Ic top
+Takes a message list and prints the top few lines of each.
+The number of
lines printed is controlled by the variable
.Ic toplines
and defaults to five.
lines printed is controlled by the variable
.Ic toplines
and defaults to five.
-.Tp Ic type
-.Cx \&(
-.Ic t
-.Cx \&)
-.Cx
A synonym for
.Ic print .
A synonym for
.Ic print .
Takes a list of names defined by
.Ic alias
Takes a list of names defined by
.Ic alias
-commands and discards the remembered groups of users. The group names
+commands and discards the remembered groups of users.
+The group names
no longer have any significance.
no longer have any significance.
-.Tp Ic undelete
-.Cx \&(
-.Ic u
-.Cx \&)
-.Cx
+.It Ic undelete
+.Pq Ic u
Takes a message list and marks each message as
.Ic not
being deleted.
Takes a message list and marks each message as
.Ic not
being deleted.
-.Tp Ic unread
-.Cx \&(
-.Ic U
-.Cx \&)
-.Cx
Takes a message list and marks each message as
.Ic not
having been read.
Takes a message list and marks each message as
.Ic not
having been read.
Takes a list of option names and discards their remembered values;
the inverse of
.Ic set .
Takes a list of option names and discards their remembered values;
the inverse of
.Ic set .
-.Tp Ic visual
-.Cx \&(
-.Ic v
-.Cx \&)
-.Cx
Takes a message list and invokes the display editor on each message.
Takes a message list and invokes the display editor on each message.
-.Tp Ic write
-.Cx \&(
-.Ic w
-.Cx \&)
-.Cx
Similar to
.Ic save ,
except that
.Ic only
the message body
Similar to
.Ic save ,
except that
.Ic only
the message body
-.Cx \&(
-.Ar without
-.Cx
the header) is saved.
Extremely useful for such tasks as sending and receiving source
program text over the message system.
the header) is saved.
Extremely useful for such tasks as sending and receiving source
program text over the message system.
-.Tp Ic xit
-.Cx \&(
-.Ic x
-.Cx \&)
-.Cx
.Nm Mail
presents message headers in windowfuls as described under the
.Ic headers
.Nm Mail
presents message headers in windowfuls as described under the
.Ic headers
-command. You can move
-.Cx Nm mail
-.Cx 's
-.Cx
+command.
+You can move
+.Nm mail Ns 's
attention forward to the next window with the
.Ic \&z
attention forward to the next window with the
.Ic \&z
-command. Also, you can move to the previous window by using
+command.
+Also, you can move to the previous window by using
.Ss Tilde/Escapes
.Pp
Here is a summary of the tilde escapes,
which are used when composing messages to perform
.Ss Tilde/Escapes
.Pp
Here is a summary of the tilde escapes,
which are used when composing messages to perform
-special functions. Tilde escapes are only recognized at the beginning
-of lines. The name
+special functions.
+Tilde escapes are only recognized at the beginning
+of lines.
+The name
.Dq Em tilde\ escape
is somewhat of a misnomer since the actual escape character can be set
by the option
.Ic escape .
.Dq Em tilde\ escape
is somewhat of a misnomer since the actual escape character can be set
by the option
.Ic escape .
-.Tw Ds
-.Tp Cx Ic \&~!
-.Ar command
-.Cx
+.Bl -tag -width Ds
+.It Ic \&~! Ns Ar command
Execute the indicated shell command, then return to the message.
Execute the indicated shell command, then return to the message.
-.Tp Cx Ic \&~b
-.Ar name ...
-.Cx
+.It Ic \&~b Ns Ar name ...
Add the given names to the list of carbon copy recipients but do not make
the names visible in the Cc: line ("blind" carbon copy).
Add the given names to the list of carbon copy recipients but do not make
the names visible in the Cc: line ("blind" carbon copy).
-.Tp Cx Ic \&~c
-.Ar name ...
-.Cx
+.It Ic \&~c Ns Ar name ...
Add the given names to the list of carbon copy recipients.
Add the given names to the list of carbon copy recipients.
Read the file
.Dq Pa dead.letter
from your home directory into the message.
Read the file
.Dq Pa dead.letter
from your home directory into the message.
-.Tp Ic \&~e
-Invoke the text editor on the message collected so far. After the
+.It Ic \&~e
+Invoke the text editor on the message collected so far.
+After the
editing session is finished, you may continue appending text to the
message.
editing session is finished, you may continue appending text to the
message.
-.Tp Cx Ic \&~f
-.Ar messages
-.Cx
+.It Ic \&~f Ns Ar messages
Read the named messages into the message being sent.
If no messages are specified, read in the current message.
Message headers currently being ignored (by the
Read the named messages into the message being sent.
If no messages are specified, read in the current message.
Message headers currently being ignored (by the
or
.Ic retain
command) are not included.
or
.Ic retain
command) are not included.
-.Tp Cx Ic \&~F
-.Ar messages
-.Cx
+.It Ic \&~F Ns Ar messages
Identical to
.Ic \&~f ,
except all message headers are included.
Identical to
.Ic \&~f ,
except all message headers are included.
Edit the message header fields by typing each one in turn and allowing
the user to append text to the end or modify the field by using the
current terminal erase and kill characters.
Edit the message header fields by typing each one in turn and allowing
the user to append text to the end or modify the field by using the
current terminal erase and kill characters.
-.Tp Cx Ic \&~m
-.Ar messages
-.Cx
+.It Ic \&~m Ns Ar messages
Read the named messages into the message being sent, indented by a
tab or by the value of
.Ar indentprefix .
Read the named messages into the message being sent, indented by a
tab or by the value of
.Ar indentprefix .
or
.Ic retain
command) are not included.
or
.Ic retain
command) are not included.
-.Tp Cx Ic \&~M
-.Ar messages
-.Cx
+.It Ic \&~M Ns Ar messages
Identical to
.Ic \&~m ,
except all message headers are included.
Identical to
.Ic \&~m ,
except all message headers are included.
Print out the message collected so far, prefaced by the message header
fields.
Print out the message collected so far, prefaced by the message header
fields.
Abort the message being sent, copying the message to
.Dq Pa dead.letter
in your home directory if
.Ic save
is set.
Abort the message being sent, copying the message to
.Dq Pa dead.letter
in your home directory if
.Ic save
is set.
-.Tp Cx Ic \&~r
-.Ar filename
-.Cx
+.It Ic \&~r Ns Ar filename
Read the named file into the message.
Read the named file into the message.
-.Tp Cx Ic \&~s
-.Ar string
-.Cx
+.It Ic \&~s Ns Ar string
Cause the named string to become the current subject field.
Cause the named string to become the current subject field.
-.Tp Cx Ic \&~\&t
-.Ar name ...
-.Cx
+.It Ic \&~\&t Ns Ar name ...
Add the given names to the direct recipient list.
Add the given names to the direct recipient list.
-.\" This .br should have to be here
-.br
-.Tp Ic \&~\&v
-Invoke an alternate editor (defined by the VISUAL option) on the
-message collected so far. Usually, the alternate editor will be a
-screen editor. After you quit the editor, you may resume appending
+.It Ic \&~\&v
+Invoke an alternate editor (defined by the
+.Ev VISUAL
+option) on the
+message collected so far.
+Usually, the alternate editor will be a
+screen editor.
+After you quit the editor, you may resume appending
text to the end of your message.
text to the end of your message.
-.Tp Cx Ic \&~w
-.Ar filename
-.Cx
+.It Ic \&~w Ns Ar filename
Write the message onto the named file.
Write the message onto the named file.
-.Tp Cx Ic \&~\&|
-.Ar command
-.Cx
-Pipe the message through the command as a filter. If the command gives
+.It Ic \&~\&| Ns Ar command
+Pipe the message through the command as a filter.
+If the command gives
no output or terminates abnormally, retain the original text of the
no output or terminates abnormally, retain the original text of the
-message. The command
-.Xr fmt 1
+message.
+The command
+.Xr fmt 1
is often used as
.Ic command
to rejustify the message.
is often used as
.Ic command
to rejustify the message.
-.Tp Cx Ic \&~:
-.Ar mail-command
-.Cx
-Execute the given mail command. Not all commands, however, are allowed.
-.Tp Cx Ic \&~~
-.Ar string
-.Cx
-Insert the string of text in the message prefaced by a single ~. If
+.It Ic \&~: Ns Ar mail-command
+Execute the given mail command.
+Not all commands, however, are allowed.
+.It Ic \&~~ Ns Ar string
+Insert the string of text in the message prefaced by a single ~.
+If
you have changed the escape character, then you should double
that character in order to send it.
you have changed the escape character, then you should double
that character in order to send it.
.Ss Mail Options
Options are controlled via
.Ic set
and
.Ic unset
.Ss Mail Options
Options are controlled via
.Ic set
and
.Ic unset
-commands. Options may be either binary, in which case it is only
+commands.
+Options may be either binary, in which case it is only
significant to see whether they are set or not; or string, in which
case the actual value is of interest.
The binary options include the following:
significant to see whether they are set or not; or string, in which
case the actual value is of interest.
The binary options include the following:
+.Bl -tag -width append
+.It Ar append
Causes messages saved in
.Ar mbox
to be appended to the end rather than prepended.
This should always be set (perhaps in
.Pa /usr/share/misc/Mail.rc ) .
Causes messages saved in
.Ar mbox
to be appended to the end rather than prepended.
This should always be set (perhaps in
.Pa /usr/share/misc/Mail.rc ) .
-to prompt you for the subject of each message you send. If
+to prompt you for the subject of each message you send.
+If
you respond with simply a newline, no subject field will be sent.
you respond with simply a newline, no subject field will be sent.
Causes you to be prompted for additional carbon copy recipients at the
Causes you to be prompted for additional carbon copy recipients at the
-end of each message. Responding with a newline indicates your
+end of each message.
+Responding with a newline indicates your
satisfaction with the current list.
satisfaction with the current list.
Causes the
.Ic delete
command to behave like
.Ic dp
\- thus, after deleting a message, the next one will be typed
automatically.
Causes the
.Ic delete
command to behave like
.Ic dp
\- thus, after deleting a message, the next one will be typed
automatically.
Setting the binary option
.Ar debug
is the same as specifying
Setting the binary option
.Ar debug
is the same as specifying
.Nm mail
to output all sorts of information useful for debugging
.Nm mail .
.Nm mail
to output all sorts of information useful for debugging
.Nm mail .
The binary option
.Ar dot
causes
.Nm mail
to interpret a period alone on a line as the terminator
of a message you are sending.
The binary option
.Ar dot
causes
.Nm mail
to interpret a period alone on a line as the terminator
of a message you are sending.
This option is used to hold messages in the system mailbox
by default.
This option is used to hold messages in the system mailbox
by default.
Causes interrupt signals from your terminal to be ignored and echoed as
@'s.
Causes interrupt signals from your terminal to be ignored and echoed as
@'s.
An option related to
.Ar dot
is
An option related to
.Ar dot
is
also applies to
.Nm mail
command mode.
also applies to
.Nm mail
command mode.
Usually, when a group is expanded that contains the sender, the sender
Usually, when a group is expanded that contains the sender, the sender
-is removed from the expansion. Setting this option causes the sender
+is removed from the expansion.
+Setting this option causes the sender
to be included in the group.
to be included in the group.
Setting the option
.Ar noheader
is the same as giving the
.Fl N
flag on the command line.
Setting the option
.Ar noheader
is the same as giving the
.Fl N
flag on the command line.
Normally, when you abort a message with two
Normally, when you abort a message with two
(erase or delete)
.Nm mail
copies the partial letter to the file
.Dq Pa dead.letter
(erase or delete)
.Nm mail
copies the partial letter to the file
.Dq Pa dead.letter
-in your home directory. Setting the binary option
+in your home directory.
+Setting the binary option
.Ar nosave
prevents this.
.Ar nosave
prevents this.
Reverses the sense of
.Ic reply
and
.Ic Reply
commands.
Reverses the sense of
.Ic reply
and
.Ic Reply
commands.
Suppresses the printing of the version when first invoked.
Suppresses the printing of the version when first invoked.
Setting the option
.Ar verbose
is the same as using the
.Fl v
Setting the option
.Ar verbose
is the same as using the
.Fl v
-flag on the command line. When mail runs in verbose mode,
+flag on the command line.
+When mail runs in verbose mode,
the actual delivery of messages is displayed on he users
terminal.
the actual delivery of messages is displayed on he users
terminal.
+.Bl -tag -width Va
+.It Ev EDITOR
Pathname of the text editor to use in the
.Ic edit
command and
.Ic \&~e
Pathname of the text editor to use in the
.Ic edit
command and
.Ic \&~e
-escape. If not defined, then a default editor is used.
-.Tp Va LISTER
+escape.
+If not defined, then a default editor is used.
+.It Ev LISTER
Pathname of the directory lister to use in the
.Ic folders
Pathname of the directory lister to use in the
.Ic folders
Pathname of the program to use in the
.Ic more
command or when
.Ic crt
Pathname of the program to use in the
.Ic more
command or when
.Ic crt
-variable is set. The default paginator
+variable is set.
+The default paginator
.Xr more 1
is used if this option is not defined.
.Xr more 1
is used if this option is not defined.
Pathname of the shell to use in the
.Ic \&!
command and the
.Ic \&~!
Pathname of the shell to use in the
.Ic \&!
command and the
.Ic \&~!
-escape. A default shell is used if this option is
+escape.
+A default shell is used if this option is
Pathname of the text editor to use in the
.Ic visual
command and
.Ic \&~v
escape.
Pathname of the text editor to use in the
.Ic visual
command and
.Ic \&~v
escape.
The valued option
.Va crt
is used as a threshold to determine how long a message must
be before
The valued option
.Va crt
is used as a threshold to determine how long a message must
be before
-.Va PAGER
-is used to read it. If
+.Ev PAGER
+is used to read it.
+If
.Va crt
is set without a value,
then the height of the terminal screen stored in the system
is used to compute the threshold (see
.Xr stty 1 ) .
.Va crt
is set without a value,
then the height of the terminal screen stored in the system
is used to compute the threshold (see
.Xr stty 1 ) .
If defined, the first character of this option gives the character to
use in the place of ~ to denote escapes.
If defined, the first character of this option gives the character to
use in the place of ~ to denote escapes.
The name of the directory to use for storing folders of
The name of the directory to use for storing folders of
-messages. If this name begins with a `/',
+messages.
+If this name begins with a `/',
.Nm mail
considers it to be an absolute pathname; otherwise, the
folder directory is found relative to your home directory.
.Nm mail
considers it to be an absolute pathname; otherwise, the
folder directory is found relative to your home directory.
-file. It can be the name of a folder.
+file.
+It can be the name of a folder.
The default is
.Dq Li mbox
in the user's home directory.
The default is
.Dq Li mbox
in the user's home directory.
If defined, gives the pathname of the file used to record all outgoing
If defined, gives the pathname of the file used to record all outgoing
-mail. If not defined, then outgoing mail is not so saved.
-.Tp Ar indentprefix
+mail.
+If not defined, then outgoing mail is not so saved.
+.It Ar indentprefix
String used by the ``~m'' tilde escape for indenting messages, in place of
String used by the ``~m'' tilde escape for indenting messages, in place of
-the normal tab character (^I). Be sure to quote the value if it contains
+the normal tab character (^I).
+Be sure to quote the value if it contains
If defined, gives the number of lines of a message to be printed out
with the
.Ic top
command; normally, the first five lines are printed.
If defined, gives the number of lines of a message to be printed out
with the
.Ic top
command; normally, the first five lines are printed.
.Sh ENVIRONMENT
.Nm Mail
utilizes the
.Sh ENVIRONMENT
.Nm Mail
utilizes the
.Ev USER
environment variables.
.Sh FILES
.Ev USER
environment variables.
.Sh FILES
-.Dw /usr/share/misc/Mail.help*
-.Di L
-.Dp Pa /var/spool/mail/*
-post office
-.Dp ~/mbox
-your old mail
-.Dp ~/.mailrc
-file giving initial mail commands
-.Dp Pa /tmp/R*
-temporary files
-.Dp Pa /usr/share/misc/Mail.help*
-help files
-.Dp Pa /usr/share/misc/Mail.rc
-system initialization file
-.Dp
+.Bl -tag -width /usr/share/misc/Mail.help* -compact
+.It Pa /var/spool/mail/*
+Post office.
+.It ~/mbox
+User's old mail.
+.It ~/.mailrc
+File giving initial mail commands.
+.It Pa /tmp/R*
+Temporary files.
+.It Pa /usr/share/misc/Mail.help*
+Help files.
+.It Pa /usr/share/misc/Mail.rc
+System initialization file.
+.El
.Sh SEE ALSO
.Xr fmt 1 ,
.Xr newaliases 1 ,
.Sh SEE ALSO
.Xr fmt 1 ,
.Xr newaliases 1 ,
.Xr mailaddr 7 ,
.Xr sendmail 8
and
.Xr mailaddr 7 ,
.Xr sendmail 8
and
-.Em The Mail Reference Manual .
+.Rs
+.%T "The Mail Reference Manual" .
+.Re
.Sh HISTORY
A
.Nm mail
command
.Sh HISTORY
A
.Nm mail
command
-appeared in Version 6 AT&T UNIX.
This man page is derived from
This man page is derived from
-.Em The Mail Reference Manual
+.%T "The Mail Reference Manual"
originally written by Kurt Shoens.
.Sh BUGS
originally written by Kurt Shoens.
.Sh BUGS
-There are some flags that are not documented here. Most are
+There are some flags that are not documented here.
+Most are
not useful to the general user.
.Pp
Usually,
not useful to the general user.
.Pp
Usually,
.\" This code is derived from software contributed to Berkeley by
.\" the Institute of Electrical and Electronics Engineers, Inc.
.\"
.\" This code is derived from software contributed to Berkeley by
.\" the Institute of Electrical and Electronics Engineers, Inc.
.\"
-.\" %sccs.include.redist.man%
+.\" %sccs.include.redist.roff%
-.\" @(#)nohup.1 6.7 (Berkeley) %G%
+.\" @(#)nohup.1 6.8 (Berkeley) %G%
.Sh NAME
.Nm nohup
.Nd invoke a command immune to hangups
.Sh NAME
.Nm nohup
.Nd invoke a command immune to hangups
.Ar command
with
its arguments
.Ar command
with
its arguments
-and at this time sets the signal SIGHUP
-to be ignored. The signal SIGQUIT may also be set
+and at this time sets the signal
+.Dv SIGHUP
+to be ignored. The signal
+.Dv SIGQUIT
+may also be set
to be ignored.
If the standard output is a terminal, the standard output is
appended to the file
to be ignored.
If the standard output is a terminal, the standard output is
appended to the file
.Sh ENVIRONMENT
The following variable is utilized by
.Nm nohup .
.Sh ENVIRONMENT
The following variable is utilized by
.Nm nohup .
+.Bl -tag -width flag
+.It Ev HOME
If the output file
.Pa nohup.out
cannot be created in the current directory, the
If the output file
.Pa nohup.out
cannot be created in the current directory, the
utility uses the directory named by
.Ev HOME
to create the file.
utility uses the directory named by
.Ev HOME
to create the file.
.Sh SEE ALSO
.Xr signal 3
.Sh STANDARDS
.Sh SEE ALSO
.Xr signal 3
.Sh STANDARDS
-The nohup function is expected to be POSIX 1003.2 compatible.
+The
+.Nm nohup
+command is expected to be
+.St -p1003.2
+compatible.