Description Maxime Daniel 2007-06-05 02:30:44 EDT

Source based, v_769.

The help message reads as follows for its annotations processing part (added line numbers):
1 \ Annotation processing options:\n\
2 \   These options are meaningful only in a 1.6 environment.\n\
3 \    -Akey[=value]        annotation processors options that are made to\n\
4 \                         annotation processors. key are identifiers separated\n\
5 \                         by ''.''.\n\
6 \    -processorpath <directories and zip/jar files separated by {0}>\n\
7 \                         specify locations where to find annotation processors\n\
8 \                         If this option is not used, the classpath will be\n\
9 \                         searched for processors.\n\
10 \    -processor <class1[,class2,...]>\n\
11 \                         Qualified names of the annotation processors to run.\n\
12 \                         This bypasses the default annotation discovery process\n\
13 \    -proc:only           run annotation processors, but do not compile\n\
14 \    -proc:none           perform compilation but do not run annotation\n\
15 \                         processors\n\
16 \    -s <dir>             specify a directory where to put the generated source\n\
17 \                         files\n\
18 \    -XprintProcessorInfo print information about which annotations and which\n\
19 \                         elements a processor is asked to process\n\
20 \    -XprintRounds        print information about annotation processing rounds.\n\
21 \    -classNames <className1[,className2,...]>\n\
22 \                         Qualified names of the classes that need\n\
23 \                         to be processed\n\

Remarks and suggestions:
- line 3 is incorrect; suggest to add 'available' so as to get 'made available to';
- line 4 'key are' is a singular/plural mismatch; would suggest 'key is made of', or 'key is a suite of';
- line 19 would suggest using the simpler 'a processor processes';
- lines 22-23: I do not quite get what happens exactly here; are other classes compiled or not? how does that play along with other options?
- the use of capital letters and dots is not consistent across the help message; my guess would be that we only use capital letters following a dot, and that we use dots only in between sentences; this would lead to line 22 starting with 'qualified', line 9 not ending with a dot, etc.