Re: git-doc CSS dependent, breaks down in text browsers

From: Jeff King <peff@peff.net>
Date: Dec 12, 2008, 03:33 UTC
Message-ID: <20081212033348.GA29663@coredump.intra.peff.net>
In-Reply-To: <87wse6zc9x.fsf@jidanni.org>

On Fri, Dec 12, 2008 at 04:29:14AM +0800, jidanni@jidanni.org wrote:

Show 7 quoted lines

> E.g., pages look like
> 
> SYNOPSIS
> 
> git-config [<file-option>] [type] [-z|--null] name [value [value_regex]] git-config [<file-option>] [type] --add name
> value git-config [<file-option>] [type] --replace-all name [value [value_regex]] git-config [<file-option>] [type] [-z|
> --null] --get name [value_regex] git-config [<file-option>] [type] [-z|--null] --get-all name [value_regex] git-config...

I think this is another asciidoc issue, as git merely specifies "verse" format for this section. Probably the most friendly thing to do would be to use

  <pre class="verseblock-content">

instead of

  <div class="verseblock-content">

so that non-CSS browsers fall back to preserving the line boundaries (which is what is making it look so unbearable in your text browser). But it is definitely something to be fixed in asciidoc, not in the git documentation.

-Peff