On Jan 18, 2012, at 5:50 PM, Thomas Mortagne wrote:
Hi devs,
Right now renaming a key is a pain if we don't want to loose the existing translations associated to it. Basically it require to rename the key in all languages and reimport all of them on l10n.xwiki.org.
We already have a section in the translation file to indicate which translations are deprecated. The idea is to indicate what is the new name of a deprecated translation key directly in the translation file so that l10n.xwiki.org can automatically copy the translation to the new key when it find a new deprecated key while importing default translation file.
For that we need to decide a syntax to indicate what is the new name of the key.
I propose to do something similar to java and indicate it in a comment like the following:
new.key.name=Default translation
#@deprecated new.key.name old.key.name=Default translation
Here are some other alternatives to "deprecated":
* replacedBy * new
others ?
Here is my +1 for "deprecated", more intuitive for Java developers and it's clear it's a deprecated translation key.
+1 too for @deprecated (even though @replacedBy is more precise in its meaning) Thanks -Vincent FWIW, here's an real life example I have locally for this: ####################################### ## until 3.4 ####################################### #@deprecated platform.livetable.results xe.livetable.results=Livetable Results #@deprecated platform.livetable.resultsMacros xe.livetable.resultsmacros=Livetable Results Macros #@deprecated platform.livetable.actions.delete xe.livetable._actions.delete=delete #@deprecated platform.livetable.actions.rename xe.livetable._actions.rename=rename #@deprecated platform.livetable.actions.rights xe.livetable._actions.rights=rights #@deprecated platform.livetable.actions.copy xe.livetable._actions.copy=copy #@deprecated platform.livetable.filtersTitle xe.livetable.filters.title=Filter for the {0} column #@deprecated platform.livetable.loading xe.livetable.loading=Loading... #@deprecated platform.livetable.tagsHelp xe.livetable.tags.help=Click on one or more tags to filter the list #@deprecated platform.livetable.tagsHelpCancel xe.livetable.tags.help.cancel=and click again on a tag to cancel the filter #@deprecated platform.livetable.environmentCannotLoadTableMessage xe.livetable.environmentCannotLoadTableMessage=The environment prevents the table from loading data. #@deprecated platform.livetable.pagesizeLabel xe.livetable.pagesize.label=per page of #@deprecated platform.livetable.selectAll xe.livetable.select.all=All