Index | Thread | Search

From:
Ingo Schwarze <schwarze@usta.de>
Subject:
Re: Hyperlinks to RFCs in man(1) HTML output, was: bgpd
To:
Theo Buehler <tb@theobuehler.org>
Cc:
Stuart Henderson <stu@spacehopper.org>, tech@openbsd.org
Date:
Mon, 20 Jan 2025 08:45:30 +0100

Download raw body.

Thread
  • Mark Kettenis:

    bgpd: drop authors from RFC list

  • FYI,
    
    Ingo Schwarze wrote on Sat, Jan 18, 2025 at 04:22:16AM +0100:
    > Stuart Henderson wrote on Fri, Jan 17, 2025 at 01:31:18PM +0000:
    
    >> I looked to see if there was a sensible way to add links to the RFCs
    >> in HTML output, which would make it easier to look them up if wanted -
    >> but I don't think there is, at least without the URL also showing up
    >> in the console output which makes things much worse there).
    
    > If you are a browser, use this for testing:
    >  $ man -T html bgpd
    > Otherwise, try something like
    >  $ MANPAGER=lynx man -T html bgpd  
    
    I committed this patch based on an OK that tb@ sent me privately
    and also installed it on man.openbsd.org, so now when you write
    
      .%R RFC 1149
    
    in a manual page (as you always did, no need to learn anything new),
    you get a clickable hyperlink, for example look at:
    
      https://man.openbsd.org/ssh-keygen#SEE_ALSO
      https://man.openbsd.org/utf8.7#STANDARDS
      https://man.openbsd.org/rpki-client#STANDARDS
    
    Yours,
      Ingo
    
    
    P.S.
    I also applied the same to -T markdown output as to -T html output,
    such that people who maintain portable software projects outside
    OpenBSD and keep their code on github or similar markdown-using
    platforms also get the same kind of clickable hyperlinks there:
    
     $ man -T markdown utf8
    [...]
    # STANDARDS
    
    F. Yergeau,
    *UTF-8, a transformation format of ISO 10646*,
    [RFC 3629](http://www.rfc-editor.org/rfc/rfc3629.html),
    November 2003.
    
    [The Unicode Standard](https://www.unicode.org/versions/latest/)
    
    [The Unicode Character Database](https://www.unicode.org/reports/tr44/)
    
    OpenBSD 7.6 - February 18, 2022
    
    
    
  • Mark Kettenis:

    bgpd: drop authors from RFC list