Bug#507475: (fwd) Re: verseblock in textbrowsers

[Alexander Wirt]

tag 507475 upstream
thanks

Here the answer of Stuart, with some workarounds: 

From: Stuart Rackham <srack...@gmail.com>
Subject: Re: verseblock in textbrowsers
To: ascii...@googlegroups.com
Date: Mon, 04 Jan 2010 18:14:27 +1300
User-Agent: Thunderbird 2.0.0.23 (X11/20090817)

Hi Alexander

Alexander Wirt wrote:
> Hi,
> 
> I have a bug against the debian package [1] that complains about the
> formatting of the verseblocks in textbrowser. The git manpages use
> something like this:
> 
> [verse]
> 'git cat-file' (-t | -s | -e | -p | <type>) <object>
> 'git cat-file' (--batch | --batch-check) < <list-of-objects>
> 
> which becomes:
> 
> <div class="verseblock">
> <div class="verseblock-content"><em>git cat-file</em> (-t | -s | -e | -
> p | &lt;type&gt;) &lt;object&gt;
> 
> <em>git cat-file</em> (--batch | --batch-check) &lt; &lt;list-of-
> objects&gt;</div>
> <div class="verseblock-attribution">
> </div></div>
> 
> this renders nice with css enabled browsers. But with textbrowsers
> like w3m the white-space: pre; from the css gets of course lost. And
> the two lines render like one line.
> 
> Using <pre class="verseblock-content"> instead of <div
> class="verseblock-content"> could help here.
> 
> What do you think?

If it doesn't cause any regressions then fine -- I've put it on my TODO list.

Instead of using a verse style paragraph you could simply add explicit line 
breaks, e.g.

'git cat-file' (-t | -s | -e | -p | <type>) <object> +
'git cat-file' (--batch | --batch-check) < <list-of-objects>

Though it would probably look better monospaced (the literal paragraphs and 
blocks do use <pre>):

[subs="normal"]
   'git cat-file' (-t | -s | -e | -p | <type>) <object>
   'git cat-file' (--batch | --batch-check) < <list-of-objects>

or, equivalently:

[subs="normal"]
............................................................
'git cat-file' (-t | -s | -e | -p | <type>) <object>
'git cat-file' (--batch | --batch-check) < <list-of-objects>
............................................................


Cheers, Stuart





--
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org