24 .TH "JAVAC" "1" "2018" "JDK 13" "JDK Commands"

    24 .TH "JAVAC" "1" "2019" "JDK 13" "JDK Commands"

    28 javac \- read Java class and interface definitions and compile them into

    28 javac \- read Java declarations and compile them into class files

    29 bytecode and class files

    32 \f[CB]javac\f[R] [\f[I]options\f[R]] [\f[I]sourcefiles\f[R]]

    31 \f[CB]javac\f[R] [\f[I]options\f[R]] [\f[I]sourcefiles\-or\-classnames\f[R]]

    36 See \f[B]Overview of javac Options\f[R].

    35 .RS

    37 .RS

    36 .RE

    38 .RE

    37 .TP

    39 .TP

    38 .B \f[I]sourcefiles\-or\-classnames\f[R]

    40 .B \f[I]sourcefiles\f[R]

    39 Source files to be compiled (for example, \f[CB]Shape.java\f[R]) or the

    41 One or more source files to be compiled (such as \f[CB]MyClass.java\f[R])

    40 names of previously compiled classes to be processed for annotations

    42 or processed for annotations (such as \f[CB]MyPackage.MyClass\f[R]).

    41 (for example, \f[CB]geometry.MyShape\f[R]).

    47 The \f[CB]javac\f[R] command reads class and interface definitions,

    46 The \f[CB]javac\f[R] command reads \f[I]source files\f[R] that contain

    48 written in the Java programming language, and compiles them into

    47 module, package and type declarations written in the Java programming

    49 bytecode class files.

    48 language, and compiles them into \f[I]class files\f[R] that run on the

    50 The \f[CB]javac\f[R] command can also process annotations in Java source

    49 Java Virtual Machine.

    51 files and classes.

    50 .PP

    52 .PP

    51 The \f[CB]javac\f[R] command can also \f[B]process annotations\f[R] in Java

    53 A new launcher environment variable, \f[CB]JDK_JAVAC_OPTIONS\f[R], was

    52 source files and classes.

    54 introduced in JDK 9 that prepended its content to the command line to

    53 .PP

    55 \f[CB]javac\f[R] .

    54 Source files must have a file name extension of \f[CB]\&.java\f[R].

    56 See \f[B]Using JDK_JAVAC_OPTIONS Environment Variable\f[R].

    55 Class files have a file name extension of \f[CB]\&.class\f[R].

    57 .PP

    56 Both source and class files normally have file names that identify the

    58 There are two ways to pass source code file names to \f[CB]javac\f[R].

    57 contents.

    59 .IP \[bu] 2

    58 For example, a class called \f[CB]Shape\f[R] would be declared in a source

    60 For a small number of source files, you can list the file names on the

    59 file called \f[CB]Shape.java\f[R], and compiled into a class file called

    60 \f[CB]Shape.class\f[R].

    61 .PP

    62 There are two ways to specify source files to \f[CB]javac\f[R]:

    63 .IP \[bu] 2

    64 For a small number of source files, you can list their file names on the

    64 \f[CB]\@\f[R]\f[I]filename\f[R] option on the \f[CB]javac\f[R] command line

    68 \f[CB]\@\f[R]\f[I]filename\f[R] option on the command line to specify an

    65 to include a file that lists the source file names.

    69 \f[I]argument file\f[R] that lists their file names.

    67 \f[B]javac Command\-Line Argument Files\f[R] for a description of

    71 \f[B]Command\-Line Argument Files\f[R] for a description of

    70 Source code file names must have \f[CB]\&.java\f[R] suffixes, class file

    74 The order of source files specified on the command line or in an

    71 names must have \f[CB]\&.class\f[R] suffixes, and both source and class

    75 argument file is not important.

    72 files must have root names that identify the class.

    76 \f[CB]javac\f[R] will compile the files together, as a group, and will

    73 For example, a class called \f[CB]MyClass\f[R] would be written in a

    77 automatically resolve any dependencies between the declarations in the

    74 source file called \f[CB]MyClass.java\f[R] and compiled into a bytecode

    78 various source files.

    75 class file called \f[CB]MyClass.class\f[R].

    79 .PP

    76 .PP

    80 \f[CB]javac\f[R] expects that source files are arranged in one or more

    77 Inner class definitions produce additional class files.

    81 directory hierarchies on the file system, described in \f[B]Arrangement

    78 These class files have names that combine the inner and outer class

    82 of Source Code\f[R].

    79 names, such as \f[CB]MyClass$MyInnerClass.class\f[R].

    83 .PP

    80 .PP

    84 To compile a source file, \f[CB]javac\f[R] needs to find the declaration

    81 You should arrange the source files in a directory tree that reflects

    85 of every class or interface that is used, extended, or implemented by

    82 their package tree.

    86 the code in the source file.

    83 For example:

    87 This lets \f[CB]javac\f[R] check that the code has the right to access

    84 .IP \[bu] 2

    88 those classes and interfaces.

    85 \f[B]Oracle Solaris, Linux, and OS X:\f[R] If all of your source files

    89 Rather than specifying the source files of those classes and interfaces

    86 are in \f[CB]/workspace\f[R], then put the source code for

    90 explicitly, you can use command\-line options to tell \f[CB]javac\f[R]

    87 \f[CB]com.mysoft.mypack.MyClass\f[R] in

    91 where to search for their source files.

    88 \f[CB]/workspace/com/mysoft/mypack/MyClass.java\f[R].

    92 If you have compiled those source files previously, you can use options

    89 .IP \[bu] 2

    93 to tell \f[CB]javac\f[R] where to search for the corresponding class

    90 \f[B]Windows:\f[R] If all of your source files are in

    94 files.

    91 \f[CB]\\workspace\f[R], then put the source code for

    95 The options, which all have names ending in "path", are described in

    92 \f[CB]com.mysoft.mypack.MyClass\f[R] in

    96 \f[B]Standard Options\f[R], and further described in \f[B]Configuring a

    93 \f[CB]\\workspace\\com\\mysoft\\mypack\\MyClass.java\f[R].

    97 Compilation\f[R] and \f[B]Searching for Module, Package and Type

    94 .PP

    98 Declarations\f[R].

    95 By default, the compiler puts each class file in the same directory as

    99 .PP

    96 its source file.

   100 By default, \f[CB]javac\f[R] compiles each source file to a class file in

    97 You can specify a separate destination directory with the \f[CB]\-d\f[R]

   101 the same directory as the source file.

    98 option described in \f[B]Standard Options\f[R].

   102 However, it is recommended to specify a separate destination directory

    99 .SH PROGRAMMATIC INTERFACE

   103 with the \f[CB]\-d\f[R] option described in \f[B]Standard Options\f[R].

   100 .PP

   104 .PP

   101 The \f[CB]javac\f[R] command supports the new Java Compiler API defined by

   105 Command\-line \f[B]options\f[R] and \f[B]environment variables\f[R] also

   102 the classes and interfaces in the \f[CB]javax.tools\f[R] package.

   106 control how \f[CB]javac\f[R] performs various tasks:

   103 .SH IMPLICITLY LOADED SOURCE FILES

   107 .IP \[bu] 2

   104 .PP

   108 Compiling code to run on earlier releases of the JDK.

   105 To compile a set of source files, the compiler might need to implicitly

   109 .IP \[bu] 2

   106 load additional source files.

   110 Compiling code to run under a debugger.

   107 See \f[B]Searching for Types\f[R].

   111 .IP \[bu] 2

   108 Such files are currently not subject to annotation processing.

   112 Checking for stylistic issues in Java source code.

   109 By default, the compiler gives a warning when annotation processing

   113 .IP \[bu] 2

   110 occurs and any implicitly loaded source files are compiled.

   114 Checking for problems in \f[CB]javadoc\f[R] comments

   111 The \f[CB]\-implicit\f[R] option provides a way to suppress the warning.

   115 (\f[CB]/**\ ...\ */\f[R]).

   112 .SH USING JDK_JAVAC_OPTIONS ENVIRONMENT VARIABLE

   116 .IP \[bu] 2

   117 Processing annotations in source files and class files.

   118 .IP \[bu] 2

   119 Upgrading and patching modules in the compile\-time environment.

   120 .PP

   121 \f[CB]javac\f[R] supports \f[B]Compiling for Earlier Releases Of The

   122 Platform\f[R] and can also be invoked from Java code using one of a

   123 number of \f[B]APIs\f[R]

   124 .SH OPTIONS

   125 .PP

   126 \f[CB]javac\f[R] provides \f[B]standard options\f[R], and \f[B]extra

   127 options\f[R] that are either non\-standard or are for advanced use.

   128 .PP

   129 Some options take one or more arguments.

   130 If an argument contains spaces or other whitespace characters, the value

   131 should be quoted according to the conventions of the environment being

   132 used to invoke javac.

   133 If the option begins with a single dash (\f[CB]\-\f[R]) the argument

   134 should either directly follow the option name, or should be separated

   135 with a colon (\f[CB]:\f[R]) or whitespace, depending on the option.

   136 If the option begins with a double dash (\f[CB]\-\-\f[R]), the argument

   137 may be separated either by whitespace or by an equals (\f[CB]=\f[R])

   138 character with no additional whitespace.

   139 For example,

   140 .IP

   141 .nf

   142 \f[CB]

   143 \-Aname="J.\ Duke"

   144 \-proc:only

   145 \-d\ myDirectory

   146 \-\-module\-version\ 3

   147 \-\-module\-version=3

   148 \f[R]

   149 .fi

   150 .PP

   151 In the following lists of options, an argument of \f[I]path\f[R]

   152 represents a search path, composed of a list of file system locations

   153 separated by the platform path separator character, (semicolon

   154 \f[CB];\f[R] on Windows, or colon \f[CB]:\f[R] on other systems.) Depending

   155 on the option, the file system locations may be directories, JAR files

   156 or JMOD files.

   157 .SS Standard Options

   158 .TP

   159 .B \f[CB]\@\f[R]\f[I]filename\f[R]

   160 Reads options and file names from a file.

   161 To shorten or simplify the \f[CB]javac\f[R] command, you can specify one

   162 or more files that contain arguments to the \f[CB]javac\f[R] command

   163 (except \f[CB]\-J\f[R] options).

   164 This lets you to create \f[CB]javac\f[R] commands of any length on any

   165 operating system.

   166 See \f[B]Command\-Line Argument Files\f[R].

   167 .RS

   168 .RE

   169 .TP

   170 .B \f[CB]\-A\f[R]\f[I]key\f[R][\f[CB]=\f[R]\f[I]value\f[R]]

   171 Specifies options to pass to annotation processors.

   172 These options are not interpreted by \f[CB]javac\f[R] directly, but are

   173 made available for use by individual processors.

   174 The \f[I]key\f[R] value should be one or more identifiers separated by a

   175 dot (\f[CB]\&.\f[R]).

   176 .RS

   177 .RE

   178 .TP

   179 .B \f[CB]\-\-add\-modules\f[R] \f[I]module\f[R]\f[CB],\f[R]\f[I]module\f[R]

   180 Specifies root modules to resolve in addition to the initial modules, or

   181 all modules on the module path if \f[I]module\f[R] is

   182 \f[CB]ALL\-MODULE\-PATH.\f[R]

   183 .RS

   184 .RE

   185 .TP

   186 .B \f[CB]\-\-boot\-class\-path\f[R] \f[I]path\f[R] or \f[CB]\-bootclasspath\f[R] \f[I]path\f[R]

   187 Overrides the location of the bootstrap class files.

   188 .RS

   189 .PP

   190 \f[B]Note:\f[R] This can only be used when compiling for releases prior

   191 to JDK 9.

   192 As applicable, see the descriptions in \f[CB]\-\-release\f[R],

   193 \f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details.

   194 For JDK 9 or later, see \f[CB]\-\-system\f[R].

   195 .RE

   196 .TP

   197 .B \f[CB]\-\-class\-path\f[R] \f[I]path\f[R], \f[CB]\-classpath\f[R] \f[I]path\f[R], or \f[CB]\-cp\f[R] \f[I]path\f[R]

   198 Specifies where to find user class files and annotation processors.

   199 This class path overrides the user class path in the \f[CB]CLASSPATH\f[R]

   200 environment variable.

   201 .RS

   202 .IP \[bu] 2

   203 If \f[CB]\-\-class\-path\f[R], \f[CB]\-classpath\f[R], or \f[CB]\-cp\f[R] are

   204 not specified, then the user class path is the value of the

   205 \f[CB]CLASSPATH\f[R] environment variable, if that is set, or else the

   206 current directory.

   207 .IP \[bu] 2

   208 If not compiling code for modules, if the \f[CB]\-\-source\-path\f[R] or

   209 \-sourcepath` option is not specified, then the user class path is also

   210 searched for source files.

   211 .IP \[bu] 2

   212 If the \f[CB]\-processorpath\f[R] option is not specified, then the class

   213 path is also searched for annotation processors.

   214 .RE

   215 .TP

   216 .B \f[CB]\-d\f[R] \f[I]directory\f[R]

   217 Sets the destination directory (or \f[I]class output directory\f[R]) for

   218 class files.

   219 If a class is part of a package, then \f[CB]javac\f[R] puts the class file

   220 in a subdirectory that reflects the module name (if appropriate) and

   221 package name.

   222 The directory, and any necessary subdirectories, will be created if they

   223 do not already exist.

   224 .RS

   225 .PP

   226 If the \f[CB]\-d\f[R] option is not specified, then \f[CB]javac\f[R] puts

   227 each class file in the same directory as the source file from which it

   228 was generated.

   229 .PP

   230 Except when compiling code for multiple modules, the contents of the

   231 class output directory will be organized in a package hierarchy.

   232 When compiling code for multiple modules, the contents of the output

   233 directory will be organized in a module hierarchy, with the contents of

   234 each module in a separate subdirectory, each organized as a package

   235 hierarchy.

   236 .PP

   237 \f[B]Note:\f[R] When compiling code for one or more modules, the class

   238 output directory will automatically be checked when searching for

   239 previously compiled classes.

   240 When not compiling for modules, for backwards compatibility, the

   241 directory is \f[I]not\f[R] automatically checked for previously compiled

   242 classes, and so it is recommended to specify the class output directory

   243 as one of the locations on the user class path, using the

   244 \f[CB]\-\-class\-path\f[R] option or one of its alternate forms.

   245 .RE

   246 .TP

   247 .B \f[CB]\-deprecation\f[R]

   248 Shows a description of each use or override of a deprecated member or

   249 class.

   250 Without the \f[CB]\-deprecation\f[R] option, \f[CB]javac\f[R] shows a

   251 summary of the source files that use or override deprecated members or

   252 classes.

   253 The \f[CB]\-deprecation\f[R] option is shorthand for

   254 \f[CB]\-Xlint:deprecation\f[R].

   255 .RS

   256 .RE

   257 .TP

   258 .B \f[CB]\-\-enable\-preview\f[R]

   259 Enables preview language features.

   260 Used in conjunction with either \f[CB]\-source\f[R] or

   261 \f[CB]\-\-release\f[R].

   262 .RS

   263 .RE

   264 .TP

   265 .B \f[CB]\-encoding\f[R] \f[I]encoding\f[R]

   266 Specifies character encoding used by source files, such as EUC\-JP and

   267 UTF\-8.

   268 If the \f[CB]\-encoding\f[R] option is not specified, then the platform

   269 default converter is used.

   270 .RS

   271 .RE

   272 .TP

   273 .B \f[CB]\-endorseddirs\f[R] \f[I]directories\f[R]

   274 Overrides the location of the endorsed standards path.

   275 .RS

   276 .PP

   277 \f[B]Note:\f[R] This can only be used when compiling for releases prior

   278 to JDK 9.

   279 As applicable, see the descriptions in \f[CB]\-\-release\f[R],

   280 \f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details.

   281 .RE

   282 .TP

   283 .B \f[CB]\-extdirs\f[R] \f[I]directories\f[R]

   284 Overrides the location of the installed extensions.

   285 \f[CB]directories\f[R] is a list of directories, separated by the platform

   286 path separator (\f[CB];\f[R] on Windows, and \f[CB]:\f[R] otherwise).

   287 Each JAR file in the specified directories is searched for class files.

   288 All JAR files found become part of the class path.

   289 .RS

   290 .PP

   291 If you are compiling for a release of the platform that supports the

   292 Extension Mechanism, then this option specifies the directories that

   293 contain the extension classes.

   294 See [Compiling for Other Releases of the Platform].

   295 .PP

   296 \f[B]Note:\f[R] This can only be used when compiling for releases prior

   297 to JDK 9.

   298 As applicable, see the descriptions in \f[CB]\-\-release\f[R],

   299 \f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details.

   300 .RE

   301 .TP

   302 .B \f[CB]\-g\f[R]

   303 Generates all debugging information, including local variables.

   304 By default, only line number and source file information is generated.

   305 .RS

   306 .RE

   307 .TP

   308 .B \f[CB]\-g:\f[R][\f[CB]lines\f[R], \f[CB]vars\f[R], \f[CB]source\f[R]]

   309 Generates only the kinds of debugging information specified by the

   310 comma\-separated list of keywords.

   311 Valid keywords are:

   312 .RS

   313 .TP

   314 .B \f[CB]lines\f[R]

   315 Line number debugging information.

   316 .RS

   317 .RE

   318 .TP

   319 .B \f[CB]vars\f[R]

   320 Local variable debugging information.

   321 .RS

   322 .RE

   323 .TP

   324 .B \f[CB]source\f[R]

   325 Source file debugging information.

   326 .RS

   327 .RE

   328 .RE

   329 .TP

   330 .B \f[CB]\-g:none\f[R]

   331 Does not generate debugging information.

   332 .RS

   333 .RE

   334 .TP

   335 .B \f[CB]\-h\f[R] \f[I]directory\f[R]

   336 Specifies where to place generated native header files.

   337 .RS

   338 .PP

   339 When you specify this option, a native header file is generated for each

   340 class that contains native methods or that has one or more constants

   341 annotated with the \f[B]\f[BC]java.lang.annotation.Native\f[B]\f[R]

   342 annotation.

   343 If the class is part of a package, then the compiler puts the native

   344 header file in a subdirectory that reflects the module name (if

   345 appropriate) and package name.

   346 The directory, and any necessary subdirectories, will be created if they

   347 do not already exist.

   348 .RE

   349 .TP

   350 .B \f[CB]\-\-help\f[R], \f[CB]\-help\f[R] or \f[CB]\-?\f[R]

   351 Prints a synopsis of the standard options.

   352 .RS

   353 .RE

   354 .TP

   355 .B \f[CB]\-\-help\-extra\f[R] or \f[CB]\-X\f[R]

   356 Prints a synopsis of the set of extra options.

   357 .RS

   358 .RE

   359 .TP

   360 .B \f[CB]\-implicit:\f[R][\f[CB]none\f[R], \f[CB]class\f[R]]

   361 Specifies whether or not to generate class files for implicitly

   362 referenced files:

   363 .RS

   364 .IP \[bu] 2

   365 \f[CB]\-implicit:class\f[R] \-\-\- Automatically generates class files.

   366 .IP \[bu] 2

   367 \f[CB]\-implicit:none\f[R] \-\-\- Suppresses class file generation.

   368 .PP

   369 If this option is not specified, then the default automatically

   370 generates class files.

   371 In this case, the compiler issues a warning if any class files are

   372 generated when also doing annotation processing.

   373 The warning is not issued when the \f[CB]\-implicit\f[R] option is

   374 explicitly set.

   375 See \f[B]Searching for Module, Package and Type Declarations\f[R].

   376 .RE

   377 .TP

   378 .B \f[CB]\-J\f[R]\f[I]option\f[R]

   379 Passes \f[I]option\f[R] to the runtime system, where \f[I]option\f[R] is

   380 one of the Java options described on \f[B]java\f[R] command.

   381 For example, \f[CB]\-J\-Xms48m\f[R] sets the startup memory to 48 MB.

   382 .RS

   383 .PP

   384 \f[B]Note:\f[R] The \f[CB]CLASSPATH\f[R] environment variable,

   385 \f[CB]\-classpath\f[R] option, \f[CB]\-bootclasspath\f[R] option, and

   386 \f[CB]\-extdirs\f[R] option do not specify the classes used to run

   387 \f[CB]javac\f[R].

   388 Trying to customize the compiler implementation with these options and

   389 variables is risky and often does not accomplish what you want.

   390 If you must customize the compiler implementation, then use the

   391 \f[CB]\-J\f[R] option to pass options through to the underlying Java

   392 launcher.

   393 .RE

   394 .TP

   395 .B \f[CB]\-\-limit\-modules\f[R] \f[I]module\f[R]\f[CB],\f[R]\f[I]module\f[R]*

   396 Limits the universe of observable modules.

   397 .RS

   398 .RE

   399 .TP

   400 .B \f[CB]\-\-module\f[R] \f[I]module\-name\f[R] (\f[CB],\f[R]\f[I]module\-name\f[R])* or \f[CB]\-m\f[R] \f[I]module\-name\f[R] (\f[CB],\f[R]\f[I]module\-name\f[R])*

   401 Compiles those source files in the named modules that are newer than the

   402 corresponding files in the output directory.

   403 .RS

   404 .RE

   405 .TP

   406 .B \f[CB]\-\-module\-path\f[R] \f[I]path\f[R] or \f[CB]\-p\f[R] \f[I]path\f[R]

   407 Specifies where to find application modules.

   408 .RS

   409 .RE

   410 .TP

   411 .B \f[CB]\-\-module\-source\-path\f[R] \f[I]module\-source\-path\f[R]

   412 Specifies where to find source files when compiling code in multiple

   413 modules.

   414 See [Compilation Modes] and \f[B]The Module Source Path Option\f[R].

   415 .RS

   416 .RE

   417 .TP

   418 .B \f[CB]\-\-module\-version\f[R] \f[I]version\f[R]

   419 Specifies the version of modules that are being compiled.

   420 .RS

   421 .RE

   422 .TP

   423 .B \f[CB]\-nowarn\f[R]

   424 Disables warning messages.

   425 This option operates the same as the \f[CB]\-Xlint:none\f[R] option.

   426 .RS

   427 .RE

   428 .TP

   429 .B \f[CB]\-parameters\f[R]

   430 Generates metadata for reflection on method parameters.

   431 Stores formal parameter names of constructors and methods in the

   432 generated class file so that the method

   433 \f[CB]java.lang.reflect.Executable.getParameters\f[R] from the Reflection

   434 API can retrieve them.

   435 .RS

   436 .RE

   437 .TP

   438 .B \f[CB]\-proc:\f[R][\f[CB]none\f[R], \f[CB]only\f[R]]

   439 Controls whether annotation processing and compilation are done.

   440 \f[CB]\-proc:none\f[R] means that compilation takes place without

   441 annotation processing.

   442 \f[CB]\-proc:only\f[R] means that only annotation processing is done,

   443 without any subsequent compilation.

   444 .RS

   445 .RE

   446 .TP

   447 .B \f[CB]\-processor\f[R] \f[I]class1\f[R][\f[CB],\f[R]\f[I]class2\f[R]\f[CB],\f[R]\f[I]class3\f[R]...]

   448 Names of the annotation processors to run.

   449 This bypasses the default discovery process.

   450 .RS

   451 .RE

   452 .TP

   453 .B \f[CB]\-\-processor\-module\-path\f[R] \f[I]path\f[R]

   454 Specifies the module path used for finding annotation processors.

   455 .RS

   456 .RE

   457 .TP

   458 .B \f[CB]\-\-processor\-path\f[R] \f[I]path\f[R] or \f[CB]\-processorpath\f[R] \f[I]path\f[R]

   459 Specifies where to find annotation processors.

   460 If this option is not used, then the class path is searched for

   461 processors.

   462 .RS

   463 .RE

   464 .TP

   465 .B \f[CB]\-profile\f[R] \f[I]profile\f[R]

   466 Checks that the API used is available in the specified profile.

   467 .RS

   468 .PP

   469 \f[B]Note:\f[R] This can only be used when compiling for releases prior

   470 to JDK 9.

   471 As applicable, see the descriptions in \f[CB]\-\-release\f[R],

   472 \f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details.

   473 .RE

   474 .TP

   475 .B \f[CB]\-\-release\f[R] \f[I]release\f[R]

   476 Compiles source code according to the rules of the Java programming

   477 language for the specified Java SE release, generating class files which

   478 target that release.

   479 Source code is compiled against the combined Java SE and JDK API for the

   480 specified release.

   481 .RS

   482 .PP

   483 The supported values of \f[I]release\f[R] are the current Java SE release

   484 and a limited number of previous releases, detailed in the command\-line

   485 help.

   486 .PP

   487 For the current release, the Java SE API consists of the

   488 \f[CB]java.*\f[R], \f[CB]javax.*\f[R], and \f[CB]org.*\f[R] packages that are

   489 exported by the Java SE modules in the release; the JDK API consists of

   490 the \f[CB]com.*\f[R] and \f[CB]jdk.*\f[R] packages that are exported by the

   491 JDK modules in the release, plus the \f[CB]javax.*\f[R] packages that are

   492 exported by standard, but non\-Java SE, modules in the release.

   493 .PP

   494 For previous releases, the Java SE API and the JDK API are as defined in

   495 that release.

   496 .PP

   497 \f[B]Note:\f[R] When using \f[CB]\-\-release\f[R], you cannot also use the

   498 \f[CB]\-\-source\f[R]/\f[CB]\-source\f[R] or

   499 \f[CB]\-\-target\f[R]/\f[CB]\-target\f[R] options.

   500 .PP

   501 \f[B]Note:\f[R] When using \f[CB]\-\-release\f[R] to specify a release that

   502 supports the Java Platform Module System, the \f[CB]\-\-add\-exports\f[R]

   503 option cannot be used to enlarge the set of packages exported by the

   504 Java SE, JDK, and standard modules in the specified release.

   505 .RE

   506 .TP

   507 .B \f[CB]\-s\f[R] \f[I]directory\f[R]

   508 Specifies the directory used to place the generated source files.

   509 If a class is part of a package, then the compiler puts the source file

   510 in a subdirectory that reflects the module name (if appropriate) and

   511 package name.

   512 The directory, and any necessary subdirectories, will be created if they

   513 do not already exist.

   514 .RS

   515 .PP

   516 Except when compiling code for multiple modules, the contents of the

   517 source output directory will be organized in a package hierarchy.

   518 When compiling code for multiple modules, the contents of the source

   519 output directory will be organized in a module hierarchy, with the

   520 contents of each module in a separate subdirectory, each organized as a

   521 package hierarchy.

   522 .RE

   523 .TP

   524 .B \f[CB]\-\-source\f[R] \f[I]release\f[R] or \f[CB]\-source\f[R] \f[I]release\f[R]

   525 Compiles source code according to the rules of the Java programming

   526 language for the specified Java SE release.

   527 The supported values of \f[I]release\f[R] are the current Java SE release

   528 and a limited number of previous releases, detailed in the command\-line

   529 help.

   530 .RS

   531 .PP

   532 If the option is not specified, the default is to compile source code

   533 according to the rules of the Java programming language for the current

   534 Java SE release.

   535 .RE

   536 .TP

   537 .B \f[CB]\-\-source\-path\f[R] \f[I]path\f[R] or \f[CB]\-sourcepath\f[R] \f[I]path\f[R]

   538 Specifies where to find source files.

   539 Except when compiling multiple modules together, this is the source code

   540 path used to search for class or interface definitions.

   541 .RS

   542 .PP

   543 \f[B]Note:\f[R] Classes found through the class path might be recompiled

   544 when their source files are also found.

   545 See \f[B]Searching for Module, Package and Type Declarations\f[R].

   546 .RE

   547 .TP

   548 .B \f[CB]\-\-system\f[R] \f[I]jdk\f[R] | \f[CB]none\f[R]

   549 Overrides the location of system modules.

   550 .RS

   551 .RE

   552 .TP

   553 .B \f[CB]\-\-target\f[R] \f[I]release\f[R] or \f[CB]\-target\f[R] \f[I]release\f[R]

   554 Generates \f[CB]class\f[R] files suitable for the specified Java SE

   555 release.

   556 The supported values of \f[I]release\f[R] are the current Java SE release

   557 and a limited number of previous releases, detailed in the command\-line

   558 help.

   559 .RS

   560 .PP

   561 \f[B]Note:\f[R] The target release must be equal to or higher than the

   562 source release.

   563 (See \f[CB]\-\-source\f[R].)

   564 .RE

   565 .TP

   566 .B \f[CB]\-\-upgrade\-module\-path\f[R] \f[I]path\f[R]

   567 Overrides the location of upgradeable modules.

   568 .RS

   569 .RE

   570 .TP

   571 .B \f[CB]\-verbose\f[R]

   572 Outputs messages about what the compiler is doing.

   573 Messages include information about each class loaded and each source

   574 file compiled.

   575 .RS

   576 .RE

   577 .TP

   578 .B \f[CB]\-\-version\f[R] or \f[CB]\-version\f[R]

   579 Prints version information.

   580 .RS

   581 .RE

   582 .TP

   583 .B \f[CB]\-Werror\f[R]

   584 Terminates compilation when warnings occur.

   585 .RS

   586 .RE

   587 .SS Extra Options

   588 .TP

   589 .B \f[CB]\-\-add\-exports\f[R] \f[I]module\f[R]\f[CB]/\f[R]\f[I]package\f[R]\f[CB]=\f[R]\f[I]other\-module\f[R](\f[CB],\f[R]\f[I]other\-module\f[R])*

   590 Specifies a package to be considered as exported from its defining

   591 module to additional modules or to all unnamed modules when the value of

   592 \f[I]other\-module\f[R] is \f[CB]ALL\-UNNAMED\f[R].

   593 .RS

   594 .RE

   595 .TP

   596 .B \f[CB]\-\-add\-reads\f[R] \f[I]module\f[R]\f[CB]=\f[R]\f[I]other\-module\f[R](\f[CB],\f[R]\f[I]other\-module\f[R])*

   597 Specifies additional modules to be considered as required by a given

   598 module.

   599 .RS

   600 .RE

   601 .TP

   602 .B \f[CB]\-\-default\-module\-for\-created\-files\f[R] \f[I]module\-name\f[R]

   603 Specifies the fallback target module for files created by annotation

   604 processors, if none is specified or inferred.

   605 .RS

   606 .RE

   607 .TP

   608 .B \f[CB]\-Djava.endorsed.dirs=\f[R]\f[I]dirs\f[R]

   609 Overrides the location of the endorsed standards path.

   610 .RS

   611 .PP

   612 \f[B]Note:\f[R] This can only be used when compiling for releases prior

   613 to JDK 9.

   614 As applicable, see the descriptions in \f[CB]\-\-release\f[R],

   615 \f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details.

   616 .RE

   617 .TP

   618 .B \f[CB]\-Djava.ext.dirs=\f[R]\f[I]dirs\f[R]

   619 Overrides the location of installed extensions.

   620 .RS

   621 .PP

   622 \f[B]Note:\f[R] This can only be used when compiling for releases prior

   623 to JDK 9.

   624 As applicable, see the descriptions in \f[CB]\-\-release\f[R],

   625 \f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details.

   626 .RE

   627 .TP

   628 .B \f[CB]\-\-doclint\-format\f[R] [\f[CB]html4\f[R]|\f[CB]html5\f[R]]

   629 Specifies the format for documentation comments.

   630 .RS

   631 .RE

   632 .TP

   633 .B \f[CB]\-\-patch\-module\f[R] \f[I]module\f[R]\f[CB]=\f[R]\f[I]path\f[R]

   634 Overrides or augments a module with classes and resources in JAR files

   635 or directories.

   636 .RS

   637 .RE

   638 .TP

   639 .B \f[CB]\-Xbootclasspath:\f[R]\f[I]path\f[R]

   640 Overrides the location of the bootstrap class files.

   641 .RS

   642 .PP

   643 \f[B]Note:\f[R] This can only be used when compiling for releases prior

   644 to JDK 9.

   645 As applicable, see the descriptions in \f[CB]\-\-release\f[R],

   646 \f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details.

   647 .RE

   648 .TP

   649 .B \f[CB]\-Xbootclasspath/a:\f[R]\f[I]path\f[R]

   650 Adds a suffix to the bootstrap class path.

   651 .RS

   652 .PP

   653 \f[B]Note:\f[R] This can only be used when compiling for releases prior

   654 to JDK 9.

   655 As applicable, see the descriptions in \f[CB]\-\-release\f[R],

   656 \f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details.

   657 .RE

   658 .TP

   659 .B \f[CB]\-Xbootclasspath/p:\f[R]\f[I]path\f[R]

   660 Adds a prefix to the bootstrap class path.

   661 .RS

   662 .PP

   663 \f[B]Note:\f[R] This can only be used when compiling for releases prior

   664 to JDK 9.

   665 As applicable, see the descriptions in \f[CB]\-\-release\f[R],

   666 \f[CB]\-source\f[R], or \f[CB]\-target\f[R] for details.

   667 .RE

   668 .TP

   669 .B \f[CB]\-Xdiags:\f[R][\f[CB]compact\f[R], \f[CB]verbose\f[R]]

   670 Selects a diagnostic mode.

   671 .RS

   672 .RE

   673 .TP

   674 .B \f[CB]\-Xdoclint\f[R]

   675 Enables recommended checks for problems in \f[CB]javadoc\f[R] comments

   676 .RS

   677 .RE

   678 .TP

   679 .B \f[CB]\-Xdoclint:\f[R](\f[CB]all\f[R]|\f[CB]none\f[R]|[\f[CB]\-\f[R]]\f[I]group\f[R])[\f[CB]/\f[R]\f[I]access\f[R]]

   680 Enables or disables specific groups of checks,

   681 .RS

   682 .PP

   683 \f[I]group\f[R] can have one of the following values:

   684 .IP \[bu] 2

   685 \f[CB]accessibility\f[R]

   686 .IP \[bu] 2

   687 \f[CB]html\f[R]

   688 .IP \[bu] 2

   689 \f[CB]missing\f[R]

   690 .IP \[bu] 2

   691 \f[CB]reference\f[R]

   692 .IP \[bu] 2

   693 \f[CB]syntax\f[R]

   694 .PP

   695 The variable \f[I]access\f[R] specifies the minimum visibility level of

   696 classes and members that the \f[CB]\-Xdoclint\f[R] option checks.

   697 It can have one of the following values (in order of most to least

   698 visible):

   699 .IP \[bu] 2

   700 \f[CB]public\f[R]

   701 .IP \[bu] 2

   702 \f[CB]protected\f[R]

   703 .IP \[bu] 2

   704 \f[CB]package\f[R]

   705 .IP \[bu] 2

   706 \f[CB]private\f[R]

   707 .PP

   708 The default \f[I]access\f[R] level is \f[CB]private\f[R].

   709 .PP

   710 For more information about these groups of checks, see the

   711 \f[CB]\-Xdoclint\f[R] option of the \f[CB]javadoc\f[R] command.

   712 The \f[CB]\-Xdoclint\f[R] option is disabled by default in the

   713 \f[CB]javac\f[R] command.

   714 .PP

   715 For example, the following option checks classes and members (with all

   716 groups of checks) that have the access level of protected and higher

   717 (which includes protected and public):

   718 .RS

   719 .PP

   720 \f[CB]\-Xdoclint:all/protected\f[R]

   721 .RE

   722 .PP

   723 The following option enables all groups of checks for all access levels,

   724 except it will not check for HTML errors for classes and members that

   725 have the access level of package and higher (which includes package,

   726 protected and public):

   727 .RS

   728 .PP

   729 \f[CB]\-Xdoclint:all,\-html/package\f[R]

   730 .RE

   731 .RE

   732 .TP

   733 .B \f[CB]\-Xdoclint/package:\f[R][\f[CB]\-\f[R]]\f[I]packages\f[R](\f[CB],\f[R][\f[CB]\-\f[R]]\f[I]package\f[R])*

   734 Enables or disables checks in specific packages.

   735 Each \f[I]package\f[R] is either the qualified name of a package or a

   736 package name prefix followed by \f[CB]\&.*\f[R], which expands to all

   737 sub\-packages of the given package.

   738 Each \f[I]package\f[R] can be prefixed with a hyphen (\f[CB]\-\f[R]) to

   739 disable checks for a specified package or packages.

   740 .RS

   741 .RE

   742 .TP

   743 .B \f[CB]\-Xlint\f[R]

   744 Enables all recommended warnings.

   745 In this release, enabling all available warnings is recommended.

   746 .RS

   747 .RE

   748 .TP

   749 .B \f[CB]\-Xlint:\f[R][\f[CB]\-\f[R]]\f[I]key\f[R](\f[CB],\f[R][\f[CB]\-\f[R]]\f[I]key\f[R])*

   750 Supplies warnings to enable or disable, separated by comma.

   751 Precede a key by a hyphen (\f[CB]\-\f[R]) to disable the specified

   752 warning.

   753 .RS

   754 .PP

   755 Supported values for \f[I]key\f[R] are:

   756 .IP \[bu] 2

   757 \f[CB]all\f[R]: Enables all warnings.

   758 .IP \[bu] 2

   759 \f[CB]auxiliaryclass\f[R]: Warns about an auxiliary class that\[aq]s

   760 hidden in a source file, and is used from other files.

   761 .IP \[bu] 2

   762 \f[CB]cast\f[R]: Warns about the use of unnecessary casts.

   763 .IP \[bu] 2

   764 \f[CB]classfile\f[R]: Warns about the issues related to classfile

   765 contents.

   766 .IP \[bu] 2

   767 \f[CB]deprecation\f[R]: Warns about the use of deprecated items.

   768 .IP \[bu] 2

   769 \f[CB]dep\-ann\f[R]: Warns about the items marked as deprecated in

   770 \f[CB]javadoc\f[R] but without the \f[CB]\@Deprecated\f[R] annotation.

   771 .IP \[bu] 2

   772 \f[CB]divzero\f[R]: Warns about the division by the constant integer 0.

   773 .IP \[bu] 2

   774 \f[CB]empty\f[R]: Warns about an empty statement after \f[CB]if\f[R].

   775 .IP \[bu] 2

   776 \f[CB]exports\f[R]: Warns about the issues regarding module exports.

   777 .IP \[bu] 2

   778 \f[CB]fallthrough\f[R]: Warns about the falling through from one case of a

   779 switch statement to the next.

   780 .IP \[bu] 2

   781 \f[CB]finally\f[R]: Warns about \f[CB]finally\f[R] clauses that do not

   782 terminate normally.

   783 .IP \[bu] 2

   784 \f[CB]module\f[R]: Warns about the module system\-related issues.

   785 .IP \[bu] 2

   786 \f[CB]opens\f[R]: Warns about the issues related to module opens.

   787 .IP \[bu] 2

   788 \f[CB]options\f[R]: Warns about the issues relating to use of command line

   789 options.

   790 .IP \[bu] 2

   791 \f[CB]overloads\f[R]: Warns about the issues related to method overloads.

   792 .IP \[bu] 2

   793 \f[CB]overrides\f[R]: Warns about the issues related to method overrides.

   794 .IP \[bu] 2

   795 \f[CB]path\f[R]: Warns about the invalid path elements on the command l

   796 ine.

   797 .IP \[bu] 2

   798 \f[CB]processing\f[R]: Warns about the issues related to annotation

   799 processing.

   800 .IP \[bu] 2

   801 \f[CB]rawtypes\f[R]: Warns about the use of raw types.

   802 .IP \[bu] 2

   803 \f[CB]removal\f[R]: Warns about the use of an API that has been marked for

   804 removal.

   805 .IP \[bu] 2

   806 \f[CB]requires\-automatic\f[R]: Warns developers about the use of

   807 automatic modules in requires clauses.

   808 .IP \[bu] 2

   809 \f[CB]requires\-transitive\-automatic\f[R]: Warns about automatic modules

   810 in requires transitive.

   811 .IP \[bu] 2

   812 \f[CB]serial\f[R]: Warns about the serializable classes that do not

   813 provide a serial version ID.

   814 Also warns about access to non\-public members from a serializable

   815 element.

   816 .IP \[bu] 2

   817 \f[CB]static\f[R]: Warns about the accessing a static member using an

   818 instance.

   819 .IP \[bu] 2

   820 \f[CB]try\f[R]: Warns about the issues relating to the use of try blocks (

   821 that is, try\-with\-resources).

   822 .IP \[bu] 2

   823 \f[CB]unchecked\f[R]: Warns about the unchecked operations.

   824 .IP \[bu] 2

   825 \f[CB]varargs\f[R]: Warns about the potentially unsafe \f[CB]vararg\f[R]

   826 methods.

   827 .IP \[bu] 2

   828 \f[CB]none\f[R]: Disables all warnings.

   829 .PP

   830 See \f[B]Examples of Using \-Xlint keys\f[R].

   831 .RE

   832 .TP

   833 .B \f[CB]\-Xmaxerrs\f[R] \f[I]number\f[R]

   834 Sets the maximum number of errors to print.

   835 .RS

   836 .RE

   837 .TP

   838 .B \f[CB]\-Xmaxwarns\f[R] \f[I]number\f[R]

   839 Sets the maximum number of warnings to print.

   840 .RS

   841 .RE

   842 .TP

   843 .B \f[CB]\-Xpkginfo:\f[R][\f[CB]always\f[R], \f[CB]legacy\f[R], \f[CB]nonempty\f[R]]

   844 Specifies when and how the \f[CB]javac\f[R] command generates

   845 \f[CB]package\-info.class\f[R] files from \f[CB]package\-info.java\f[R]

   846 files using one of the following options:

   847 .RS

   848 .TP

   849 .B \f[CB]always\f[R]

   850 Generates a \f[CB]package\-info.class\f[R] file for every

   851 \f[CB]package\-info.java\f[R] file.

   852 This option may be useful if you use a build system such as Ant, which

   853 checks that each \f[CB]\&.java\f[R] file has a corresponding

   854 \f[CB]\&.class\f[R] file.

   855 .RS

   856 .RE

   857 .TP

   858 .B \f[CB]legacy\f[R]

   859 Generates a \f[CB]package\-info.class\f[R] file only if

   860 \f[CB]package\-info.java\f[R] contains annotations.

   861 This option does not generate a \f[CB]package\-info.class\f[R] file if

   862 \f[CB]package\-info.java\f[R] contains only comments.

   863 .RS

   864 .PP

   865 \f[B]Note:\f[R] A \f[CB]package\-info.class\f[R] file might be generated

   866 but be empty if all the annotations in the \f[CB]package\-info.java\f[R]

   867 file have \f[CB]RetentionPolicy.SOURCE\f[R].

   868 .RE

   869 .TP

   870 .B \f[CB]nonempty\f[R]

   871 Generates a \f[CB]package\-info.class\f[R] file only if

   872 \f[CB]package\-info.java\f[R] contains annotations with

   873 \f[CB]RetentionPolicy.CLASS\f[R] or \f[CB]RetentionPolicy.RUNTIME\f[R].

   874 .RS

   875 .RE

   876 .RE

   877 .TP

   878 .B \f[CB]\-Xplugin:\f[R]\f[I]name\f[R] \f[I]args\f[R]

   879 Specifies the name and optional arguments for a plug\-in to be run.

   880 If \f[I]args\f[R] are provided, \f[I]name\f[R] and \f[I]args\f[R] should be

   881 quoted or otherwise escape the whitespace characters between the name

   882 and all the arguments.

   883 For details on the API for a plugin, see the API documentation for

   884 \f[B]jdk.compiler/com.sun.source.util.Plugin\f[R].

   885 .RS

   886 .RE

   887 .TP

   888 .B \f[CB]\-Xprefer:\f[R][\f[CB]source\f[R], \f[CB]newer\f[R]]

   889 Specifies which file to read when both a source file and class file are

   890 found for an implicitly compiled class using one of the following

   891 options.

   892 See \f[B]Searching for Module, Package and Type Declarations\f[R].

   893 .RS

   894 .IP \[bu] 2

   895 \f[CB]\-Xprefer:newer\f[R]: Reads the newer of the source or class files

   896 for a type (default).

   897 .IP \[bu] 2

   898 \f[CB]\-Xprefer:source\f[R] : Reads the source file.

   899 Use \f[CB]\-Xprefer:source\f[R] when you want to be sure that any

   900 annotation processors can access annotations declared with a retention

   901 policy of \f[CB]SOURCE\f[R].

   902 .RE

   903 .TP

   904 .B \f[CB]\-Xprint\f[R]

   905 Prints a textual representation of specified types for debugging

   906 purposes.

   907 This does not perform annotation processing or compilation.

   908 The format of the output could change.

   909 .RS

   910 .RE

   911 .TP

   912 .B \f[CB]\-XprintProcessorInfo\f[R]

   913 Prints information about which annotations a processor is asked to

   914 process.

   915 .RS

   916 .RE

   917 .TP

   918 .B \f[CB]\-XprintRounds\f[R]

   919 Prints information about initial and subsequent annotation processing

   920 rounds.

   921 .RS

   922 .RE

   923 .TP

   924 .B \f[CB]\-Xstdout\f[R] \f[I]filename\f[R]

   925 Sends compiler messages to the named file.

   926 By default, compiler messages go to \f[CB]System.err\f[R].

   927 .RS

   928 .RE

   929 .SH ENVIRONMENT VARIABLES

   930 .SS CLASSPATH

   931 .PP

   932 If the \f[CB]\-\-class\-path\f[R] option or any of its alternate forms are

   933 not specified, the class path will default to the value of the

   934 \f[CB]CLASSPATH\f[R] environment variable if it is set.

   935 However, it is recommended that this environment variable should

   936 \f[I]not\f[R] be set, and that the \f[CB]\-\-class\-path\f[R] option should

   937 be used to provide an explicit value for the class path when one is

   938 required.

   939 .SS JDK_JAVAC_OPTIONS

   125 to enclose arguments that\ contain whitespace characters.

   952 to enclose arguments that contain whitespace characters.

   148 .SH OVERVIEW OF JAVAC OPTIONS

   975 .SH COMMAND\-LINE ARGUMENT FILES

   149 .PP

   976 .PP

   150 The compiler has sets of standard options, and cross\-compilation

   977 An argument file can include command\-line options and source file names

   151 options that are supported on the current development environment.

   978 in any combination.

   152 The compiler also has a set of nonstandard options that are specific to

   153 the current virtual machine and compiler implementations but are subject

   154 to change in the future.

   155 The nonstandard options begin with \f[CB]\-X\f[R] .

   156 The different sets of \f[CB]javac\f[R] options are described in the

   157 following sections:

   158 .IP \[bu] 2

   159 \f[B]Standard Options\f[R]

   160 .IP \[bu] 2

   161 \f[B]Cross\-Compilation Options for javac\f[R]

   162 .IP \[bu] 2

   163 \f[B]Extra Options\f[R]

   164 .SH STANDARD OPTIONS

   165 .TP

   166 .B \f[CB]\@\f[R]\f[I]filename\f[R]

   167 Reads options and file names from a file.

   168 To shorten or simplify the \f[CB]javac\f[R] command, you can specify one

   169 or more files that contain arguments to the \f[CB]javac\f[R] command

   170 (except \f[CB]\-J\f[R] options).

   171 This lets you to create \f[CB]javac\f[R] commands of any length on any

   172 operating system.

   173 See \f[B]javac Command\-Line Argument Files\f[R].

   174 .RS

   175 .RE

   176 .TP

   177 .B \f[CB]\-A\f[R]\f[I]key\f[R][\f[CB]=\f[R]\f[I]value\f[R]]

   178 Specifies options to pass to annotation processors.

   179 These options aren\[aq]t interpreted by \f[CB]javac\f[R] directly, but are

   180 made available for use by individual processors.

   181 The \f[I]key\f[R] value should be one or more identifiers separated by a

   182 dot (\f[CB]\&.\f[R]).

   183 .RS

   184 .RE

   185 .TP

   186 .B \f[CB]\-\-add\-modules\f[R] \f[I]module\f[R]\f[CB],\f[R]\f[I]module\f[R]

   187 Specifies root modules to resolve in addition to the initial modules, or

   188 all modules on the module path if \f[I]module\f[R] is

   189 \f[CB]ALL\-MODULE\-PATH.\f[R]

   190 .RS

   191 .RE

   192 .TP

   193 .B \f[CB]\-\-boot\-class\-path\f[R] \f[I]path\f[R] or \f[CB]\-bootclasspath\f[R] \f[I]path\f[R]

   194 Overrides the location of the bootstrap class files.

   195 .RS

   196 .PP

   197 \f[B]Note:\f[R]

   198 .PP

   199 This can only be used when compiling for versions prior to JDK 9.

   200 As applicable, see the descriptions in\ \f[CB]\-\-release\f[R],

   201 \f[CB]\-source\f[R], or \f[CB]\-target\f[R]\ for details.

   202 .RE

   203 .TP

   204 .B \f[CB]\-\-class\-path\f[R] \f[I]path\f[R], \f[CB]\-classpath\f[R] \f[I]path\f[R], or \f[CB]\-cp\f[R] \f[I]path\f[R]

   205 Specifies where to find user class files and annotation processors.

   206 This class path overrides the user class path in the \f[CB]CLASSPATH\f[R]

   207 environment variable.

   208 .RS

   209 .IP \[bu] 2

   210 If \f[CB]\-\-class\-path\f[R], \f[CB]\-classpath\f[R], or \f[CB]\-cp\f[R]

   211 aren\[aq]t specified, then the user class path is the current directory.

   212 .IP \[bu] 2

   213 If the \f[CB]\-sourcepath\f[R] option isn\[aq]t specified, then the user

   214 class path is also searched for source files.

   215 .IP \[bu] 2

   216 If the \f[CB]\-processorpath\f[R] option isn\[aq]t specified, then the

   217 class path is also searched for annotation processors.

   218 .RE

   219 .TP

   220 .B \f[CB]\-d\f[R] \f[I]directory\f[R]

   221 Sets the destination directory for class files.

   222 If a class is part of a package, then \f[CB]javac\f[R] puts the class file

   223 in a subdirectory that reflects the package name and creates directories

   224 as needed.

   225 For example:

   226 .RS

   227 .IP \[bu] 2

   228 \f[B]Oracle Solaris, Linux, and OS X:\f[R] If you specify

   229 \f[CB]\-d\ /home/myclasses\f[R] and the class is called

   230 \f[CB]com.mypackage.MyClass\f[R], then the class file is

   231 \f[CB]/home/myclasses/com/mypackage/MyClass.class\f[R].

   232 .IP \[bu] 2

   233 \f[B]Windows:\f[R] If you specify \f[CB]\-d\ C:\\myclasses\f[R] and the

   234 class is called \f[CB]com.mypackage.MyClass\f[R], then the class file is

   235 \f[CB]C:\\myclasses\\com\\mypackage\\MyClass.class\f[R].

   236 .PP

   237 If the \f[CB]\-d\f[R] option isn\[aq]t specified, then \f[CB]javac\f[R] puts

   238 each class file in the same directory as the source file from which it

   239 was generated.

   240 .PP

   241 \f[B]Note:\f[R]

   242 .PP

   243 The directory specified by the \f[CB]\-d\f[R] option isn\[aq]t

   244 automatically added to your user class path.

   245 .RE

   246 .TP

   247 .B \f[CB]\-deprecation\f[R]

   248 Shows a description of each use or override of a deprecated member or

   249 class.

   250 Without the \f[CB]\-deprecation\f[R] option, \f[CB]javac\f[R] shows a

   251 summary of the source files that use or override deprecated members or

   252 classes.

   253 The \f[CB]\-deprecation\f[R] option is shorthand for

   254 \f[CB]\-Xlint:deprecation\f[R].

   255 .RS

   256 .RE

   257 .TP

   258 .B \f[CB]\-\-enable\-preview\f[R]

   259 Enables preview language features.

   260 Used in conjunction with either \f[CB]\-source\f[R] or

   261 \f[CB]\-\-release\f[R].

   262 .RS

   263 .RE

   264 .TP

   265 .B \f[CB]\-encoding\f[R] \f[I]encoding\f[R]

   266 Specifies character encoding used by source files, such as EUC\-JP and

   267 UTF\-8.

   268 If the \f[CB]\-encoding\f[R] option isn\[aq]t specified, then the platform

   269 default converter is used.

   270 .RS

   271 .RE

   272 .TP

   273 .B \f[CB]\-endorseddirs\f[R] \f[I]directories\f[R]

   274 Overrides the location of the endorsed standards path.

   275 .RS

   276 .PP

   277 \f[B]Note:\f[R]

   278 .PP

   279 This can only be used when compiling for versions prior to JDK 9.

   280 As applicable, see the descriptions in\ \f[CB]\-\-release\f[R],

   281 \f[CB]\-source\f[R], or \f[CB]\-target\f[R]\ for details.

   282 .RE

   283 .TP

   284 .B \f[CB]\-extdirs\f[R] \f[I]directories\f[R]

   285 Overrides the location of the installed extensions.

   286 The \f[CB]directories\f[R] variable is a colon\-separated list of

   287 directories.

   288 Each JAR file in the specified directories is searched for class files.

   289 All JAR files found become part of the class path.

   290 .RS

   291 .PP

   292 If you are cross\-compiling, then this option specifies the directories

   293 that contain the extension classes.

   294 See \f[B]Cross\-Compilation Options for javac\f[R].

   295 .PP

   296 \f[B]Note:\f[R]

   297 .PP

   298 This can only be used when compiling for versions prior to JDK 9.

   299 As applicable, see the descriptions in\ \f[CB]\-\-release\f[R],

   300 \f[CB]\-source\f[R], or \f[CB]\-target\f[R]\ for details.

   301 .RE

   302 .TP

   303 .B \f[CB]\-g\f[R]

   304 Generates all debugging information, including local variables.

   305 By default, only line number and source file information is generated.

   306 .RS

   307 .RE

   308 .TP

   309 .B \f[CB]\-g:\f[R][\f[CB]lines\f[R], \f[CB]vars\f[R], \f[CB]source\f[R]]

   310 Generates only the kinds of debugging information specified by the

   311 comma\-separated list of keywords.

   312 Valid keywords are:

   313 .RS

   314 .TP

   315 .B \f[CB]lines\f[R]

   316 Line number debugging information.

   317 .RS

   318 .RE

   319 .TP

   320 .B \f[CB]vars\f[R]

   321 Local variable debugging information.

   322 .RS

   323 .RE

   324 .TP

   325 .B \f[CB]source\f[R]

   326 Source file debugging information.

   327 .RS

   328 .RE

   329 .RE

   330 .TP

   331 .B \f[CB]\-g:none\f[R]

   332 Doesn\[aq]t generate debugging information.

   333 .RS

   334 .RE

   335 .TP

   336 .B \f[CB]\-h\f[R] \f[I]directory\f[R]

   337 Specfies where to place generated native header files.

   338 .RS

   339 .PP