- options must be lexicographically ordered; again, options without

arguments must be placed before options with arguments.
- manual page cross references are done using the macro `.Xr',
  not the macro `.Nm' (used for command names instead).

From Igor Sobrado.


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

appl/afsutil/afslog.1

@@ -1,4 +1,4 @@
-.\" Copyright (c) 2002 Kungliga Tekniska H<>gskolan
+.\" Copyright (c) 2002 - 2007 Kungliga Tekniska H<>gskolan
 .\" (Royal Institute of Technology, Stockholm, Sweden). 
 .\" All rights reserved. 
 .\"
@@ -40,29 +40,30 @@
 obtain AFS tokens
 .Sh SYNOPSIS
 .Nm
+.Op Fl h | Fl -help
+.Op Fl -no-v4
+.Op Fl -no-v5
+.Op Fl u | Fl -unlog
+.Op Fl v | Fl -verbose
+.Op Fl -version
 .Oo Fl c Ar cell \*(Ba Xo
 .Fl -cell= Ns Ar cell
 .Xc
 .Oc
-.Oo Fl p Ar path \*(Ba Xo
-.Fl -file= Ns Ar path
-.Xc
-.Oc
 .Oo Fl k Ar realm \*(Ba Xo
 .Fl -realm= Ns Ar realm
 .Xc
 .Oc
-.Op Fl -no-v4
-.Op Fl -no-v5
 .Oo Fl P Ar principal \*(Ba Xo
 .Fl -principal= Ns Ar principal
 .Xc
 .Oc
-.Op Fl -cache Ar cache
+.Bk -words
-.Op Fl u | Fl -unlog
+.Oo Fl p Ar path \*(Ba Xo
-.Op Fl v | Fl -verbose
+.Fl -file= Ns Ar path
-.Op Fl -version
+.Xc
-.Op Fl h | Fl -help
+.Oc
+.Ek
 .Op Ar cell | path ...
 .Sh DESCRIPTION
 .Nm
@@ -76,23 +77,6 @@ decides upon.
 .Pp
 Supported options:
 .Bl -tag -width Ds
-.It Xo
-.Fl c Ar cell,
-.Fl -cell= Ns Ar cell
-.Xc
-This specified one or more cell names to get tokens for.
-.It Xo
-.Fl p Ar path ,
-.Fl -file= Ns Ar path
-.Xc
-This specified one or more file paths for which tokens should be
-obtained.
-.It Xo
-.Fl k Ar realm ,
-.Fl -realm= Ns Ar realm
-.Xc
-This is the Kerberos realm the AFS servers live in, this should
-normally not be specified.
 .It Fl -no-v4
 This makes
 .Nm
@@ -124,7 +108,25 @@ and
 .Fl -verbose
 .Xc
 Adds more verbosity for what is actually going on.
+.It Xo
+.Fl c Ar cell,
+.Fl -cell= Ns Ar cell
+.Xc
+This specified one or more cell names to get tokens for.
+.It Xo
+.Fl k Ar realm ,
+.Fl -realm= Ns Ar realm
+.Xc
+This is the Kerberos realm the AFS servers live in, this should
+normally not be specified.
+.It Xo
+.Fl p Ar path ,
+.Fl -file= Ns Ar path
+.Xc
+This specified one or more file paths for which tokens should be
+obtained.
 .El
+.Pp
 Instead of using
 .Fl c
 and