xref: /original-bsd/usr.bin/leave/leave.1 (revision 00695d63)
1.\" Copyright (c) 1980, 1990, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" %sccs.include.redist.roff%
5.\"
6.\"	@(#)leave.1	8.3 (Berkeley) 04/28/95
7.\"
8.Dd
9.Dt LEAVE 1
10.Os
11.Sh NAME
12.Nm leave
13.Nd remind you when you have to leave
14.Sh SYNOPSIS
15.Nm leave
16.Sm off
17.Oo
18.Op Cm \&+
19.Ns Ar hhmm
20.Oc
21.Sm on
22.Sh DESCRIPTION
23.Nm Leave
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,
29.Nm leave
30exits just before it would have
31printed the next message.
32.Pp
33Options:
34.Pp
35.Bl -tag -width flag
36.It Ar hhmm
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.
45All times are converted to a 12 hour clock, and assumed to
46be in the next 12 hours.
47.It Cm \&+
48If the time is preceded by
49.Ql Cm \&+ ,
50the alarm will go off in hours and minutes
51from the current time.
52.El
53.Pp
54If no argument is given,
55.Nm leave
56prompts with "When do you
57have to leave?". A reply of newline causes
58.Nm leave
59to exit,
60otherwise the reply is assumed to be a time.
61This form is suitable for inclusion in a
62.Pa .login
63or
64.Pa .profile.
65.Pp
66Leave ignores interrupts, quits, and terminates.
67To get rid of it you should either log off or use
68.Ql kill \-s KILL
69giving its process id.
70.Sh SEE ALSO
71.Xr calendar 1
72.Sh HISTORY
73The
74.Nm leave
75command appeared in
76.Bx 3.0 .
77