Re: git-filter-branch.1: Some remarks and a patch with editorial changes for this man page

From: Junio C Hamano <gitster@pobox.com>
Date: Mar 13, 2025, 19:16 UTC
Message-ID: <xmqq34fgoi6g.fsf@gitster.g>
In-Reply-To: <174188934245.21716.6680332666412833022.reportbug@kassi.invalid.is>

Bjarni Ingi Gislason <bjarniig@simnet.is> writes:

> Package: git-man
> Version: 1:2.47.2-0.1
> Severity: minor
> Tags: patch

Thanks for noticing and reporting.

The patches you made against git-<foo>.1 files (this message and the other one for imap-send) unfortunately are not something we can use, as all we write is asciidoc sources, e.g. a URL with marked up this way,

    https://github.com/newren/git-filter-repo/[git filter-repo]

and it seems to me that the problem you are reporting and groff has trouble with is how the URL marked up that way is rendered in roff.

I think what needs to be patched would be the toolchain that goes from AsciiDoc input files to xml to manpages, not intermediate output files for individual documentation source files.

Thanks.