Re: [PATCH 4/5] doc: use .adoc extension for AsciiDoc files

From: Junio C Hamano <gitster@pobox.com>
Date: Feb 7, 2025, 18:05 UTC
Message-ID: <xmqqtt95fx62.fsf@gitster.g>
In-Reply-To: <CALnO6CAa+6xx885TdKFrpruxHbN80S3RE=STaswnaUz_3QZQ=Q@mail.gmail.com>

"D. Ben Knoble" <ben.knoble@gmail.com> writes:

Show 7 quoted lines

>> Do we pass SubmittingPatches (and CodingGuidelines for that matter)
>> through AsciiDoc?  They do not even have .txt suffix, so I suspect
>> it is not.
>
> I don't know how (I didn't dig), but we do build and package
> HTML-ified SubmittingPatches as both $(git
> --html-path)/SubmittingPatches.{html,txt}. I don't see a build output

I was wondering why we remove SubmittingPatches.txt with "make clean" there the other day. There is a Documentation/Makefile target to create %.txt from % applied for SubmittingPatches.

> for CodingGuidelines, though. (We also package
> ReviewingGuidelines.{html,txt}, but it has a .txt extension.)

Thanks for noticing an annoying inconsistency that must be rectified independent of brian's topic to help it easier for Editors to identify the files that are written in AsciiDoc. If we are shipping documents that are exclusively meant for Git developers, we should be shipping all of them together.

Thanks.