-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hola,

A mi entender, la internacionalizacion es uno de los puntos menos 
desarrollados en tendencias literate programming, a la cual pertenece la 
herramienta Javadoc.
La idea de abarcarlo introduciendo las posibles traducciones en el codigo 
fuente no me parece una solucion muy recomendada, sobre todo con la idea de 
soportar eventualmente un numero creciente de idiomas.
Yo propondria utilizar tags nuevos, que simplemente indicaran la clave con la 
que las traducciones se pueden obtener de un fichero de recursos.
Para ello, supongo que es recomendable echar un vistazo a las facilidades que 
brinda XDoclet a la hora de definir nuevos tags, antes que implementar 
doclets desde cero. Yo recuerdo haber echado en falta una mejor documentacion 
en ese sentido que la disponible en el sitio web de Sun.
De hecho, no se si la nueva API de taglets introduce ninguna ventaja 
apreciable. Aparentemente, parece mucho mas facil de usar, pero a cambio no 
permitiria el paso de parametros (como el nombre del bundle).
En cualquier caso, yo echaria un vistazo antes a XJavadoc, que aunque 
incompleto, dispone ya de una tarea de Ant.

http://xdoclet.sourceforge.net/xjavadoc/

Yo propondria incluir un nuevo tag para las descripciones de la clase, metodo, 
atributo, y tags concretos para @param, @return y @exception. Algo asi como 
[EMAIL PROTECTED] name}, por ejemplo, y que busque el comentario en frances en 
nombre_bundle_fr.properties, bajo la clave nombre_clase.nombre_metodo.name, 
o, en caso de colision (por sobrecarga de metodos), una nomenclatura mas 
tediosa como nombre_clase.retorno_metodo.nombre_metodo.name .

Bueno, si os animais a desarrollar un doclet multi-lenguaje yo sere de los 
primeros en aprovecharme :).

Un saludo.
Jose.
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.2 (GNU/Linux)

iD8DBQE/awyHCAvt6RF8M0cRAusdAJ9eHKLclHcf+WsDwumDJWZi1k1xHgCeKAKZ
XroMtTpGDSHxMSW+yTYBvAM=
=XcIA
-----END PGP SIGNATURE-----


---------------------------------------------------------------------
Para eliminar la suscripci�n, mail a: [EMAIL PROTECTED]
Para comandos adicionales, mail a: [EMAIL PROTECTED]


Responder a