|
|
@@ -41,7 +41,7 @@ destination directory on the inpath and rebuild.) |
|
|
|
=== Options |
|
|
|
|
|
|
|
`-injars <JarList>`:: |
|
|
|
deprecated: since 1.2, use -inpath, which also takes directories. |
|
|
|
deprecated: since 1.2, use `-inpath`, which also takes directories. |
|
|
|
`-inpath <Path>`:: |
|
|
|
Accept as source bytecode any .class files in the .jar files or |
|
|
|
directories on Path. The output will include these classes, possibly |
|
|
@@ -54,7 +54,7 @@ destination directory on the inpath and rebuild.) |
|
|
|
the compiler. When running the output classes, the run classpath |
|
|
|
should contain all aspectpath entries. Path, like classpath, is a |
|
|
|
single argument containing a list of paths to jar files, delimited by |
|
|
|
the platform- specific classpath delimiter. |
|
|
|
the platform-specific classpath delimiter. |
|
|
|
`-argfile <File>`:: |
|
|
|
The file contains a line-delimited list of arguments. Each line in the |
|
|
|
file should contain one option, filename, or argument string (e.g., a |
|
|
@@ -64,9 +64,9 @@ destination directory on the inpath and rebuild.) |
|
|
|
working directory). Comments, as in Java, start with `//` and extend |
|
|
|
to the end of the line. Options specified in argument files may |
|
|
|
override rather than extending existing option values, so avoid |
|
|
|
specifying options like <-classpath> in argument files unlike the |
|
|
|
argument file is the only build specification. The form <@file> is the |
|
|
|
same as specifying <-argfile file>. |
|
|
|
specifying options like `-classpath` in argument files unlike the |
|
|
|
argument file is the only build specification. The form `@file` is the |
|
|
|
same as specifying `-argfile file`. |
|
|
|
`-outjar <output.jar>`:: |
|
|
|
Put output classes in zip file output.jar. |
|
|
|
`-outxml`:: |
|
|
@@ -78,7 +78,7 @@ destination directory on the inpath and rebuild.) |
|
|
|
compiler will wait to recompile until it reads a newline from the |
|
|
|
standard input, and will quit when it reads a 'q'. It will only |
|
|
|
recompile necessary components, so a recompile should be much faster |
|
|
|
than doing a second compile. This requires -sourceroots. |
|
|
|
than doing a second compile. This requires `-sourceroots`. |
|
|
|
`-sourceroots <DirPaths>`:: |
|
|
|
Find and build all .java or .aj source files under any directory |
|
|
|
listed in DirPaths. DirPaths, like classpath, is a single argument |
|
|
@@ -132,15 +132,15 @@ load-time weaving configuration by _aop.xml_. Current limitations include: |
|
|
|
Same as -Xlint:warning (enabled by default) |
|
|
|
`-Xlint:\{level}`:: |
|
|
|
Set default level for messages about potential programming mistakes in |
|
|
|
crosscutting code. \{level} may be ignore, warning, or error. This |
|
|
|
overrides entries in org/aspectj/weaver/XlintDefault.properties from |
|
|
|
crosscutting code. `\{level}` may be `ignore`, `warning`, or `error`. This |
|
|
|
overrides entries in _org/aspectj/weaver/XlintDefault.properties_ from |
|
|
|
aspectjtools.jar, but does not override levels set using the |
|
|
|
-Xlintfile option. |
|
|
|
`-Xlintfile` option. |
|
|
|
`-Xlintfile <PropertyFile>`:: |
|
|
|
Specify properties file to set levels for specific crosscutting |
|
|
|
messages. PropertyFile is a path to a Java .properties file that takes |
|
|
|
the same property names and values as |
|
|
|
org/aspectj/weaver/XlintDefault.properties from aspectjtools.jar, |
|
|
|
_org/aspectj/weaver/XlintDefault.properties_ from aspectjtools.jar, |
|
|
|
which it also overrides. |
|
|
|
`-help`:: |
|
|
|
Emit information on compiler options and usage |
|
|
@@ -174,11 +174,11 @@ load-time weaving configuration by _aop.xml_. Current limitations include: |
|
|
|
E.g., `-11` implies `-source 11` and `-target 11`. |
|
|
|
|
|
|
|
`-nowarn`:: |
|
|
|
Emit no warnings (equivalent to '-warn:none') This does not suppress |
|
|
|
Emit no warnings (equivalent to `-warn:none`) This does not suppress |
|
|
|
messages generated by `declare warning` or `Xlint`. |
|
|
|
`-warn: <items>`:: |
|
|
|
Emit warnings for any instances of the comma-delimited list of |
|
|
|
questionable code (eg '-warn:unusedLocals,deprecation'): |
|
|
|
questionable code (e.g. `-warn:unusedLocals,deprecation`): |
|
|
|
+ |
|
|
|
[source, text] |
|
|
|
.... |
|
|
@@ -195,7 +195,7 @@ none suppress all compiler warnings |
|
|
|
`-warn:none` does not suppress messages generated by `declare warning` |
|
|
|
or `Xlint`. |
|
|
|
`-deprecation`:: |
|
|
|
Same as -warn:deprecation |
|
|
|
Same as `-warn:deprecation` |
|
|
|
`-noImportError`:: |
|
|
|
Emit no errors for unresolved imports |
|
|
|
`-proceedOnError`:: |
|
|
@@ -217,7 +217,7 @@ none suppress all compiler warnings |
|
|
|
Compute reference information. |
|
|
|
`-encoding <format>`:: |
|
|
|
Specify default source encoding format. Specify custom encoding on a |
|
|
|
per file basis by suffixing each input source file/folder name with |
|
|
|
per-file basis by suffixing each input source file/folder name with |
|
|
|
'[encoding]'. |
|
|
|
`-verbose`:: |
|
|
|
Emit messages about accessed/processed compilation units |
|
|
@@ -230,7 +230,7 @@ none suppress all compiler warnings |
|
|
|
`-time`:: |
|
|
|
Display speed information. |
|
|
|
`-noExit`:: |
|
|
|
Do not call System.exit(n) at end of compilation (n=0 if no error) |
|
|
|
Do not call `System.exit(n)` at end of compilation (n=0 if no error) |
|
|
|
`-repeat <N>`:: |
|
|
|
Repeat compilation process N times (typically to do performance |
|
|
|
analysis). |