Web lists-archives.com

Re: [PATCH] Doc: fix misleading asciidoc formating




On 2019-03-06, Junio Hamano, Jeff King wrote:> Jeff King <peff@xxxxxxxx>
writes
> 
>> TBH, I still have mixed feelings on rendering these technical docs with
>> asciidoc at all. It seems like few enough people bother to render them
>> that bugs persist for a long time. It kind of seems like make-work
>> getting them to format correctly.
> 
> I thought about resisting when some people started pushing for
> rendering everything under the Sun, but went with the flow as I
> lacked the energy to fight every battle in sight.
> 
> Good to see somebody shares a similar sense of trade-off, better
> late than never ;-).
> 

TBH, I discovered this while diving into the rendering on manpages for
the localized version because asciidoctor issued a warning, and pushed
this patch for "cultural" knowledge (sometimes, automatic linefeed
triggers unintended behaviors). But, as Peff noted, this may not be a
good idea to render these documents at all on git-scm.com.

In this case, there's no point in tracking rendering issues outside
genuine manpages.