From: Junio C Hamano <gitster@pobox.com>
Date: Wed, 18 Apr 2018 04:24:55 GMT
Subject: Re: [PATCH 0/4] doc: cleaning up instances of \--
Message-ID: <xmqq1sfdjg4o.fsf@gitster-ct.c.googlers.com>
In-Reply-To: <cover.1523991648.git.martin.agren@gmail.com>

Martin Ågren <martin.agren@gmail.com> writes:

> This is a patch series to convert \-- to -- in our documentation. The
> first patch is a reiteration of 1c262bb7b2 (doc: convert \--option to
> --option, 2015-05-13) to fix some instances that have appeared since.
> The other three patches deal with standalone "\--" which we can't
> always turn into "--" since it can be rendered as an em dash.

All looked sensible.  As you mentioned in [2/4], "\--::" that is
part of an enumulation appear in documentation for about a dozen
commands after the series, but I do not think we can avoid it.

One thing that makes me wonder related to these patches is if a
newer AsciiDoc we assume lets us do without {litdd} macro.  This
series and our earlier effort like 1c262bb7 ("doc: convert \--option
to --option", 2015-05-13) mentions that "\--word" is less pleasant
on the eyes than "--word", but the ugliness "two{litdd}words" has
over "two--words" is far worse than that, so...

Thanks, will queue.