Re: [PATCH 0/3] doc lint fixes for pack-refs and refs
- From
Todd Zullinger <tmz@pobox.com>
- Date
- Sep 13, 2026, 14:14 UTC
- Message-ID
- <20260913141405.Dcx5xbe-@teonanacatl.net>
- In-Reply-To
- <Uds1uZlUTZi1p6vFK4zhWg@free.fr>
Hi,
Jean-Noël AVILA wrote:
Show 11 quoted lines
> When I put this linting in place, I was specifically targeting the options. > The other cases of use of definition list could range from commands to real > definitions of words (see gitglossary.adoc and git-add.adoc), and extending > the match can trigger false positives. Backticked terms are supposed to be > immutable for translators, so this formatting should not be used for real > definitions. > For this reason, the regex is restricted on purpose, but selecting the files > to check to allow to extend the range of checks. > , > FWIW, the proposed change triggers false positives for git-add.adoc, git- > push.adoc, git-difftool.adoc, git-daemon.adoc and git-fetch.adoc.
That's fine, I don't mind dropping that patch if the false positives will be more annoying than skipping the checks for commands and missing some of them.
I'll wait a little before sending a re-roll with that dropped, in case anyone spots issues in the main patches to the pack-refs and refs docs.
Thanks,
-- Todd