Manpages nits

cassh-keyfile.1

@@ -11,7 +11,7 @@
 .\" along with this software. If not, see
 .\" <http://creativecommons.org/publicdomain/zero/1.0/>.
 .\"
-.Dd March 01, 2022
+.Dd April 07, 2022
 .Dt CASSH-KEYFILE 1
 .Os
 .Sh NAME
@@ -49,8 +49,7 @@ does need one.
 .Sh EXIT STATUS
 .Ex -std
 .Sh SEE ALSO
-.Xr ssh-agent 1 ,
-.Xr ssh-keygen 1
+.Xr cassh 1
 .Sh AUTHORS
 .An Lucas
 .Sh LICENSE

cassh.1

@@ -61,7 +61,7 @@ directory which holds the public keys to be signed, and an optional
 file holding the current serial number for the issued certificates.
 .Pp
 The following commands are available to
-.Xr cassh 1 :
+.Nm :
 .Bl -tag -width Ds
 .It Xo
 .Cm issue
@@ -91,6 +91,8 @@ The basename of the public key being signed.
 .Pp
 .Ar key_id
 accepts the tokens %%, %C, and %f.
+It defaults to
+.Dq %C/%f .
 .Pp
 .Ar principals
 accepts the tokens %% and %f.
@@ -107,18 +109,27 @@ Authority.
 is copied verbatim to the output, and
 .Cm cert-authority
 is always added.
+See
+.Xr sshd 8 AUTHORIZED_KEYS FILE FORMAT
+for details.
 .It Cm mkfile Ic known_hosts Op Ar hostnames
 Write a
 .Ic known_hosts
 file on standard output corresponding to the current Certification
 Authority.
-.Ar hostnames is copied verbatim to the output.
+.Ar hostnames
+is copied verbatim to the output.
+See
+.Xr sshd 8 SSH_KNOWN_HOSTS FILE FORMAT
+for details.
 .El
 .Sh EXIT STATUS
 .Ex -std
 .Sh SEE ALSO
 .Xr ssh-agent 1 ,
-.Xr ssh-keygen 1
+.Xr ssh-keygen 1 ,
+.Xr sshd 8 AUTHORIZED_KEYS FILE FORMAT ,
+.Xr sshd 8 SSH_KNOWN_HOSTS FILE FORMAT
 .Sh AUTHORS
 .An Lucas
 .Sh LICENSE