[Doc-SIG] Re: changing comment & directive syntax
Felix Wiemann
Felix.Wiemann at gmx.net
Tue Jun 1 09:55:18 EDT 2004
David Goodger wrote:
> Felix Wiemann wrote:
>
>> IMO it's much more intuitive than the '..' syntax for comments.
>>
>> When the '.. invisible::' directive is available and when it is
>> being used, we can start phasing out the present comment syntax.
>
> I'm still unconvinced that any change in the syntax is necessary.
> I don't see enough benefit to justify the cost in broken documents.
> This needs a lot of discussion before we make any changes at all.
I think it's relatively easy to turn comments into directives in
existing documents. A regexp should do for most cases.
Anyway, after having the new invisible/comment directive for some time,
we can ask in Docutils-users if there are still many old-style comments
around.
--
When replying to my email address, ensure that the mail header contains
'Felix Wiemann'. Please don't send unrequested mails > 64 KB.
<http://www.ososo.de/>
More information about the Doc-SIG
mailing list