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

Re: A typesetting problem with git man pages

From
Jonas Fonseca <jonas.fonseca@gmail.com>
Date
Oct 29, 2008, 20:14 UTC
Message-ID
<2c6b72b30810291314n75154276ma226cccc1ea07504@mail.gmail.com>
In-Reply-To
<20081029193958.GA12856@sigill.intra.peff.net>
On Wed, Oct 29, 2008 at 20:39, Jeff King <peff@peff.net> wrote:
Show 7 quoted lines
> so the problem is the extra \&. But I don't know why that is being
> generated. It _should_ be part of the character entity, I thought, but
> xmlto seems to be rendering it as the newline character entity _plus_
> the ampersand.
>
> So it seems like a bug to me in the XML parser, but it is more likely
> that I'm somehow clueless about XML.

The way I understand it is that the DocBook XSL (stylesheet) doing the conversion from xml to the manpage ensures that possible problematic characters that could break the manpage are escaped. A dot in the start of a line is problematic since it could be interpreted as markup by the manpage viewer and in the mentioned case, the code was not generated by the stylesheet, thus it must be escaped. So IMO, the stylesheet is hardly to blame, the problem is that the asciidoc.conf file defines a macro for literallayout, in which it expects manpage code to be passed through unescaped.

-- 
Jonas Fonseca
Previous: Jeff King
Message 12 of 12 in “A typesetting problem with git man pages”
  1. Teemu LikonenOct 29, 2008
  2. Jonas FonsecaOct 29, 2008
  3. Teemu LikonenOct 29, 2008
  4. asciidoc: add minor workaround to add an empty line after code blocksJonas Fonseca, Oct 30, 2008
  5. Teemu LikonenOct 30, 2008
  6. Junio C HamanoNov 1, 2008
  7. Thomas AdamNov 1, 2008
  8. Kalle Olavi NiemitaloNov 3, 2008
  9. Teemu LikonenOct 31, 2008
  10. Teemu LikonenOct 31, 2008
  11. Jeff KingOct 29, 2008
  12. Jonas FonsecaOct 29, 2008

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.