[Bug 3985] New: ssh_config(5): .Sx used for sections that live in other pages, renders as broken links in HTML output

[bugzilla-daemon at mindrot.org]

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

            Bug ID: 3985
           Summary: ssh_config(5): .Sx used for sections that live in
                    other pages, renders as broken links in HTML output
           Product: Portable OpenSSH
           Version: 10.4p1
          Hardware: All
                OS: All
            Status: NEW
          Severity: trivial
          Priority: P5
         Component: ssh
          Assignee: unassigned-bugs at mindrot.org
          Reporter: hi at pgray.dev

Created attachment 3974
  --> https://bugzilla.mindrot.org/attachment.cgi?id=3974&action=edit
git diff of ssh_config man page

running a link checker over mandoc -Thtml output i found ssh_config(5)
uses .Sx
(an in-page section reference) five times for sections that actually
live in other pages:

- .Sx TIME FORMATS (3x): the section is in sshd_config(5)
- .Sx VERIFYING HOST KEYS (2x): the section is in ssh(1)

in HTML output these become dangling #TIME_FORMATS /
#VERIFYING_HOST_KEYS fragment links that point nowhere
including on man.openbsd.org's rendering of the page.

terminal output reads fine, which is maybe why it's been unnoticed?

the page already uses the right idiom once (under RekeyLimit:
plain-text "TIME FORMATS section of" followed by .Xr sshd_config 5),
so the attached patch just makes the other five spots consistent with
that.

one of the five didn't name the target page at all ("...documented in
the .Sx TIME FORMATS section." but ssh_config(5) has no such section
for the reader to find), so it gains the .Xr sshd_config 5 pointer.

verified with mandoc:
after the patch, -Thtml output of ssh_config.5 contains no fragment
hrefs without a matching id

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