Re: `=item 1. Text` Doesn't Produce Ordered List Item

On 07/22/2010 02:12 PM, David E. Wheeler wrote:
> On Jul 22, 2010, at 2:38 PM, Russ Allbery wrote:
> 
>> That's not because "=item * Stuff" is being specially recognized.  That's
>> because "=item <anything>" where <anything> isn't a bullet or a number
>> produces an unordered list.  perlpodspec does say that, although I admit I
>> had to read it a couple of times.

Hooboy, join the club.  I wrote that stuff /so I could forget it/.  I 
think.  I forgot.

> No, by my reading, “"=item <anything>" where <anything> isn't a bullet or a number” should be a definition list item.

To cut short an agonizingly long story, please have it be something like:
    <dt style="margin-left: 1em">

Basically: the default rendering of <dt> snaps the text /completely/ 
back to the margin that our "=over" means for us to be getting away from.

That style="..." value stops it from doing that.
Ideally it'd be in a brilliant-pod.css whose artisanal value for dt 
would be merely one facet of a gem of typographical perfection, but, uh...
I say jump into Pod/Simple/HTML.pm, strike
     item-text=dt
and go up and add
   'item-text' => '<dt style="margin-left: .5em">',
   '/item-text' => '</dt>',
and run!  Run like there's zombies chasing you, zombies made out of SGML!