[Bug 2935] New: improve documentation of "ssh-keygen -R" to mention "[hostname]:port"

[bugzilla-daemon at bugzilla.mindrot.org]

https://bugzilla.mindrot.org/show_bug.cgi?id=2935

            Bug ID: 2935
           Summary: improve documentation of "ssh-keygen -R" to mention
                    "[hostname]:port"
           Product: Portable OpenSSH
           Version: 7.9p1
          Hardware: Other
                OS: Linux
            Status: NEW
          Severity: enhancement
          Priority: P5
         Component: ssh-keygen
          Assignee: unassigned-bugs at mindrot.org
          Reporter: thomas at savoy-truffle.de

Improve the documentation of ssh-keygen's -R parameter to explicitly
describe how to delete the line in the "known_hosts"-file for
non-standard port connections.

current: 
___
 -R hostname
             Removes all keys belonging to hostname from a known_hosts
file.  This option is useful to delete hashed hosts (see the -H option
above).
___

proposed:
___
 -R hostname
 -R [hostname]:port
             Removes all keys belonging to hostname and port from a
known_hosts file, brackets and ":port" may be ommited if the standard
port (22) is used.  This option is useful to delete hashed hosts (see
the -H option above).
___

Personal remark, at least in the documentation the use of "[]" may lead
to misinterpretation, therefore the explicit notion of them in the
proposal. It would seem that the use of the representation as
"hostname:port" is more natural.

Kind regards,
Thomas Hofmann

-- 
You are receiving this mail because:
You are watching the assignee of the bug.