zephyr/clients/zleave/zleave.1

   1 .\"     $Id: zleave.1,v 1.10 1999/01/22 23:18:32 ghudson Exp $
   2 .\"
   3 .\" Copyright (c) 1980 Regents of the University of California.
   4 .\" All rights reserved.  The Berkeley software License Agreement
   5 .\" specifies the terms and conditions for redistribution.
   6 .\"
   7 .\"
   8 .TH ZLEAVE 1 "July 1, 1988" "MIT Project Athena"
   9 .ds ]W MIT Project Athena
  10 .SH NAME
  11 zleave \- notify you via Zephyr when you have to leave
  12 .SH SYNOPSIS
  13 .B zleave
  14 [
  15 .RI [+] hhmm
  16 [
  17 .I -m "Reminder Message"
  18 ] ]
  19 .br
  20 .B zleave
  21 .I can\fR[\fIcel\fR]
  22 .SH DESCRIPTION
  23 .I Zleave
  24 waits until the specified time, then reminds you that you
  25 have to leave, using the \fIZephyr(1)\fR Notification Service.
  26 You are reminded 5 minutes and 1 minute before the actual
  27 time, at the time, and every minute thereafter.
  28 When you log off,
  29 .I zleave
  30 exits just before it would have sent the next message.
  31 .PP
  32 The time of day is in the form hhmm where hh is a time in
  33 hours (on a 12 or 24 hour clock).
  34 All times are converted to a 12 hour clock, and assumed to
  35 be in the next 12 hours.
  36 .PP
  37 If the time is preceded by `+', the alarm will go off in hours and minutes
  38 from the current time.
  39 .PP
  40 If no argument is given,
  41 .I zleave
  42 prompts with "When do you
  43 have to leave?". A reply of newline causes
  44 .I zleave
  45 to exit,
  46 otherwise the reply is assumed to be a time.
  47 This form is suitable for inclusion in a
  48 .I .login
  49 or
  50 .I .profile.
  51 .PP
  52 The
  53 .I cancel
  54 option cancels the currently running \fIzleave\fR.  If another
  55 .I zleave
  56 is running, it is automatically killed when a new time to leave is
  57 set.  The process id is stored in the file /tmp/zleave.\fIuid\fR, where
  58 \fIuid\fR is the user's UNIX uid.
  59 .PP
  60 If the
  61 .I -m
  62 argument is specified, the next argument
  63 is appended to the standard message
  64 (a sentence describing how much time remains until the appointed hour)
  65 sent at appropriate times.
  66 If you want to append a multiple-word message, you normally must quote it with
  67 double quotes (") (This is necessary for users of
  68 .IR csh (1)
  69 and
  70 .IR sh (1).)
  71 .PP
  72 .I Zleave
  73 automatically subscribes you to Zephyr class "MESSAGE",
  74 instance "LEAVE".  You do not have to add anything to your
  75 default subscriptions file (see
  76 .IR zctl (1)).
  77 The reminder message is displayed by the WindowGram client (usually
  78 .IR zwgc (1)).
  79 .PP
  80 If Zephyr is unavailable,
  81 .I zleave
  82 acts essentially like
  83 .IR leave (1).
  84 .PP
  85 Zleave ignores SIGINT, SIGQUIT, and SIGTERM.
  86 To get rid of it you should either log off or use the
  87 .I cancel
  88 option.
  89 .SH FILES
  90 /tmp/zleave.\fIuid\fR
  91 /tmp/wg.*
  92 .SH SEE ALSO
  93 calendar(1), zephyr(1), leave(1), zwgc(1), zctl(1), csh(1), sh(1)
  94 .br
  95 Project Athena Technical Plan Section E.4.1, `Zephyr Notification
  96 Service'
  97 .SH RESTRICTIONS
  98 Copyright (c) 1980,  Regents of the University of California.
  99 All rights reserved.
 100 Redistribution and use in source and binary forms are permitted
 101 provided that this notice is preserved and that due credit is given
 102 to the University of California at Berkeley. The name of the University
 103 may not be used to endorse or promote products derived from this
 104 software without specific written prior permission. This software
 105 is provided ``as is'' without express or implied warranty.
 106 .sp
 107 Copyright (c) 1987,1988 by the Massachusetts Institute of Technology.