[Doc-SIG] directives and reversability

David Goodger dgoodger@bigfoot.com
Thu, 09 Aug 2001 23:29:31 -0400

Garth T Kidd <garth@deadlybloodyserious.com> wrote on 2001-08-09 9:58 PM:
> To minimise the impact on reversability, my current take is that pragma
> directives (at minimum) have to be represented in the output as
> directive tags, and -- if they hook the parser to extend what it can
> output -- should contain elements describing what extended elements can
> now be produced.
> No, but we should make sure that at least the parser can figure out
> which extension was responsible for the unknown element, and complain
> appropriately when trying to re-generate the input.

Something like that sounds right. Care to come up with example markup?

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