blob: 1461b12d6a7ce06ad92cbd0ceb1fe9d963037352 [file] [log] [blame]
Stephan Herrmann93860df2015-09-29 17:45:49 +02001.TH ecj 1 "10 August 2015"
2.LP
3.SH NAME
4ecj \- the eclipse JDT Batch Compiler
5.SH SYNOPSIS
6.B ecj [OPTION]... [SOURCEFILE]...
7.B ...
8.SH DESCRIPTION
9.B ecj is the batch compiler from Eclipse and is available as ecj.jar.
10Since 3.3, this jar also contains the support for jsr199 (Compiler API)
11and the support for jsr269 (Annotation processing). In order to use the
12annotations processing support, a 1.6 VM is required.
13
14.SH OPTIONS SUMMARY
15.sp
16Here is a summary of all the options, grouped by type. Explanations are in the \fBOPTIONS\fR section.
17.sp
18.ul
19ClassPath Options
20.sp
21.B \-bootclasspath \-cp|\-classpath \-extdirs \-endorseddirs \-sourcepath \-d \-encoding
22.sp
23.ul
24Compliance Options
25.sp
26.B \-target \-1.3 \-1.4 \-1.5 \-1.6 \-1.7 \-1.8 \-source
27.sp
28.ul
29Warning Options
30.sp
31.B \-?:warn \-help:warn \-warn:... \-nowarn \-err:... \-deprecation \-properties
32.sp
33.ul
34Debug Options
35.sp
36\fB\-g \-preserveAllLocals \-parameters
37.sp
38.ul
39Annotation Processing Options
40.sp
41\-Akey[=\fIvalue\fB] \-proc:[only|none] \-processor \-processorpath \-s \-XprintProcessorInfo \-XprintRounds \-classNames\fR
42.sp
43.ul
44Ignored Options (for compatibility with javac options)
45.sp
46.B \-J \-X \-O
47.sp
48.ul
49Advanced Options
50.sp
51\fB@<file> \-maxProblems \-log \-Xemacs \-proceedOnError \-verbose \-referenceInfo \-progress \-time \-noExit \-repeat \-inlineJSR \-enableJavaDoc \-missingNullDefault
52.sp
53.ul
54Helping Options
55.sp
56\-? \-help \-v \-version \-showversion
57
58.SH OPTIONS
59.sp
60.ul
61ClassPath Options
62
63.B
64.IP "\-bootclasspath <dir 1>;<dir 2>;...;<dir P>"
65This is a list of directories or jar files used to bootstrap the class files used by the compiler. By default the libraries of the running VM are used. Entries are separated by the platform path separator.
66Each directory or file can specify access rules for types between '[' and ']'.
67If no bootclasspath is specified, the compiler will infer it using the following system properties sun.boot.class.path, vm.boot.class.path or org.apache.harmony.boot.class.path in this order respectively
68
69.B
70.IP "\-cp|\-classpath <dir 1>;dir2;...<dir P>"
71This is a list of directories or jar files used to compile the source files. The default value is the value of the property "java.class.path". Entries are separated by the platform path separator.
72Each 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).
73The compiler follows the Class-Path clauses of jar files' manifests recursively and appends each referenced jar file to the end of the classpath, provided it is not on the classpath yet.
74
75.B
76.IP "\-extdirs <dir 1>;<dir 2>;...;<dir P>"
77This is a list of directories used to specify the location of extension zip/jar files. Entries are separated by the platform path separator.
78
79.B
80.IP "\-endorseddirs <dir 1>;<dir 2>;...;<dir P>"
81This is a list of directories used to specify the location of endorsed zip/jar files. Entries are separated by the platform path separator.
82
83.B
84.IP "\-sourcepath <dir 1>;<dir 2>;...;<dir P>"
85This is a list of directories used to specify the source files. Entries are separated by the platform path separator. Each directory can specify access rules for types between '[' and ']'.
86
87.B
88.IP "\-d <dir 1>|none"
89This is used to specify in which directory the generated .class files should be dumped. If it is omitted, no package directory structure is created.
90If you want to generate no .class file at all, use \-d none.
91
92.B
93.IP "\-encoding <encoding name>"
94Specify default encoding for all source files. Custom encoding can also be specified on a per file basis by suffixing each input source file/folder name with [<encoding name>]. For example X.java[UTF-8] would specify the UTF-8 encoding for the compilation unit X.java located in the current user directory.
95If multiple default source file encodings are specified, the last one will be used.
96
97For example:
98.B ... \-encoding UTF-8 X.java[Cp1252] Y.java[UTF-16] Z.java ....
99.br
100All source files will be read using UTF-8 encoding (this includes Z.java). X.java will be read using Cp1252 encoding and Y.java will be read using UTF-16 encoding.
101.sp
102.B ... \-encoding UTF-8 -encoding UTF-16 ....
103.br
104All source files will be read using UTF-16 encoding. The \-encoding option for UTF-8 is ignored.
105.sp
106.B ... \-encoding Cp1252 /foo/bar/X.java[UTF-16] /foo/bar[UTF-8] ....
107.br
108All source files will be read using Cp1252 encoding. X.java is the only file inside the /foo/bar directory to be read using the encoding UTF-16. All other files in that directory will use UTF-8 encoding.
109
110.P
111.ul
112Compliance Options
113
114.B
115.IP "\-target 1.1 to 1.8 (or 8, 8.0, etc.)"
116This specifies the .class file target setting. The possible value are:
117.br
118.B 1.1
119(major version: 45 minor: 3)
120.br
121.B 1.2
122(major version: 46 minor: 0)
123.br
124.B 1.3
125(major version: 47 minor: 0)
126.br
127.B 1.4
128(major version: 48 minor: 0)
129.br
130.B 1.5, 5 or 5.0
131(major version: 49 minor: 0)
132.br
133.B 1.6, 6 or 6.0
134(major version: 50 minor: 0)
135.br
136.B 1.7, 7 or 7.0
137(major version: 51 minor: 0)
138.br
139.B 1.8, 8 or 8.0
140(major version: 52 minor: 0)
141
142Defaults are:
143.br
1441.1 in \-1.3 mode
145.br
1461.2 in \-1.4 mode
147.br
1481.5 in \-1.5 mode
149.br
1501.6 in \-1.6 mode
151.br
1521.7 in \-1.7 mode
153.br
1541.8 in \-1.8 mode
155clcd1.1 can be used to generate the StackMap attribute.
156
157.B
158.IP \-1.3
159Set compliance level to 1.3. Implicit \-source 1.3 \-target 1.1.
160
161.B
162.IP \-1.4
163Set compliance level to 1.4 (default). Implicit \-source 1.3 \-target 1.2.
164
165.B
166.IP \-1.5
167Set compliance level to 1.5. Implicit \-source 1.5 \-target 1.5.
168
169.B
170.IP \-1.6
171Set compliance level to 1.6. Implicit \-source 1.6 \-target 1.6.
172
173.B
174.IP \-1.7
175Set compliance level to 1.7. Implicit \-source 1.7 \-target 1.7.
176
177.B
178.IP \-1.8
179Set compliance level to 1.8. Implicit \-source 1.8 \-target 1.8.
180
181.B
182.IP "\-source 1.1 to 1.8 (or 8, 8.0, etc.)"
183This is used to specify the source level expected by the compiler.
184The possible value are:
185.br
186.B 1.3
187.br
188.B 1.4
189.br
190.B 1.5, 5 or 5.0
191.br
192.B 1.6, 6 or 6.0
193.br
194.B 1.7, 7 or 7.0
195.br
196.B 1.8, 8 or 8.0
197
198Defaults are:
199.br
2001.3 in \-1.3 mode
201.br
2021.3 in \-1.4 mode
203.br
2041.5 in \-1.5 mode
205.br
2061.6 in \-1.6 mode
207.br
2081.7 in \-1.7 mode
209.br
2101.8 in \-1.8 mode
211.br
212In 1.4, assert is treated as a keyword. In 1.5 and 1.6, enum and assert are treated as keywords.
213
214.P
215.ul
216Warning Options
217
218.B
219.IP "\-?:warn \-help:warn"
220Display advanced warning options
221
222.B
223.IP "\-warn:..."
224Specify the set of enabled warnings.
225.br
226.B \-warn:none\fR \t\t\t\t\t\tdisable all warnings
227.br
228.B \-warn:\fI<warning tokens separated by ,>\fR \tenable exactly the listed warnings
229.br
230.B \-warn:+\fI<warning tokens separated by ,>\fR \tenable additional warnings
231.br
232.B \-warn:\-\fI<warning tokens separated by ,>\fR \tdisable specific warnings
233
234Examples:
235
236.B\-warn:unusedLocal,deprecation
237.br
238enables only the given two warning options and disables all the other options
239.sp
240.B\-warn:\-unusedLocal,deprecation,+fallthrough
241.br
242disables unusedLocal and deprecation, enables fallthrough, and leaves the other warning options untouched
243.sp
244The first column below shows the default state for an option. A mark "+/-" indicates that an option covers several fine grained warning variants, some of which are enabled by default, others disabled. This means that specifying the given option with "+" will enable more warnings than the default, and specifying "-" disables some that are enabled by default.
245.sp
246
247+/-
248.B allDeadCode
249dead code including trivial if (DEBUG) check
250.sp
251+/-
252.B allDeprecation
253deprecation even inside deprecated code
254.sp
255\ -\
256.B allJavadoc
257invalid or missing Javadoc
258.sp
259\ -\
260.B allOver-ann
261all missing @Override annotations (superclass and superinterfaces)
262.sp
263\ -\
264.B all-static-method
265all method can be declared as static warnings
266.sp
267\ +\
268.B assertIdentifier
269occurrence of assert used as identifier
270.sp
271\ -\
272.B boxing
273autoboxing conversion
274.sp
275\ +\
276.B charConcat
277when a char array is used in a string concatenation without being converted explicitly to a string
278.sp
279\ +\
280.B compareIdentical
281comparing identical expressions
282.sp
283\ -\
284.B conditionAssign
285possible accidental boolean assignment
286.sp
287\ +\
288.B constructorName
289method with constructor name
290.sp
291\ +\
292.B deadCode
293dead code excluding trivial if (DEBUG) check
294.sp
295\ -\
296.B dep\-ann
297missing @Deprecated annotation
298.sp
299+/-
300.B deprecation
301usage of deprecated type or member outside deprecated code
302.sp
303\ +\
304.B discouraged
305use of types matching a discouraged access rule
306.sp
307\ -\
308.B emptyBlock
309undocumented empty block
310.sp
311\ +\
312.B enumIdentifier
313occurrence of enum used as identifier
314.sp
315\ +\
316.B enumSwitch
317incomplete enum switch
318.sp
319\ -\
320.B enumSwitchPedantic
321report missing enum switch cases even in the presence of a default case
322.sp
323\ -\
324.B fallthrough
325possible fall-through case
326.sp
327\ -\
328.B fieldHiding
329field hiding another variable
330.sp
331\ +\
332.B finalBound
333type parameter with final bound
334.sp
335\ +\
336.B finally
337finally block not completing normally
338.sp
339\ +\
340.B forbidden
341use of types matching a forbidden access rule
342.sp
343\ -\
344.B hashCode
345missing hashCode() method when overriding equals()
346.sp
347+/-
348.B hiding
349macro for fieldHiding, localHiding, maskedCatchBlock, and typeHiding
350.sp
351\ -\
352.B includeAssertNull
353raise null warnings for variables that got tainted in an assert expression
354.sp
355\ -\
356.B indirectStatic
357indirect reference to static member
358.sp
359\ -\
360.B inheritNullAnnot
361consider null annotations as being inherited from an overridden method to any overriding methods
362.sp
363\ +\
364.B intfAnnotation
365annotation type used as super interface
366.sp
367\ +\
368.B intfNonInherited
369interface non-inherited method compatibility
370.sp
371\ -\
372.B intfRedundant
373find redundant superinterfaces
374.sp
375\ -\
376.B invalidJavadoc
377macro to toggle the 'malformed Javadoc comments' option and all its sub-options listed below
378.sp
379\ -\
380.B invalidJavadocTag
381report invalid Javadoc tags in Javadoc comments.
382.sp
383\ -\
384.B invalidJavadocTagDep
385report invalid deprecated references in Javadoc tag arguments
386.sp
387\ -\
388.B invalidJavadocTagNotVisible
389report invalid non-visible references in Javadoc tag arguments
390.sp
391\ -\
392.B invalidJavadocVisibility(\fI<visibility>\fB)
393specify visibility modifier ("public", "protected" or "private") for malformed Javadoc tag warnings. Usage example: invalidJavadocVisibility(public)
394.sp
395\ -\
396.B javadoc
397invalid Javadoc
398.sp
399\ -\
400.B localHiding
401local variable hiding another variable
402.sp
403\ +\
404.B maskedCatchBlock
405hidden catch block
406.sp
407\ -\
408.B missingJavadocTags
409macro to toggle the 'missing Javadoc tags' option and all its sub-options listed below
410.sp
411\ -\
412.B missingJavadocTagsMethod
413report missing Javadoc tags for a method's type parameters
414.sp
415\ -\
416.B missingJavadocTagsOverriding
417report missing Javadoc tags in overriding methods
418.sp
419\ -\
420.B missingJavadocTagsVisibility(\fI<visibility>\fB)
421specify visibility modifier ("public", "protected" or "private") for missing Javadoc tags warnings. Usage example: missingJavadocTagsVisibility(public)
422.sp
423\ -\
424.B missingJavadocComments
425macro to toggle the 'missing Javadoc comments' option and all its sub-options listed below
426.sp
427\ -\
428.B missingJavadocCommentsOverriding
429report missing Javadoc comments in overriding methods
430.sp
431\ -\
432.B missingJavadocCommentsVisibility(\fI<visibility>\fB)
433specify visibility modifier ("public", "protected" or "private") for missing Javadoc comments warnings. Usage example: missingJavadocCommentsVisibility(public)
434.sp
435\ -\
436.B nls
437non-nls string literals (lacking of tags //$NON-NLS-<n>)
438.sp
439\ +\
440.B noEffectAssign
441assignment with no effect
442.sp
443\ +\
444.B nonnullNotRepeated
445nonnull parameter annotation from overridden method is not repeated in an overriding method. Is effective only with the nullAnnot option enabled.
446.sp
447+/-
448.B null
449potential missing or redundant null check
450.sp
451\ -\
452.B nullAnnot
453enable annotation based null analysis.
454If desired, the annotation types to be interpreted by the compiler can be specified by appending (nullable|nonnull|nonnullbydefault), where each annotation type is specified using its fully qualified name.
455Usage example: nullAnnot(p.Nullable|p.NonNull|p.NonNullByDefault)
456.sp
457Enabling this option enables all null-annotation related sub-options. These can be individually controlled using options listed below
458.sp
459\ -\
460.B nullAnnotConflict
461report conflicts between null annotation specified and nullness inferred. Is effective only with the nullAnnot option enabled.
462.sp
463\ -\
464.B nullAnnotRedundant
465report redundant specification of null annotation. Is effective only with the nullAnnot option enabled.
466.sp
467\ -\
468.B nullDereference
469missing null check
470.sp
471\ -\
472.B nullUncheckedConversion
473report unchecked conversion from unannotated type to @NonNull type. Is effective only with the nullAnnot option enabled.
474.sp
475\ -\
476.B over-ann
477missing @Override annotation (superclass only)
478.sp
479\ -\
480.B paramAssign
481assignment to a parameter
482.sp
483\ +\
484.B pkgDefaultMethod
485attempt to override package-default method
486.sp
487\ +\
488.B raw
489usage a of raw type (instead of a parameterized type)
490.sp
491+/-
492.B resource
493(potentially) unsafe usage of resource of type Closeable
494.sp
495\ -\
496.B semicolon
497unnecessary semicolon or empty statement
498.sp
499\ +\
500.B serial
501missing serialVersionUID
502.sp
503\ -\
504.B specialParamHiding
505constructor or setter parameter hiding another field
506.sp
507+/-
508.B static-access
509macro for indirectStatic and staticReceiver
510.sp
511\ -\
512.B static-method
513an instance method that could be as a static method
514.sp
515\ +\
516.B staticReceiver
517if a non static receiver is used to get a static field or call a static method
518.sp
519\ -\
520.B super
521overriding a method without making a super invocation
522.sp
523\ +\
524.B suppress
525enable @SuppressWarnings
526.sp
527\ -\
528.B switchDefault
529switch statement lacking a default case
530.sp
531\ -\
532.B syncOverride
533missing synchronized in synchronized method override
534.sp
535\ -\
536.B syntacticAnalysis
537perform syntax-based null analysis for fields
538.sp
539\ -\
540.B syntheticAccess
541when performing synthetic access for innerclass
542.sp
543\ -\
544.B tasks
545enable support for tasks tags in source code
546.sp
547\ +\
548.B typeHiding
549type parameter hiding another type
550.sp
551\ +\
552.B unavoidableGenericProblems
553report even unavoidable type safety problems due to raw APIs
554.sp
555\ +\
556.B unchecked
557unchecked type operation
558.sp
559\ -\
560.B unnecessaryElse
561unnecessary else clause
562.sp
563\ -\
564.B unqualifiedField
565unqualified reference to field
566.sp
567+/-
568.B unused
569macro for unusedImport, unusedLabel, unusedLocal, unusedPrivate, unusedThrown, unusedTypeArgs, and unusedTypeParameter
570.sp
571\ -\
572.B unusedAllocation
573allocating an object that is not used
574.sp
575\ -\
576.B unusedArgument
577unused method parameter (deprecated option; use unusedParam instead)
578.sp
579\ +\
580.B unusedImport
581unused import reference
582.sp
583\ +\
584.B unusedLabel
585unused label
586.sp
587\ +\
588.B unusedLocal
589unused local variable
590.sp
591\ +\
592.B unusedParam
593unused method parameter
594.sp
595\ +\
596.B unusedParamImplementing
597unused parameter for implementing method
598.sp
599\ +\
600.B unusedParamIncludeDoc
601unused parameter documented in a Javadoc comment tag
602.sp
603\ +\
604.B unusedParamOverriding
605unused parameter for overriding method
606.sp
607\ +\
608.B unusedPrivate
609unused private member declaration
610.sp
611\ -\
612.B unusedThrown
613unused declared thrown exception
614.sp
615\ -\
616.B unusedThrownIncludeDocComment
617unused declared thrown exception documented in a Javadoc comment tag
618.sp
619\ -\
620.B unusedThrownExemptExceptionThrowable
621report unused declared thrown exception but exempt Exception and Throwable
622.sp
623\ -\
624.B unusedThrownWhenOverriding
625unused declared thrown exception in overriding method
626.sp
627\ +\
628.B unusedTypeArgs
629unused type arguments for method and constructor
630.sp
631\ +\
632.B unusedTypeParameter
633unused type parameter
634.sp
635\ -\
636.B uselessTypeCheck
637unnecessary cast/instanceof operation
638.sp
639\ +\
640.B varargsCast
641varargs argument need explicit cast
642.sp
643+/-
644.B warningToken
645unhandled or unused warning token in @SuppressWarnings
646.in
647
648.B
649.IP "\-nowarn"
650No warning (equivalent to \-warn:none)
651.B
652.IP "\-err:..."
653Specify the set of enabled warnings that are converted to errors.
654.br
655E.g.
656.br
657.B \-err:unusedLocal,deprecation
658.br
659unusedLocal and deprecation warnings will be converted to errors. All other warnings are still reported as warnings.
660
661.B \-err:\fI<warning tokens separated by ,>\fR \tconvert exactly the listed warnings to errors
662.br
663.B \-err:+\fI<warning tokens separated by ,>\fR \tconvert additional warnings to errors
664.br
665.B \-err:\-\fI<warning tokens separated by ,>\fR \tremove specific warnings from being converted to errors
666
667.B
668.IP \-deprecation
669Equivalent to \-warn:+deprecation.
670.B
671.IP "\-properties <file>"
672Set 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.
673
674The properties file contents can be generated by setting project specific settings on an existing java project and using the file in .settings/org.eclipse.jdt.core.prefs file as a properties file, or a simple text file that is defined entry/value pairs using the constants defined in the org.eclipse.jdt.core.JavaCore class. Of those constants declared in this class, all options starting with "org.eclipse.jdt.core.compiler." are interpreted by the batch compiler.
675
676 ...
677.br
678org.eclipse.jdt.core.compiler.problem.annotationSuperInterface=warning
679.br
680org.eclipse.jdt.core.compiler.problem.assertIdentifier=warning
681.br
682org.eclipse.jdt.core.compiler.problem.autoboxing=ignore
683.br
684 ...
685.sp
686To ensure that a property file has the same effect when used in the IDE and for the batch compiler, use of the \-properties option will change the defaults for a few options:
687
688.br
689.B \-g\fR \t\t\t\t\tdefault changed to all enabled
690.br
691.B \-preserveAllLocals\fR \t\tdefault changed to enabled
692.br
693.B \-enableJavadoc\fR \t\tdefault changed to enabled
694.br
695error/warning \fBforbidden\fR \tdefault changed to error
696
697.P
698.ul
699Debug Options
700
701.B
702.IP "\-g[:none|:lines,vars,source]"
703Set the debug attributes level
704.br
705.B \-g\fR \t\t\t\t\tAll debug info (equivalent to \-g:lines,vars,source)
706.br
707.B \-g:none\fR \t\t\t\tNo debug info
708.br
709.B \-g:[lines,vars,source]\fR \tSelective debug info
710.br
711Not specifying this option is equivalent to setting \-g:lines,source.
712
713.B
714.IP "\-preserveAllLocals"
715Explicitly request the compiler to preserve all local variables (for debug purpose). If omitted, the compiler will remove unused locals.
716.B
717.IP "\-parameters"
718Explicitly request the compiler to preserve information about the formal parameters of a method (such as their names) to be accessed from reflection libraries, annotation processing, code weaving, and in the debugger. This option is supported from target level 1.8 and later.
719Annotation processing options (require a 1.6 VM or above and are used only if the compliance is 1.6)
720
721.P
722.ul
723Annotation Processing Options
724
725.B
726.IP "\-Akey[=value]"
727Annotation processors options that are passed to annotation processors. key is made of identifiers separated by dots
728
729.B
730.IP "\-proc:[only|none]"
731If \-proc:only is specified, the annotation processors will run but no compilation will be performed. If \-proc:none is specified, annotation processors will not be discovered or run; compilation will proceed as if no annotation processors were found. By default the compiler must search the classpath for annotation processors, so specifying \-proc:none may speed compilation if annotation processing is not required.
732.B
733.IP "\-processor <class1[,class2,...]>"
734Qualified class names of annotation processors to run. If specified, the normal processor discovery process will be skipped.
735.B
736.IP "\-processorpath <dir 1>;<dir 2>;...;<dir P>"
737A list of directories or jar files which will be searched for annotation processors. Entries are separated by the platform path separator. If not specified, the classpath will be searched instead.
738.B
739.IP "\-s <dir>"
740The directory where generated source files will be created.
741.B
742.IP "\-XprintProcessorInfo"
743Print information about which annotations and which elements a processor is asked to process
744.B
745.IP "\-XprintRounds"
746Print information about annotation processing rounds
747.B
748.IP "\-classNames <class1[,class2,...]>"
749Qualified names of binary types that need to be processed
750
751.P
752.ul
753Ignored Options (for compatibility with javac options)
754
755.B
756.IP "\-J<option>"
757Pass option to the virtual machine
758.B
759.IP "\-X<option>"
760Specify non-standard option. \-Xemacs is not ignored.
761.B
762.IP "\-X"
763Print non-standard options and exit
764.B
765.IP "\-O"
766Optimize for execution time
767
768.P
769.ul
770Advanced Options
771
772.B
773.IP "@<file>"
774Read command-line arguments from file
775.B
776.IP "\-maxProblems <n>"
777Max number of problems per compilation unit (100 by default)
778.B
779.IP "\-log <filename>"
780Specify a log file in which all output from the compiler will be dumped. This is really useful if you want to debug the batch compiler or get a file which contains all errors and warnings from a batch build. If the extension is .xml, the generated log will be an xml file.
781.B
782.IP "\-genericsignature"
783Explicitly request the compiler to preserve information about generic signature of lambda expressions.
784.B
785.IP "\-Xemacs"
786Use emacs style to present errors and warnings locations into the console and regular text logs. XML logs are unaffected by this option. With this option active, the message:
787.br
788\ \ \ \ 2. WARNING in /workspace/X.java
789.br
790\ \ \ \ (at line 8)...
791.br
792is presented as:
793.br
794\ \ \ \ /workspace/X.java:8: warning: The method...
795.br
796
797.B
798.IP "\-proceedOnError[:Fatal]"
799Keep compiling in spite of errors, dumping class files with problem methods or problem types. This is recommended only if you want to be able to run your application even if you have remaining errors.
800With ":Fatal", all optional errors are treated as fatal and this leads to code that will abort if an error is reached at runtime. Without ":Fatal", optional errors don't prevent the proper code generation and the produced .class files can be run without a problem.
801.B
802.IP "\-verbose"
803Print accessed/processed compilation units in the console or the log file if specified.
804.B
805.IP "\-referenceInfo"
806Compute reference info. This is useful only if connected to the builder. The reference infos are useless otherwise.
807.B
808.IP "\-progress"
809Show progress (only in \-log mode).
810.B
811.IP "\-time"
812Display speed information.
813.B
814.IP "\-noExit"
815Do not call System.exit(n) at end of compilation (n=0 if no error).
816.B
817.IP "\-repeat <n>"
818Repeat compilation process <n> times (perf analysis).
819.B
820.IP "\-inlineJSR"
821Inline JSR bytecode (implicit if target >= 1.5).
822.B
823.IP "\-enableJavadoc"
824Consider references inside Javadoc. The Javadoc options are effective only when this option is enabled.
825.B
826.IP "\-missingNullDefault"
827When annotation based null analysis is enabled (using "nullAnnot", above), this option will raise a warning whenever there is no default annotation on a package or a type.
828.B
829.IP "\-annotationpath"
830When annotation based null analysis is enabled (using "nullAnnot", above), this option defines locations where to find external annotations to support annotation-based null analysis.
831The value of this options is a list of directories or zip files. Entries are separated by the platform path separator.
832The special name CLASSPATH will cause lookup of external annotations from the classpath and sourcepath.
833
834.P
835.ul
836Helping Options
837
838.B
839.IP "\-? \-help"
840Display the help message.
841.B
842.IP "\-v \-version"
843Display the build number of the compiler. This is very useful to report a bug.
844.B
845.IP "\-showversion"
846Display the build number of the compiler and continue. This is very useful to report a bug.
847
848.SH SEE ALSO
849<\fBhttp://help.eclipse.org/topic/org.eclipse.jdt.doc.user/tasks/task-using_batch_compiler.htm\fR>
850.SH BUGS
851To report bugs, use <\fBhttps://bugs.eclipse.org/bugs/enter_bug.cgi?product=JDT&component=Core\fR>
852.SH AUTHOR
853For details on Eclipse committers, see <\fBhttp://www.eclipse.org/committers/\fR>