Browse Source

ajc.adoc: Cosmetic improvements

Signed-off-by: Alexander Kriegisch <Alexander@Kriegisch.name>
tags/V1_9_21_2
Alexander Kriegisch 2 months ago
parent
commit
55708c8875
1 changed files with 15 additions and 15 deletions
  1. 15
    15
      docs/devguide/ajc.adoc

+ 15
- 15
docs/devguide/ajc.adoc View File

=== Options === Options


`-injars <JarList>`:: `-injars <JarList>`::
deprecated: since 1.2, use -inpath, which also takes directories.
deprecated: since 1.2, use `-inpath`, which also takes directories.
`-inpath <Path>`:: `-inpath <Path>`::
Accept as source bytecode any .class files in the .jar files or Accept as source bytecode any .class files in the .jar files or
directories on Path. The output will include these classes, possibly directories on Path. The output will include these classes, possibly
the compiler. When running the output classes, the run classpath the compiler. When running the output classes, the run classpath
should contain all aspectpath entries. Path, like classpath, is a should contain all aspectpath entries. Path, like classpath, is a
single argument containing a list of paths to jar files, delimited by single argument containing a list of paths to jar files, delimited by
the platform- specific classpath delimiter.
the platform-specific classpath delimiter.
`-argfile <File>`:: `-argfile <File>`::
The file contains a line-delimited list of arguments. Each line in the 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 file should contain one option, filename, or argument string (e.g., a
working directory). Comments, as in Java, start with `//` and extend working directory). Comments, as in Java, start with `//` and extend
to the end of the line. Options specified in argument files may to the end of the line. Options specified in argument files may
override rather than extending existing option values, so avoid 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>`:: `-outjar <output.jar>`::
Put output classes in zip file output.jar. Put output classes in zip file output.jar.
`-outxml`:: `-outxml`::
compiler will wait to recompile until it reads a newline from the 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 standard input, and will quit when it reads a 'q'. It will only
recompile necessary components, so a recompile should be much faster 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>`:: `-sourceroots <DirPaths>`::
Find and build all .java or .aj source files under any directory Find and build all .java or .aj source files under any directory
listed in DirPaths. DirPaths, like classpath, is a single argument listed in DirPaths. DirPaths, like classpath, is a single argument
Same as -Xlint:warning (enabled by default) Same as -Xlint:warning (enabled by default)
`-Xlint:\{level}`:: `-Xlint:\{level}`::
Set default level for messages about potential programming mistakes in 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 aspectjtools.jar, but does not override levels set using the
-Xlintfile option.
`-Xlintfile` option.
`-Xlintfile <PropertyFile>`:: `-Xlintfile <PropertyFile>`::
Specify properties file to set levels for specific crosscutting Specify properties file to set levels for specific crosscutting
messages. PropertyFile is a path to a Java .properties file that takes messages. PropertyFile is a path to a Java .properties file that takes
the same property names and values as 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. which it also overrides.
`-help`:: `-help`::
Emit information on compiler options and usage Emit information on compiler options and usage
E.g., `-11` implies `-source 11` and `-target 11`. E.g., `-11` implies `-source 11` and `-target 11`.


`-nowarn`:: `-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`. messages generated by `declare warning` or `Xlint`.
`-warn: <items>`:: `-warn: <items>`::
Emit warnings for any instances of the comma-delimited list of 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] [source, text]
.... ....
`-warn:none` does not suppress messages generated by `declare warning` `-warn:none` does not suppress messages generated by `declare warning`
or `Xlint`. or `Xlint`.
`-deprecation`:: `-deprecation`::
Same as -warn:deprecation
Same as `-warn:deprecation`
`-noImportError`:: `-noImportError`::
Emit no errors for unresolved imports Emit no errors for unresolved imports
`-proceedOnError`:: `-proceedOnError`::
Compute reference information. Compute reference information.
`-encoding <format>`:: `-encoding <format>`::
Specify default source encoding format. Specify custom encoding on a 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]'. '[encoding]'.
`-verbose`:: `-verbose`::
Emit messages about accessed/processed compilation units Emit messages about accessed/processed compilation units
`-time`:: `-time`::
Display speed information. Display speed information.
`-noExit`:: `-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 <N>`::
Repeat compilation process N times (typically to do performance Repeat compilation process N times (typically to do performance
analysis). analysis).

Loading…
Cancel
Save