Internationalization: tags for different locales?
To describe specific algorithms, it's usefull to use the local language (instead of english) in the javadoc texts. Is there some kind of functionality to support multiple locales?
Example:
/**
* @Locale_EN{This is the englisch description.}
* @Locale_DE{Dies ist die deutsche Beschreibung.}
*
* @param1 @Locale_EN{key} @Locale_DE{schl黶sel}
* @param2 ....
*/
Javadoc does not have this functionality.
Seems useful to me. This was submitted as a formal request, but was closed (without good reason, IMHO). You could
4289667 - i18n: Allow multiple languages in a javadoc; choose a target lang for output doc
http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4289667
You could send a request to have them reopen it:
http://java.sun.com/j2se/javadoc/faq/index.html#email
but it's unlikely it would get implemened any time soon unless it had a lot of votes for it.