cleanup

1 files changed, 40 insertions, 14 deletions

diff --git a/clients/zwrite/zwrite.1 b/clients/zwrite/zwrite.1
index 9a01473..55847fd 100644
--- a/clients/zwrite/zwrite.1
+++ b/clients/zwrite/zwrite.1
@@ -1,10 +1,14 @@
-.\" Copyright 1987 by the Massachusetts Institute of Technology
+.\"	$Source$
+.\"	$Author$
+.\"	$Header$
+.\"
+.\" Copyright 1987,1988 by the Massachusetts Institute of Technology
 .\" All rights reserved.  The file /usr/include/zephyr/mit-copyright.h
 .\" specifies the terms and conditions for redistribution.
 .\"
-.\"	@(#)zwrite.1	6.1 (MIT) 7/9/87
 .\"
-.TH ZWRITE 1 "February 6, 1988"
+.TH ZWRITE 1 "July 1, 1988" "MIT Project Athena"
+.ds ]W MIT Project Athena
 .SH NAME
 zwrite \- write to another user
 .SH SYNOPSIS
@@ -26,6 +30,8 @@ zwrite \- write to another user
 class ] [
 .BI -i
 instance ] [
+.BI -f
+arg ] [
 .BI user \ ...
 ] [
 .BI -m
@@ -47,13 +53,13 @@ understands the following options.
 Causes
 .I zwrite
 to send the message authenticated, using
-.I kerberos
+.I Kerberos
 to perform the authentication.  This is the default.
 .TP
 .B \-d
 Causes
 .I zwrite
-to send the message nonauthenticated.
+to send the message unauthenticated.
 .TP
 .B \-v
 Causes
@@ -77,7 +83,7 @@ Causes
 to ignore the Zephyr variables \fIzwrite-class\fR and \fIzwrite-inst\fR
 when picking a default class and instance.
 .TP
-.B \-c
+.B \-c \fIclass\fR
 Allows a user to specify a different class for the message.  This allows
 a message to be sent to a large group of people with some degree of
 security.  See
@@ -87,14 +93,34 @@ and
 for a description of how to restrict access to classes.  When this option
 is specified, the message is sent to recipient "*" unless an additional
 list of recipients is specified.
+.br
+This argument may not be used in conjunction with the -f option.
 .TP
-.B \-i
+.B \-i \fIinstance\fR
 Allows a user to specify a different instance than the default.
 When this option is used, the message is sent to recipient "*" unless an
 additional list of recipients is specified.  This allows a message to be
 sent to a large group of people (e.g. a development group) just by having
-the members group to messages of class "MESSAGE", the specified instance,
+the members subscribe to messages of class "MESSAGE", the specified instance,
 and recipient "*".
+.br
+This argument may not be used in conjunction with the -f option.
+.TP
+.B \-f \fIarg\fR
+Allows a user to specify an argument to be interpreted as a filesystem
+specification.  The class is set to \fBFILSRV\fR.  The instance is set
+to \fIarg\fR as modified:
+If \fIarg\fR contains no colons (`:'), it is assumed to
+be a host name, and it is converted into an official host name via 
+.I gethostbyname(3).
+If \fIarg\fR contains a colon, the portion preceding the colon is
+treated as a host name, and the colon and any trailing characters are
+appended to the offical host name returned by
+.I gethostbyname.
+If the name fails to resolve into an official host name, the instance is
+set to \fIarg\fR unmodified.
+.br
+This option may not be used in conjunction with the -c or -i option.
 .TP
 .B \-m
 .I Zwrite
@@ -109,20 +135,20 @@ by itself.
 The default class for messages is ``MESSAGE'', and the default instance
 is ``PERSONAL''.  These defaults can be changed by setting the Zephyr
 variables \fIzwrite-class\fR and \fIzwrite-inst\fR, respectively.
+.br
+Command-line options override the defaults.
 .PP
 If the Zephyr variable \fIzephyr-signature\fR is set, its contents are used
 to augment the user's username in the message. 
 .SH SEE ALSO
 kerberosintro(1), zctl(1), zephyr(1), zwgc(1), zhm(8), zephyrd(8)
+gethostbyname(3)
 .br
-`Zephyr Notification Service'
+Project Athena Technical Plan Section E.4.1, `Zephyr Notification
+Service'
 .SH AUTHOR
 .PP
 .br
 Robert S. French (MIT-Project Athena)
 .sp
-Copyright (c) 1987 by the Massachusetts Institute of Technology
-.br
-See
-.I zephyr(1)
-for a full copyright notice.
+Copyright (c) 1987,1988 by the Massachusetts Institute of Technology