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

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.

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

Damien Miller <djm at mindrot.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
         Resolution|---                         |FIXED
             Status|NEW                         |RESOLVED
             Blocks|                            |2915
                 CC|                            |djm at mindrot.org

--- Comment #1 from Damien Miller <djm at mindrot.org> ---
Fixed - it now reads:

 -R hostname | [hostname]:port
      Removes all keys belonging to the specified hostname (with
      optional port number) from a known_hosts file.  This option is
      useful to delete hashed hosts (see the -H option above).


Referenced Bugs:

https://bugzilla.mindrot.org/show_bug.cgi?id=2915
[Bug 2915] Tracking bug for 8.0 release
-- 
You are receiving this mail because:
You are watching someone on the CC list of the bug.
You are watching the assignee of the bug.

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

Damien Miller <djm at mindrot.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|RESOLVED                    |CLOSED

--- Comment #2 from Damien Miller <djm at mindrot.org> ---
closing resolved bugs as of 8.6p1 release

-- 
You are receiving this mail because:
You are watching the assignee of the bug.
You are watching someone on the CC list of the bug.