4.3BSD-Reno/src/usr.bin/leave/leave.1

Compare this file to the similar file:
Show the results in this format:
.\" Copyright (c) 1980, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms are permitted provided
.\" that: (1) source distributions retain this entire copyright notice and
.\" comment, and (2) distributions including binaries display the following
.\" acknowledgement:  ``This product includes software developed by the
.\" University of California, Berkeley and its contributors'' in the
.\" documentation or other materials provided with the distribution and in
.\" all advertising materials mentioning features or use of this software.
.\" Neither the name of the University nor the names of its contributors may
.\" be used to endorse or promote products derived from this software without
.\" specific prior written permission.
.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
.\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
.\"
.\"     @(#)leave.1	6.4 (Berkeley) 7/24/90
.\"
.Dd July 24, 1990
.Dt LEAVE 1
.Sh NAME
.Nm leave
.Nd remind you when you have to leave
.Sh SYNOPSIS
.Nm leave
.Op [\&+] Ar hhmm
.Sh DESCRIPTION
.Nm Leave
waits until the specified time, then reminds you that you
have to leave.
You are reminded 5 minutes and 1 minute before the actual
time, at the time, and every minute thereafter.
When you log off,
.Nm leave
exits just before it would have
printed the next message.
.Pp
Options:
.Pp
.Tw Fl
.Tp Ar hhmm
The time of day is in the form
.Ar hhmm
where
.Ar hh
is a time in
hours (on a 12 or 24 hour clock), and
.Ar mm
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
from the current time.
.Tp
.Pp
If no argument is given,
.Nm leave
prompts with "When do you
have to leave?". A reply of newline causes
.Nm leave
to exit,
otherwise the reply is assumed to be a time.
This form is suitable for inclusion in a
.Pa .login
or
.Pa .profile.
.Pp
Leave ignores interrupts, quits, and terminates.
To get rid of it you should either log off or use
.Ql kill \-9
giving its process id.
.Sh SEE ALSO
.Xr calendar 1
.Sh HISTORY
.Nm Leave
appeared in 3 BSD.