[src/netbsd-1-5]: src/usr.bin/leave Pull up revisions 1.7-1.9 (requested by f...

[he <he%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/f15ae8949735
branches:  netbsd-1-5
changeset: 492593:f15ae8949735
user:      he <he%NetBSD.org@localhost>
date:      Tue Jan 22 19:39:09 2002 +0000

description:
Pull up revisions 1.7-1.9 (requested by fair):
  Handle 24-hour time format better, and also document limitations.

diffstat:

 usr.bin/leave/leave.1 |  53 +++++++++++++++++++++++++++++++++-----------------
 1 files changed, 35 insertions(+), 18 deletions(-)

diffs (103 lines):

diff -r dc99fdd222a8 -r f15ae8949735 usr.bin/leave/leave.1
--- a/usr.bin/leave/leave.1     Tue Jan 22 19:38:52 2002 +0000
+++ b/usr.bin/leave/leave.1     Tue Jan 22 19:39:09 2002 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: leave.1,v 1.6 1997/10/19 03:48:34 lukem Exp $
+.\"    $NetBSD: leave.1,v 1.6.12.1 2002/01/22 19:39:09 he Exp $
 .\"
 .\" Copyright (c) 1980, 1990, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -33,7 +33,7 @@
 .\"
 .\"    @(#)leave.1     8.3 (Berkeley) 4/28/95
 .\"
-.Dd April 28, 1995
+.Dd January 19, 2002
 .Dt LEAVE 1
 .Os
 .Sh NAME
@@ -49,17 +49,19 @@
 .Sm on
 .Sh DESCRIPTION
 .Nm
-waits until the specified time, then reminds you that you
-have to leave.
+waits until the specified time (within the next 12 hours), then
+reminds you that you have to leave by writing to the TTY that you
+executed
+.Nm
+on.
+.Pp
 You are reminded 5 minutes and 1 minute before the actual
 time, at the time, and every minute thereafter.
 When you log off,
 .Nm
 exits just before it would have
 printed the next message.
-.Pp
-Options:
-.Pp
+.Sh OPTIONS
 .Bl -tag -width flag
 .It Ar hhmm
 The time of day is in the form
@@ -70,8 +72,11 @@
 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
+.Pp
+However, all times are converted to a 12 hour clock, and assumed to
 be in the next 12 hours.
+An attempt to set an alarm for farther into the future will be truncated
+to within the next 12 hours.
 .It Cm \&+
 If the time is preceded by
 .Ql Cm \&+ ,
@@ -81,24 +86,36 @@
 .Pp
 If no argument is given,
 .Nm
-prompts with "When do you
-have to leave?". A reply of newline causes
+prompts with "When do you have to leave?"
+A reply of newline causes
 .Nm
 to exit,
 otherwise the reply is assumed to be a time.
 This form is suitable for inclusion in a
-.Pa .login
+.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 \-s KILL
-giving its process id.
+.Pa ~/.profile .
 .Sh SEE ALSO
-.Xr calendar 1
+.Xr calendar 1 ,
+.Xr csh 1 ,
+.Xr sh 1
 .Sh HISTORY
 The
 .Nm
 command appeared in
 .Bx 3.0 .
+.Sh BUGS
+In the modern age with
+.Xr X 1
+and window multiplexing programs like
+.Xr window 1
+and
+.Xr screen 1 ,
+the
+.Nm
+command's reminders and admonitions might not be seen if the user
+has the window where
+.Nm
+was started minimized or obscured.
+.Pp
+This all begs for a more general user notifications system to be implemented.