reorder and document some options

git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@13394 ec53bebd-3082-4978-b11e-865c3cabbd6b

appl/rsh/rsh.1

@@ -31,7 +31,7 @@
 .\" 
 .\"	$Id$
 .\"
-.Dd September 4, 2003
+.Dd February 20, 2004
 .Dt RSH 1
 .Os HEIMDAL
 .Sh NAME
@@ -140,11 +140,6 @@ Also settable via
 (see
 .Xr krb5.conf ) .
 .It Xo
-.Fl G
-.Xc
-The opposite of
-.Fl f .
-.It Xo
 .Fl F ,
 .Fl -forwardable
 .Xc
@@ -154,6 +149,49 @@ Also settable via
 (see
 .Xr krb5.conf ) .
 .It Xo
+.Fl l Ar string ,
+.Fl -user= Ns Ar string
+.Xc
+By default the remote username is the same as the local. The
+.Fl l
+option or the
+.Pa username@host
+format allow the remote name to be specified.
+.It Xo
+.Fl n ,
+.Fl -no-input
+.Xc
+Direct input from 
+.Pa /dev/null
+(see the
+.Sx BUGS
+section).
+.It Xo
+.Fl p Ar number-or-service ,
+.Fl -port= Ns Ar number-or-service
+.Xc
+Connect to this port instead of the default (which is 514 when using
+old port based authentication, 544 for Kerberos 5 and non-encrypted
+Kerberos 4, and 545 for encrytpted Kerberos 4; subject of course to
+the contents of
+.Pa /etc/services ) .
+.It Xo
+.Fl P Ar N|O|1|2 ,
+.Fl -protocol= Ns Ar N|O|1|2
+.Xc
+Specifies the protocol version to use with Kerberos 5.
+.Ar N
+and
+.Ar 2
+select protocol version 2, while 
+.Ar O
+and
+.Ar 1
+select version 1. Version 2 is believed to be more secure, and is the
+default. Unless asked for a specific version,
+.Nm
+will try both.  This behaviour may change in the future.
+.It Xo
 .Fl u ,
 .Fl -unique
 .Xc
@@ -167,39 +205,23 @@ any existing cache. Mutually exclusive to
 Name of the remote credentials cache. Mutually exclusive to
 .Fl u .
 .It Xo
-.Fl p Ar number-or-service ,
+.Fl x ,
-.Fl -port= Ns Ar number-or-service
+.Fl -encrypt
 .Xc
-Connect to this port instead of the default (which is 514 when using
+The
-old port based authentication, 544 for Kerberos 5 and non-encrypted
+.Fl x
-Kerberos 4, and 545 for encrytpted Kerberos 4; subject of course to
+option enables encryption for all data exchange. This is only valid
-the contents of
+for Kerberos authenticated connections (see the
-.Pa /etc/services ) .
+.Sx BUGS
-.It Xo
+section for limitations).
-.Fl l Ar string ,
+.It Fl z
-.Fl -user= Ns Ar string
+The opposite of
-.Xc
+.Fl x .
-By default the remote username is the same as the local. The
+This is the default, but encryption can be enabled when using
-.Fl l
+Kerberos 5, by setting the
-option or the
+.Li libdefaults/encrypt
-.Pa username@host
+option in
-format allow the remote name to be specified.
+.Xr krb5.conf 5 .
-.It Xo
-.Fl P Ar N|O|1|2 ,
-.Fl -protocol= Ns Ar N|O|1|2
-.Xc
-Specifies which protocol version to use with Kerberos 5.
-.Ar N
-and
-.Ar 2
-selects protocol version 2, while 
-.Ar O
-and
-.Ar 1
-selects version 1. Version 2 is believed to be more secure, and is the
-default. Unless asked for a specific version,
-.Nm
-will try both.  This behaviour may change in the future.
 .El
 .\".Pp
 .\"Without a