reassign 507475 asciidoc 8.5.1-1
retitle 507475 asciidoc: HTML output for [verse] requires CSS
thanks
Hi Fredrik,
Man pages using [verse] markup render as
<div class="verseblock">
<div class="verseblock-content"><em>util</em> args...
line 2
line 3</div>
<div class="verseblock-attribution">
</div></div>
which looks great in CSS user agents, but fails in older browsers.
As jidanni writes:
> Boy you fellows really blew it with e.g., git-cat-file.html and lots
> of its brethren.
>
> > Looks fine in firefox, what's your problem?
>
> My problem is you are totally relying on CSS. In other browsers or
> devices this comes out as one line:
>
> $ w3m -cols 111 -dump /usr/share/doc/git-doc/git-cat-file.html|fgrep [-t
> git-cat-file [-t | -s | -e | -p | <type>] <object> git-cat-file [--batch |
> --batch-check] < <list-of-objects>
[...]
> Anyway, don't depend on CSS, as you then don't pass basic
> accessibility guidelines.
Jeff King wrote:
> On Fri, Dec 12, 2008 at 04:29:14AM +0800, [email protected] wrote:
>> 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).
I can reproduce this with the following, built with
'asciidoc -b xhtml11 -d manpage git-cat-file.txt'.
What do you think?
Thanks,
Jonathan
-- %< --
git-cat-file(1)
===============
NAME
----
git-cat-file - Provide content or type and size information for repository
objects
SYNOPSIS
--------
[verse]
'git cat-file' (-t | -s | -e | -p | <type>) <object>
'git cat-file' (--batch | --batch-check) < <list-of-objects>
Author
------
Written by Linus Torvalds <[email protected]>
Documentation
--------------
Documentation by David Greaves, Junio C Hamano and the git-list
<[email protected]>.
--
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]
