217 lines
6.5 KiB
Groff
217 lines
6.5 KiB
Groff
|
.TH ECJ "1" "May 2013"
|
||
|
|
.SH NAME
|
||
|
|
ecj \- manual page for eclipse JDT Compiler
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.B ecj <options> <source files>\fR
|
||
|
|
.SH DESCRIPTION
|
||
|
|
The JDT Compiler (jdtc) is a command version of Java compiler for eclipse. ecj
|
||
|
|
has basic java compiler options like SUN's javac.
|
||
|
|
.SH OPTIONS
|
||
|
|
.TP 20
|
||
|
|
\fB\-help\fR
|
||
|
|
display a help message
|
||
|
|
.TP
|
||
|
|
\fB\-version\fR
|
||
|
|
compiler version number
|
||
|
|
.SS Classpath options:
|
||
|
|
.br
|
||
|
|
.TP 20
|
||
|
|
\fB\-cp \-classpath\fR <directories and ZIP archives separated by :>
|
||
|
|
specify location for application classes and sources. Each directory or file can specify access rules for types between '[' and ']' (e.g. [-X] to forbid access to type X, [~X] to discourage access to type X, [+p/X:-p/*] to forbid access to all types in package p but allow access to p/X)
|
||
|
|
.TP
|
||
|
|
\fB\-bootclasspath\fR <directories and ZIP archives separated by :>
|
||
|
|
specify location for system classes. Each directory or file can specify access rules for types between '[' and ']'
|
||
|
|
.TP
|
||
|
|
\fB\-sourcepath\fR <directories and ZIP archives separated by :>
|
||
|
|
specify location for application sources. Each directory or file can specify access rules for types between '[' and ']'. Each directory can further specify a specific destination directory using a '-d' option between '[' and ']'; this overrides the general '-d' option.
|
||
|
|
.br
|
||
|
|
\[char46]class files created from source files contained in a jar file are put in the user.dir folder in case no general '-d' option is specified. ZIP archives cannot override the general '-d' option
|
||
|
|
.TP
|
||
|
|
\fB\-extdirs\fR <directories separated by :>
|
||
|
|
specify location for extension ZIP archives
|
||
|
|
.TP
|
||
|
|
\fB\-endoreseddirs\fR <directories separated by :>
|
||
|
|
specify location for endorsed ZIP archives
|
||
|
|
.TP
|
||
|
|
\fB\-d\fR <dir>
|
||
|
|
destination directory (if omitted no package directory structure is created); this option can be overridden per source directory
|
||
|
|
.TP
|
||
|
|
\fB\-d\fR none
|
||
|
|
generate no .class files
|
||
|
|
.TP
|
||
|
|
\fB\-encoding <enc>\fR
|
||
|
|
specify default encoding for all source files. Each file/directory can override it when suffixed with '['<enc>']' (e.g. X.java[utf8]).
|
||
|
|
.br
|
||
|
|
If multiple default encodings are specified, the last one will be used.
|
||
|
|
.SS Compliance options:
|
||
|
|
.TP 20
|
||
|
|
\fB\-1.3\fR
|
||
|
|
use 1.3 compliance (-source 1.3 -target 1.1)
|
||
|
|
.TP
|
||
|
|
\fB\-1.4\fR
|
||
|
|
use 1.4 compliance (-source 1.3 -target 1.2) (default)
|
||
|
|
.TP
|
||
|
|
\fB\-1.5 \-5 \-5.0\fR
|
||
|
|
use 1.5 compliance (-source 1.5 -target 1.5)
|
||
|
|
.TP
|
||
|
|
\fB\-1.6 \-6 \-6.0\fR
|
||
|
|
use 1.6 compliance (-source 1.6 -target 1.6)
|
||
|
|
.TP
|
||
|
|
\fB\-1.7 \-7 \-7.0\fR
|
||
|
|
use 1.7 compliance (-source 1.7 -target 1.7)
|
||
|
|
.TP
|
||
|
|
\fB\-source\fR <version>
|
||
|
|
set source level: 1.3 to 1.7 (or 5, 5.0, etc)
|
||
|
|
.TP
|
||
|
|
\fB\-target\fR <version>
|
||
|
|
set classfile target: 1.1 to 1.7 (or 5, 5.0, etc)
|
||
|
|
.br
|
||
|
|
cldc1.1 can also be used to generate the StackMap attribute
|
||
|
|
.SS Warning options:
|
||
|
|
.TP 20
|
||
|
|
\fB\-deprecation
|
||
|
|
deprecation outside deprecated code (equivalent to '-warn:+deprecation', default)
|
||
|
|
.TP
|
||
|
|
\fB\-nowarn -warn:none\fR
|
||
|
|
disable all warnings
|
||
|
|
.TP
|
||
|
|
\fB-nowarn:[<directories separated by :>]\fR
|
||
|
|
specify directories from which optional problems should be ignored
|
||
|
|
.TP
|
||
|
|
\fB\-?:warn -help:warn\fR
|
||
|
|
display advanced warning options
|
||
|
|
.SS Error options:
|
||
|
|
.TP
|
||
|
|
\fB\-err:<warnings separated by ,>
|
||
|
|
convert exactly the listed warnings to be reported as errors
|
||
|
|
.TP
|
||
|
|
\fB\-err:+<warnings separated by ,>
|
||
|
|
enable additional warnings to be reported as errors
|
||
|
|
.TP
|
||
|
|
\fB\-err:-<warnings separated by ,>
|
||
|
|
disable specific warnings to be reported as errors
|
||
|
|
.SS Setting warning or error options using properties file:
|
||
|
|
.TP 20
|
||
|
|
\fB\-properties <file>
|
||
|
|
set warnings/errors option based on the properties file contents. This option can be used with -nowarn, -err:.. or -warn:.. options, but the last one on the command line sets the options to be used.
|
||
|
|
.SS Debug options:
|
||
|
|
.TP 20
|
||
|
|
\fB\-g[:lines,vars,source]\fR
|
||
|
|
custom debug info
|
||
|
|
.TP
|
||
|
|
\fB\-g:lines,source\fR
|
||
|
|
both lines table and source debug info (default)
|
||
|
|
.TP
|
||
|
|
\fB\-g\fR
|
||
|
|
all debug info
|
||
|
|
.TP
|
||
|
|
\fB\-g:none\fR
|
||
|
|
no debug info
|
||
|
|
.TP
|
||
|
|
\fB\-preserveAllLocals\fR
|
||
|
|
preserve unused local vars for debug purpose
|
||
|
|
.SS Annotation processing options:
|
||
|
|
.PP
|
||
|
|
These options are meaningful only in a 1.6 environment.
|
||
|
|
.TP 20
|
||
|
|
\fB\-Akey[=value]\fN
|
||
|
|
options that are passed to annotation processors
|
||
|
|
.TP
|
||
|
|
\fB\-processorpath\fR <directories and ZIP archives separated by :>
|
||
|
|
specify locations where to find annotation processors. If this option is not used, the classpath will be searched for processors
|
||
|
|
.TP
|
||
|
|
\fB\-processor\fR <class1[,class2,...]>
|
||
|
|
qualified names of the annotation processors to run. This bypasses the default annotation discovery process
|
||
|
|
.TP
|
||
|
|
\fB\-proc:only
|
||
|
|
run annotation processors, but do not compile
|
||
|
|
.TP
|
||
|
|
\fB\-proc:none
|
||
|
|
perform compilation but do not run annotation processors
|
||
|
|
.TP
|
||
|
|
\fB\-s <dir>\fR
|
||
|
|
destination directory for generated source files
|
||
|
|
.TP
|
||
|
|
\fB\-XprintProcessorInfo\fR
|
||
|
|
print information about which annotations and elements a processor is asked to process
|
||
|
|
.TP
|
||
|
|
\fB\-XprintRounds\fR
|
||
|
|
print information about annotation processing rounds
|
||
|
|
.TP
|
||
|
|
\fB\-classNames <className1[,className2,...]>\fR
|
||
|
|
qualified names of binary classes to process
|
||
|
|
.SS Advanced options:
|
||
|
|
.TP 20
|
||
|
|
\fB\@<file>\fR
|
||
|
|
read command line arguments from file
|
||
|
|
.TP
|
||
|
|
\fB\-maxProblems <n>\fR
|
||
|
|
max number of problems per compilation unit (100 by default)
|
||
|
|
.TP
|
||
|
|
\fB\-log <file>\fR
|
||
|
|
log to a file. If the file extension is '.xml', then the log will be a xml file.
|
||
|
|
.TP
|
||
|
|
\fB\-proceedOnError[:Fatal]\fR
|
||
|
|
do not stop at first error, dumping class files with problem methods
|
||
|
|
.br
|
||
|
|
With ":Fatal", all optional errors are treated as fatal
|
||
|
|
.TP
|
||
|
|
\fB\-verbose\fR
|
||
|
|
enable verbose output
|
||
|
|
.TP
|
||
|
|
\fB\-referenceInfo\fR
|
||
|
|
compute reference info
|
||
|
|
.TP
|
||
|
|
\fB\-progress\fR
|
||
|
|
show progress (only in -log mode)
|
||
|
|
.TP
|
||
|
|
\fB\-time\fR
|
||
|
|
display speed information
|
||
|
|
.TP
|
||
|
|
\fB\-noExit\fR
|
||
|
|
do not call System.exit(n) at end of compilation (n==0 if no error)
|
||
|
|
.TP
|
||
|
|
\fB\-repeat <n>\fR
|
||
|
|
repeat compilation process <n> times for perf analysis
|
||
|
|
.TP
|
||
|
|
\fB\-inlineJSR\fR
|
||
|
|
inline JSR bytecode (implicit if target >= 1.5)
|
||
|
|
.TP
|
||
|
|
\fB\-enableJavadoc\fR
|
||
|
|
consider references in javadoc
|
||
|
|
.TP
|
||
|
|
\fB\-Xemacs\fR
|
||
|
|
used to enable emacs-style output in the console.
|
||
|
|
.br
|
||
|
|
It does not affect the xml log output
|
||
|
|
.TP
|
||
|
|
\fB\-missingNullDefault\fR
|
||
|
|
report missing default nullness annotation
|
||
|
|
.TP
|
||
|
|
\fB\-? \-help\fR
|
||
|
|
print help message
|
||
|
|
.TP
|
||
|
|
\fB\-v \-version\fR
|
||
|
|
print compiler version
|
||
|
|
.TP
|
||
|
|
\fB\-showversion\fR
|
||
|
|
print compiler version and continue
|
||
|
|
.SS Ignored options:
|
||
|
|
.TP 20
|
||
|
|
\fB\-J<option>\fR
|
||
|
|
pass option to virtual machine (ignored)
|
||
|
|
.TP
|
||
|
|
\fB\-X<option>\fR
|
||
|
|
specify non-standard option (ignored except for listed -X options)
|
||
|
|
.TP
|
||
|
|
\fB\-X\fR
|
||
|
|
print non-standard options and exit (ignored)
|
||
|
|
.TP
|
||
|
|
\fB\-O\fR
|
||
|
|
optimize for execution time (ignored)
|
||
|
|
.PP
|
||
|
|
.SH AUTHOR
|
||
|
|
This manual page was written by Takshi Okamoto and Jan Schulz
|
||
|
|
<debian@katzien.de>, and updated by Jon VanAlten <jon.vanalten@redhat.com>.
|
||
|
|
|