git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] Doc: fix misleading asciidoc formating

From
Jeff King <peff@peff.net>
Date
Mar 6, 2019, 19:06 UTC
Message-ID
<20190306190630.GB18239@sigill.intra.peff.net>
In-Reply-To
<43445278-ec9f-f3f4-89bf-cf99906fc617@free.fr>
On Wed, Mar 06, 2019 at 09:07:11AM +0100, Jean-Noël Avila wrote:
Show 5 quoted lines
> 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.

Ah, that makes sense. I do think this is an interesting gotcha, and I'm glad to have learned about it. So even if we don't apply your patch and it serves as an interesting report, I think it was still worth it.

(Though I am also happy to see it applied since you went to the trouble to make it).

-Peff
Previous: Jean-Noël AvilaNext: Junio C Hamano
Message 8 of 10 in “Doc: fix misleading asciidoc formating”
  1. Doc: fix misleading asciidoc formatingJean-Noël Avila, Mar 5, 2019
  2. Jeff KingMar 5, 2019
  3. Junio C HamanoMar 5, 2019
  4. Jeff KingMar 5, 2019
  5. Jeff KingMar 5, 2019
  6. Junio C HamanoMar 5, 2019
  7. Jean-Noël AvilaMar 6, 2019
  8. Jeff KingMar 6, 2019
  9. Junio C HamanoMar 6, 2019
  10. Junio C HamanoMar 5, 2019

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.