Re: [PATCH] rust: convert raw URLs to Markdown autolinks in comments
From: Miguel Ojeda
Date: Sun Apr 06 2025 - 06:28:18 EST
On Sun, Apr 6, 2025 at 5:51 AM Xizhe Yin <xizheyin@xxxxxxxxxxxxxxxx> wrote:
>
> From: xizheyin <xizheyin@xxxxxxxxxxxxxxxx>
This should ideally match your Signed-off-by.
> Some comments in Rust files use raw URLs (http://example.com) rather
> than Markdown autolinks [text](URL). This inconsistency makes the
> documentation less uniform and harder to maintain.
>
> This patch converts all remaining raw URLs in Rust code comments to use
> the Markdown autolink format, maintaining consistency with the rest of
> the codebase which already uses this style.
>
> Link: Rust-for-Linux#1153
> Suggested-by: Miguel Ojeda <ojeda@xxxxxxxxxx>
I am really a newbie on the Markdown spec, but as far as I can tell,
Markdown autolinks are the `<...>` ones:
https://spec.commonmark.org/0.31.2/#autolinks
So what I was trying to suggest adding a few missing `<>` to a few raw
URLs we have.
By the way, the "Link" should be a full URL to the issue here :)
Thanks for the patch!
Cheers,
Miguel