Re: [Docutils-develop] emphasis/strong within literal_block?

[Bill B. <bb...@co...>]

On Tuesday, Dec 24, 2002, at 08:42 US/Eastern, Benja Fallenstein wrote:
> Hiya,
>
> Bill Bumgarner wrote:
>
>> I understand that :: basically leads to a literal block, but I don't 
>> see anything that causes a parsed-literal to be used instead?
> IIRC parsed-literal is a directive, so,
>
> .. parsed-literal::
> <something>
>
> (where the 'something' is indented, in case my stupid mailer messes 
> that up again :-( )

Right. Got it.  That works great.

But it looks ugly-- it is the first intrusive formatting command I have 
had to include in the documents.   Feature request;  maybe if a 
paragraph ends in :;, the following block is a parsed literal as 
opposed to a literal block?

In general, I'm finding that basic docutils usage is straightforward 
and easy, but there is a HUGE learning curve between basic usage and 
advanced/competent/complete usage.  I.e. it took me quite a bit of 
experimentation to figure out how to control section levels.

This is not a complaint or criticism-- docutils is at 0.2 and is 
already of a quality to be both useful and approachable (the ROI is 
good)-- just a comment.   (Heck, PyObjC is in its 7th year of 
development, is at version 0.8, and *still* doesn't have real docs... 
:-)

The generic/simple HTML parser is now actually useful -- i.e. I'm 
actually using it to write O'Reilly articles in the format they require 
and it is considerably faster than using Word, less tedious than 
writing raw HTML, and a heck of a lot more presentable than doing 
straight unformatted text.

b.bum