Re: [Docutils-develop] Should we add aliases for "code" directive?

[Guenter M. <mi...@us...>]

On 2011-09-20, David Goodger wrote:
> On Tue, Sep 20, 2011 at 08:24, Guenter Milde <mi...@us...> wrote:
>> On 2011-09-17, David Goodger wrote:
>>> On Sat, Sep 17, 2011 at 02:34, Guenter Milde <mi...@us...> wrote:

>>>> Should we add "code-block" and "sourcecode" aliases to the "code"
>>>> directive? This would improve compatibility with trac, Sphinx,
...
>> However, I wonder whether to add them for all languages [...]
>> parsers/rst/directives/__init__.py [...] or just for English [...]
>> parsers/rst/languages/*.py
...
>> My preference is parsers/rst/directives/__init__.py, but as
>> there is no precedence, I rather ask.

> Put the aliases in docutils/parsers/rst/languages/en.py. Synonyms are
> language-dependent; there may be no difference between terms in some
> languages.

However, this is a special case of "backwards compatibility aliases":
Sphinx and Trac use "sourcecode" or "code-block" as canonical name - it
works in all languages: If we add the aliases only for English language
mappings, non-English documents that use the established names fail when
used with Docutils 0.9.

> There is precedence: synonyms/aliases in roles, like sub/subscript etc.

In my view, code/code-block/sourcecode belongs into this category of
"international" aliases, too. This is why I dare to ask again.

Sorry for bothering,

Günter