reST Wiki mode, was [Doc-SIG] Suggestions for reST "modes"

[David Goodger]

Tony J Ibbs (Tibs) <tony@lsl.co.uk> wrote on 2001-08-09 4:43 AM:
> I'm a bit worried that directives are being used for two different
> purposes (and I *think* they may be getting confused).

I don't see much difference between "command directives" and "pragma
directives"; command directives simply don't act on any data.

The big difference I see is one of scope. A true pragma (global
directive?) will affect the entire parser session, whereas a local
directive only affects its text block.

> For pragma directives, if the directive is not recognised, I think
> that the directive *itself* should be emitted as a <literal> node,
> and that it should be flagged as an Error. That gives the user some
> hint of why their document looks odd (!).

Yes, this is the plan.

-- 
David Goodger    dgoodger@bigfoot.com    Open-source projects:
 - Python Docstring Processing System: http://docstring.sourceforge.net
 - reStructuredText: http://structuredtext.sourceforge.net
 - The Go Tools Project: http://gotools.sourceforge.net