All,
This is already a de-facto standard (I think), but I propose that we
make an actual decision rather than just leave it as a loose policy. If
this has already been decided, please point me to some evidence of that.
I know that the official language of the ASF and all mailing list comms,
etc. should be conducted in English, but does that cover the documentation?
Without a lot of fuss, we can only generate Javadoc in a single
language. Thus far, all release managers have been using English as
their default locale during builds, which results in English-language
javadocs. The ant script doesn't specify a language (probably so users
can get javadocs in their own language!), so it must be that the RM is
doing this, possibly passively.
Assuming we agree that the official releases of Tomcat should have
documentation in English, then I have a further proposal:
- Add "locale" attribute to the <javadoc> tasks in the build with
an explicit locale
For release-managers, I will update the pre-release target to include
javadoc-locale=en_US (or en_GB or just 'en' if we like).
In build.properties.default, I will set javadoc-locale to ${user.language}.
This should allow anyone downstream to build javadocs in their own
language (either via git clone or pulling the source and removing the
javadoc-locale in build.properties.release) and also users in
non-English default locales to verify a release build.
Now that I've written the above paragraph, it does mean that it's not
trivial for a user to build the javadocs in their own language. I'd love
to hear some suggestions for how to do that with an official source
package. Maybe the "release" target can set the locale somehow. ATM, the
<property> tasks that set up all the properties are outside any target
and apply before any targets get to run, so they cannot be conditional.
We could change that if we want to, though...
-chris
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
