4.4BSD snapshot (revision 8.1); add 1993 to copyright
[unix-history] / usr / src / usr.bin / leave / leave.1
CommitLineData
71d70af7
KB
1.\" Copyright (c) 1980, 1990, 1993
2.\" The Regents of the University of California. All rights reserved.
7219bb74 3.\"
b14a7a4a 4.\" %sccs.include.redist.roff%
7219bb74 5.\"
71d70af7 6.\" @(#)leave.1 8.1 (Berkeley) %G%
d9d7a9f0
CL
7.\"
8.Dd
9.Dt LEAVE 1
b14a7a4a 10.Os
d9d7a9f0
CL
11.Sh NAME
12.Nm leave
13.Nd remind you when you have to leave
14.Sh SYNOPSIS
15.Nm leave
b14a7a4a
CL
16.Sm off
17.Oo
18.Op Cm \&+
19.Ns Ar hhmm
20.Oc
21.Sm on
d9d7a9f0
CL
22.Sh DESCRIPTION
23.Nm Leave
7219bb74
KM
24waits until the specified time, then reminds you that you
25have to leave.
26You are reminded 5 minutes and 1 minute before the actual
27time, at the time, and every minute thereafter.
28When you log off,
d9d7a9f0 29.Nm leave
7219bb74
KM
30exits just before it would have
31printed the next message.
d9d7a9f0 32.Pp
5325ced3
CL
33Options:
34.Pp
b14a7a4a
CL
35.Bl -tag -width flag
36.It Ar hhmm
5325ced3
CL
37The time of day is in the form
38.Ar hhmm
39where
40.Ar hh
41is a time in
42hours (on a 12 or 24 hour clock), and
43.Ar mm
44are minutes.
7219bb74
KM
45All times are converted to a 12 hour clock, and assumed to
46be in the next 12 hours.
b14a7a4a
CL
47.It Cm \&+
48If the time is preceeded by
49.Ql Cm \&+ ,
50the alarm will go off in hours and minutes
a40f7d8d 51from the current time.
b14a7a4a 52.El
d9d7a9f0 53.Pp
7219bb74 54If no argument is given,
d9d7a9f0 55.Nm leave
7219bb74
KM
56prompts with "When do you
57have to leave?". A reply of newline causes
d9d7a9f0 58.Nm leave
7219bb74
KM
59to exit,
60otherwise the reply is assumed to be a time.
61This form is suitable for inclusion in a
d9d7a9f0 62.Pa .login
7219bb74 63or
d9d7a9f0
CL
64.Pa .profile.
65.Pp
7219bb74 66Leave ignores interrupts, quits, and terminates.
d9d7a9f0 67To get rid of it you should either log off or use
5325ced3 68.Ql kill \-9
7219bb74 69giving its process id.
d9d7a9f0
CL
70.Sh SEE ALSO
71.Xr calendar 1
72.Sh HISTORY
b14a7a4a
CL
73The
74.Nm leave
75command appeared in
76.Bx 3.0 .