Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) client-ip=2620:137:e000::3:7;
From:   Jonathan Corbet <corbet@lwn.net>
To:     Vegard Nossum <vegard.nossum@oracle.com>
Cc:     linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org,
        Vegard Nossum <vegard.nossum@oracle.com>
Subject: Re: [PATCH RFC] docs: automarkup: linkify git revs
In-Reply-To: <20231027115420.205279-1-vegard.nossum@oracle.com>
References: <20231027115420.205279-1-vegard.nossum@oracle.com>
Date:   Fri, 17 Nov 2023 13:37:53 -0700
Message-ID: <87h6lk86am.fsf@meer.lwn.net>
MIME-Version: 1.0
Content-Type: text/plain
Precedence: bulk

Vegard Nossum <vegard.nossum@oracle.com> writes:

> There aren't a ton of references to commits in the documentation, but
> they do exist, and we can use automarkup to linkify them to make them
> easier to follow.
>
> Use something like this to find references to commits:
>
>   git grep -P 'commit.*[0-9a-f]{8,}' Documentation/
>
> Also fix a few of these to standardize on the exact format that is
> already used in changelogs.
>
> Signed-off-by: Vegard Nossum <vegard.nossum@oracle.com>
> ---
>  Documentation/arch/x86/boot.rst           |  2 +-
>  Documentation/bpf/btf.rst                 |  6 ++----
>  Documentation/doc-guide/sphinx.rst        |  9 +++++++++
>  Documentation/livepatch/callbacks.rst     |  4 ++--
>  Documentation/networking/snmp_counter.rst | 16 ++++++----------
>  Documentation/sphinx/automarkup.py        | 20 +++++++++++++++++++-
>  6 files changed, 39 insertions(+), 18 deletions(-)

That seems to work nicely.  Applied, thanks.

jon