X-Git-Url: https://git.distorted.org.uk/u/mdw/putty/blobdiff_plain/27507d531665d86eb0bed0491b8604fbb2e48190..a607fe54c9f20934b57e29e9040b9dd0a4decf3a:/doc/man-pg.but

diff --git a/doc/man-pg.but b/doc/man-pg.but
index f0cb89b4..86136ded 100644
--- a/doc/man-pg.but
+++ b/doc/man-pg.but
@@ -37,7 +37,11 @@ the following section.
 \S{puttygen-manpage-options} OPTIONS
 
 In the first phase, \c{puttygen} either loads or generates a key.
-The options to control this are:
+Note that generating a key requires random data (from
+\c{/dev/random}), which can cause \c{puttygen} to pause, possibly for
+some time if your system does not have much randomness available.
+
+The options to control this phase are:
 
 \dt \e{keyfile}
 
@@ -95,8 +99,8 @@ be the standard SSH-1 key format, or PuTTY's own SSH-2 key format.
 
 \dd Save the public key only. For SSH-1 keys, the standard public key
 format will be used (\q{\cw{1024 37 5698745}...}). For SSH-2 keys, the
-public key will be output in the format specified in the IETF
-drafts, which is a multi-line text file beginning with the line
+public key will be output in the format specified by RFC 4716,
+which is a multi-line text file beginning with the line
 \q{\cw{---- BEGIN SSH2 PUBLIC KEY ----}}.
 
 \dt \cw{public-openssh}