Name: krT82822 Date: 11/09/99


Classic VM (build JDK-1.2.2-001, native threads, symcjit)

Currently, developers must choose _one_ language in which to write document comments, as in...
  /**
   * This is English only. Not Japanese,...
   */

It is currently necessary to rewrite documents for a second language.

If my products need API documents in both English and Japanse,
I want to be able to write comments in both languages in one source file, as in...

  /**
   * {@locale en} These are English document comments.
   * {@locale jp} These are Japanese document comments.
   *
   * @param bar {@locale en}English {@locale jp} JAPANESE
   */
  void foo(int bar) {...}

...then compile for one "target language" at a time.

Therefore, javadoc would need new options for generating output, such as:

  -documentlocale language_country_variant

This is more than (different from ) the regular "-locale" option. Thanks.
(Review ID: 97628)
======================================================================