zig icon indicating copy to clipboard operation
zig copied to clipboard

Autodoc: hyperlink URLs in text

Open ianprime0509 opened this issue 1 year ago • 1 comments

Closes #19265

There are two commits in this PR: the first one implements the "traditional" Markdown autolink syntax, using <> to delimit the link, and the second one extends the parser to also recognize a more restricted form of links directly in plain text without any delimiters.

Both forms of autolinks are currently represented in the standard library documentation. Here are some examples:

  • Using <> (these are a minority):
    • #std.Uri
    • #std.fmt.parse_float.convert_slow.convertSlow
    • #std.fmt.parse_float.convert_eisel_lemire.convertEiselLemire
  • Plain text:
    • #std.ascii (the subject of the linked issue)
    • #std.unicode.fmtUtf8
    • #std.mem.page_size

ianprime0509 avatar Mar 23 '24 01:03 ianprime0509

It seems that the aarch64-macos-debug CI timed out, although unfortunately I don't have access to an aarch64-macos system to see if this is reproducible or just an unfortunate random occurrence. I'm not sure how these changes could have caused such a noticeable change in the build time; judging from other aarch64-macos-debug CI runs, it seems they usually take only 3.5-4.5 hours, not 6+ as in this case.

ianprime0509 avatar Mar 24 '24 02:03 ianprime0509

Nice!

andrewrk avatar Mar 25 '24 22:03 andrewrk