[PATCH] document inability to change v2 keys' comments with ssh-keygen

[Matthew Vernon]

Hi,

ssh-keygen is unable to change version 2 keys' comments (this was true
in 2.9p2, and the changelog doesn't make me think this has changed),
so I think this should be documented. Here's a patch to ssh-keygen.1

(It's based on an ssh-keygen patched with my previous patch).

Cheers,

Matthew
--- ssh-keygen.1.orig	Thu Sep 27 20:31:48 2001
+++ ssh-keygen.1	Thu Sep 27 20:40:32 2001
@@ -149,6 +148,7 @@
 Requests changing the comment in the private and public key files.
 The program will prompt for the file containing the private keys, for
 the passphrase if the key has one, and for the new comment.
+The comment can only be changed if the key is an RSA1 key.
 .It Fl e
 This option will read a private or public OpenSSH key file and
 print the key in a
@@ -267,6 +265,9 @@
 where the user wishes to log in using public key authentication.
 There is no need to keep the contents of this file secret.
 .El
+.Sh BUGS
+While it is possible to give an RSA or DSA key (that is a version 2
+key) a comment when creating it there is no way to change it.
 .Sh AUTHORS
 OpenSSH is a derivative of the original and free
 ssh 1.2.12 release by Tatu Ylonen.


-- 
"At least you know where you are with Microsoft."
"True. I just wish I'd brought a paddle."
http://www.debian.org