On 21.03.2011 12:45, Guenter Milde wrote:
> On 2011-02-02, Guenter Milde wrote:
>> On 2011-02-02, Stefan Merten wrote:
>>> A discussion with the Sphinx developer Georg Brandl revealed that
>>> there seems to be an inconsistency between documentation
>> and code:
>>> ... Directive types are case-insensitive
>>> single words (alphanumerics plus internal hyphens, underscores, and
>>> periods; no whitespace).
>>> A role name is a single word consisting of alphanumerics plus
>>> internal hyphens, underscores, and periods; no whitespace or other
>>> characters are allowed.
>>> # Alphanumerics with isolated internal [-._+:] chars (i.e. not 2 togeth=
>>> simplename =3D r'(?:(?!_)\w)+(?:[-._+:](?:(?!_)\w)+)*'
>>> -- docutils/parsers/rst/states.py:544
>>> which is used for role and directive names. This explicitly allows
>>> colons and pluses as well.
>>> So far in `rst.el` I used the documentation for implementing things.
>>> Thus in Sphinx where colons are extensively used in role and directive
>>> names font-locking doesn't work correctly.
>>> Is the code wrong or the documentation?
> The code "lagged" behind. I changed this in my latest SVN commit.
That reply gave me a bit of a shock... Thankfully you mean it the other
way round :)