[Doc-SIG] directive for flexible literate programming support?

[Frank Siebenlist]

David Goodger wrote:
> ...
> This has come up before.  See the thread starting at
> <http://thread.gmane.org/gmane.text.docutils.devel/777>, and
> specifically the message at
> <http://article.gmane.org/gmane.text.docutils.devel/790> which details
> the issues involved.  I have no problem adding a generalized literal
> block construct, providing those issues are properly addressed.  Of
> course, the code has to be written too ;-).
> 
> Community participation is encouraged; without it, I doubt I'll get to
> this any time soon.

Appreciate the hint - sorry I can't be of more help.

>  > If not, one option could be to introduce a directive that would
>  > specify how to recognize literate blocks, like:
>  >
>  > .. literate-block :: ">"
>  >
>  > which would indicate that for rest of this file, a literate block
>  > could also be identified with a block where the lines start with ">"
>  > besides the normal whitespace indentation.
> 
> I don't think we need a parameterized approach.  I suspect a
> generalized approach, as described in message 790 (link above) would
> be more successful.

Agreed.

Thanks, Frank.

-- 
Frank Siebenlist               franks at mcs.anl.gov
The Globus Alliance - Argonne National Laboratory