RFR 9 (xs): 8171395 (jdeprscan) add comments to L10N message file

[Leo Jiang]

Looks very good, definitely help translators to do their works better. Thank you!

-Leo

On 03/14/2017 11:35 AM, Stuart Marks wrote:
> Hi Leo, all,
>
> Please review this small changeset to the jdeprscan resource properties file. It simply adds some comments to explain
> the various format elements, to help out with translation. Patch appended below.
>
> Thanks,
>
> s'marks
>
>
> # HG changeset patch
> # User smarks
> # Date 1489457980 25200
> #      Mon Mar 13 19:19:40 2017 -0700
> # Node ID 9a523636445575e5b174ed78e8f0779b4cae8fd2
> # Parent  6b51827c339c267f484248c9bd10e6bc9fe00703
> 8171395: (jdeprscan) add comments to L10N message file
> Reviewed-by: XXX
>
> diff -r 6b51827c339c -r 9a5236364455 src/jdk.jdeps/share/classes/com/sun/tools/jdeprscan/resources/jdeprscan.properties
> --- a/src/jdk.jdeps/share/classes/com/sun/tools/jdeprscan/resources/jdeprscan.properties Fri Mar 10 09:52:49 2017 -0800
> +++ b/src/jdk.jdeps/share/classes/com/sun/tools/jdeprscan/resources/jdeprscan.properties Mon Mar 13 19:19:40 2017 -0700
> @@ -75,24 +75,52 @@
>
>  scan.process.class=Processing class {0}...
>
> +# The "removal tag": empty for normal deprecations,
> +# nonempty for removal deprecations; do not translate.
>  scan.dep.normal=
>  scan.dep.removal=(forRemoval=true)
>
>  scan.err.exception=error: unexpected exception {0}
>  scan.err.noclass=error: cannot find class {0}
>  scan.err.nofile=error: cannot find file {0}
> +
> +# 0: class name, 1: method name, 2: parameter and return types
>  scan.err.nomethod=error: cannot resolve Methodref {0}.{1}:{2}
>
>  scan.head.jar=Jar file {0}:
>  scan.head.dir=Directory {0}:
>
> +# In all of the messages below, 0 and 1 are as follows:
> +#   0: type kind (class, interface, enum, or annotation type)
> +#   1: type name
> +# The last element is generally a "removal tag"; see above.
> +
> +# 2: class name, 3: removal tag
>  scan.out.extends={0} {1} extends deprecated class {2} {3}
> +
> +# 2: interface name, 3: removal tag
>  scan.out.implements={0} {1} implements deprecated interface {2} {3}
> +
> +# 2: class name, 3: removal tag
>  scan.out.usesclass={0} {1} uses deprecated class {2} {3}
> +
> +# 2: class name, 3: method name, 4: method parameter and return types, 5: removal tag
>  scan.out.usesmethod={0} {1} uses deprecated method {2}::{3}{4} {5}
> +
> +# 2: class name, 3: method name, 4: method parameter and return types, 5: removal tag
>  scan.out.usesintfmethod={0} {1} uses deprecated method {2}::{3}{4} {5}
> +
> +# 2: class name, 3: field name, 4: removal tag
>  scan.out.usesfield={0} {1} uses deprecated field {2}::{3} {4}
> +
> +# 2: field name, 3: type name, 4: removal tag
>  scan.out.hasfield={0} {1} has field named {2} of deprecated type {3} {4}
> +
> +# 2: method name, 3: parameter type, 4: removal tag
>  scan.out.methodparmtype={0} {1} has method named {2} having deprecated parameter type {3} {4}
> +
> +# 2: method name, 3: return type, 4: removal tag
>  scan.out.methodrettype={0} {1} has method named {2} having deprecated return type {3} {4}
> +
> +# 2: class name, 3: method name, 4: method parameter and return types, 5: removal tag
>  scan.out.methodoverride={0} {1} overrides deprecated method {2}::{3}{4} {5}
>