[Doc-SIG] Re: changing comment & directive syntax

[Felix Wiemann]

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/>