diff options
author | Alexander Kriegisch <Alexander@Kriegisch.name> | 2024-02-22 10:24:56 +0700 |
---|---|---|
committer | Alexander Kriegisch <Alexander@Kriegisch.name> | 2024-02-22 10:28:03 +0700 |
commit | 55708c8875719efd0ac2817512dc09b51184e792 (patch) | |
tree | 63156f40f3ebdc94caf110d7236c6eb661dd4773 /docs | |
parent | 00e1972154fe48b37d3db9983259acd85df952d9 (diff) | |
download | aspectj-55708c8875719efd0ac2817512dc09b51184e792.tar.gz aspectj-55708c8875719efd0ac2817512dc09b51184e792.zip |
ajc.adoc: Cosmetic improvements
Signed-off-by: Alexander Kriegisch <Alexander@Kriegisch.name>
Diffstat (limited to 'docs')
-rw-r--r-- | docs/devguide/ajc.adoc | 30 |
1 files changed, 15 insertions, 15 deletions
diff --git a/docs/devguide/ajc.adoc b/docs/devguide/ajc.adoc index 1a562a791..f1ac8b860 100644 --- a/docs/devguide/ajc.adoc +++ b/docs/devguide/ajc.adoc @@ -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). |