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

Manpage rendering faults

From
FTFredrik Tolf <fredrik@dolda2000.com>
Date
Jul 18, 2007, 18:47 UTC
Message-ID
<m3odi9im5y.fsf@pc7.dolda2000.com>

I often read manpages using a `man -t whatever | ggv -' command, since I like how it is rendered in PostScript. However, it turns out that some things in the Git manpages don't really render very well using that method. For example, in the git-rebase manpage, there are two history graphs that look like this when reading the manpages normally in a terminal:

      A---B---C topic
     /
D---E---F---G master
and then
              A'--B'--C' topic
             /
D---E---F---G master
However, in the PostScript rendering, they look rather like this:
  A---B---C topic
 /
D---E---F---G master
and then
      A'--B'--C' topic
     /
D---E---F---G master

It took me quite a while to figure out that the rendering was wrong. Before that, I just couldn't figure out why git-rebase would do that. :)

Unfortunately, I can't say that I have a fix available -- particularly as I don't really know anything at all about asciidoc. I thought I'd at least let you know, though.

Fredrik Tolf
Next: Julian Phillips
Message 1 of 16 in “Manpage rendering faults”
  1. Fredrik TolfJul 18, 2007
  2. Julian PhillipsJul 18, 2007
  3. Fredrik TolfJul 18, 2007
  4. Force listingblocks to be monospaced in manpagesJulian Phillips, Jul 18, 2007
  5. Junio C HamanoJul 18, 2007
  6. Julian PhillipsJul 19, 2007
  7. Force listingblocks to be monospaced in manpagesJulian Phillips, Jul 18, 2007
  8. Junio C HamanoJul 20, 2007
  9. Julian PhillipsJul 20, 2007
  10. Update listingblock monospace fix to support all docbook versionsJulian Phillips, Jul 20, 2007
  11. Junio C HamanoJul 20, 2007
  12. Brian GernhardtJul 20, 2007
  13. Julian PhillipsJul 20, 2007
  14. Force listingblocks to be monospaced in manpagesJonas Fonseca, Jul 19, 2007
  15. Julian PhillipsJul 19, 2007
  16. Jonas FonsecaJul 19, 2007

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.