--- a/jdk/src/linux/doc/man/xjc.1 Tue May 10 19:57:30 2011 -0700
+++ b/jdk/src/linux/doc/man/xjc.1 Wed May 11 08:30:46 2011 -0700
@@ -1,4 +1,4 @@
-." Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved.
+." Copyright (c) 2005, 2011, Oracle and/or its affiliates. All rights reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@@ -19,19 +19,18 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH xjc 1 "02 Jun 2010"
+.TH xjc 1 "10 May 2011"
.LP
-.ad c
.SH "Name"
xjc \- Java(TM) Architecture for XML Binding
.br
-Binding Compiler
+Binding Compiler
+.LP
.LP
\f3Specification Version:\fP 2.1
.br
-\f3Reference Implementation (RI) Version:\fP 2.1.3 .ad l
-
+\f3Reference Implementation (RI) Version:\fP 2.1.3
.LP
.SH "Launching xjc"
.LP
@@ -42,84 +41,87 @@
.fi
https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.html.
.LP
-.RS 3
-
-.LP
.LP
\f2% xjc \-help\fP
.LP
-.RE
-\f3Output\fP
-.LP
-.RS 3
-
+.SS
+Output
.LP
.nf
\f3
.fl
-Usage: xjc [\-options ...] <schema_file/URL/dir> ... [\-b <bindinfo>] ...
+Usage: xjc [\-options ...] <schema file/URL/dir/jar> ... [\-b <bindinfo>] ...
+.fl
+If dir is specified, all schema files in it will be compiled.
+.fl
+If jar is specified, /META\-INF/sun\-jaxb.episode binding file will be compiled.
.fl
Options:
.fl
- \-nv : do not perform strict validation of the input schema(s)
+ \-nv : do not perform strict validation of the input schema(s)
.fl
- \-extension : allow vendor extensions \- do not strictly follow the
+ \-extension : allow vendor extensions \- do not strictly follow the Compatibility Rules and App E.2 from the JAXB Spec
.fl
- Compatibility Rules and App E.2 from the JAXB Spec
+ \-b <file/dir> : specify external bindings files (each <file> must have its own \-b); if a directory is given, **/*.xjb is searched
.fl
- \-b <file/dir> : specify external bindings files (each <file> must have its own \-b)
+ \-d <dir> : generated files will go into this directory
+.fl
+ \-p <pkg> : specifies the target package
.fl
- If a directory is given, **/*.xjb is searched
+ \-httpproxy <proxy> : set HTTP/HTTPS proxy; format is [user[:password]@]proxyHost:proxyPort
.fl
- \-d <dir> : generated files will go into this directory
+ \-httpproxyfile <f> : works like \-httpproxy but takes the argument in a file to protect password
.fl
- \-p <pkg> : specifies the target package
+ \-classpath <arg> : specify where to find user class files
.fl
- \-httpproxy <proxy> : set HTTP/HTTPS proxy. Format is [user[:password]@]proxyHost:proxyPort
+ \-catalog <file> : specify catalog files to resolve external entity references; support TR9401, XCatalog, and OASIS XML Catalog format
.fl
- \-httpproxyfile <file>: set the proxy string (same format as above).
+ \-readOnly : generated files will be in read\-only mode
.fl
- \-classpath <arg> : specify where to find user class files
+ \-npa : suppress generation of package level annotations (**/package\-info.java)
+.fl
+ \-no\-header : suppress generation of a file header with timestamp
.fl
- \-catalog <file> : specify catalog files to resolve external entity references
+ \-target 2.0 : behave like XJC 2.0 and generate code that doesnt use any 2.1 features
.fl
- support TR9401, XCatalog, and OASIS XML Catalog format.
+ \-xmlschema : treat input as W3C XML Schema (default)
.fl
- \-readOnly : generated files will be in read\-only mode
+ \-relaxng : treat input as RELAX NG (experimental,unsupported)
.fl
- \-npa : suppress generation of package level annotations (**/package\-info.java)
+ \-relaxng\-compact : treat input as RELAX NG compact syntax (experimental,unsupported)
.fl
- \-no\-header : suppress generation of a file header with timestamp
+ \-dtd : treat input as XML DTD (experimental,unsupported)
.fl
- \-target 2.0 : behave like XJC 2.0 and generate code that doesnt use any 2.1 features.
+ \-wsdl : treat input as WSDL and compile schemas inside it (experimental,unsupported)
+.fl
+ \-verbose : be extra verbose
.fl
- \-xmlschema : treat input as W3C XML Schema (default)
+ \-quiet : suppress compiler output
.fl
- \-relaxng : treat input as RELAX NG (experimental,unsupported)
+ \-help : display this help message
.fl
- \-relaxng\-compact : treat input as RELAX NG compact syntax (experimental,unsupported)
+ \-version : display version information
+.fl
+
.fl
- \-dtd : treat input as XML DTD (experimental,unsupported)
+
.fl
- \-wsdl : treat input as WSDL and compile schemas inside it (experimental,unsupported)
+Extensions:
.fl
- \-verbose : be extra verbose
+ \-Xlocator : enable source location support for generated code
.fl
- \-quiet : suppress compiler output
+ \-Xsync\-methods : generate accessor methods with the 'synchronized' keyword
.fl
- \-help : display this help message
+ \-mark\-generated : mark the generated code as @javax.annotation.Generated
.fl
- \-version : display version information
+ \-episode <FILE> : generate the episode file for separate compilation
.fl
\fP
.fi
-.RE
.LP
.SH "OPTIONS"
.LP
-
-.LP
.RS 3
.TP 3
\-nv
@@ -129,15 +131,9 @@
By default, the XJC binding compiler strictly enforces the rules outlined in the Compatibility chapter of the JAXB Specification. Appendix E.2 defines a set of W3C XML Schema features that are not completely supported by JAXB v1.0. In some cases, you may be allowed to use them in the "\-extension" mode enabled by this switch. In the default (strict) mode, you are also limited to using only the binding customizations defined in the specification. By using the "\-extension" switch, you will be allowed to use the JAXB Vendor Extensions
.TP 3
\-b <file>
-Specify one or more external binding files to process. (Each binding file must have its own \f2"\-b"\fP switch.) The syntax of the external binding files is extremely flexible. You may have a single binding file that contains customizations for multiple schemas or you can break the customizations into multiple bindings files:
-.RS 3
-
-.LP
-\f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings123.xjb\fP
+Specify one or more external binding files to process. (Each binding file must have its own \f2"\-b"\fP switch.) The syntax of the external binding files is extremely flexible. You may have a single binding file that contains customizations for multiple schemas or you can break the customizations into multiple bindings files: \f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings123.xjb\fP
.br
-\f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings1.xjb \-b bindings2.xjb \-b bindings3.xjb\fP
-.RE
-In addition, the ordering of the schema files and binding files on the command line does not matter.
+\f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings1.xjb \-b bindings2.xjb \-b bindings3.xjb\fP In addition, the ordering of the schema files and binding files on the command line does not matter.
.TP 3
\-d <dir>
By default, the XJC binding compiler will generate the Java content classes in the current directory. Use this option to specify an alternate output directory. The output directory must already exist, the XJC binding compiler will not create it for you.
@@ -199,12 +195,30 @@
<schema file/URL/dir>
Specify one or more schema files to compile. If you specify a directory, then xjc will scan it for all schema files and compile them.
.RE
+
+.LP
.SS
-Summary of Deprecated and Removed Command Line Options
+Non\-Standard Command Line Options
.LP
.RS 3
+.TP 3
+\-Xlocator
+Causes the generated code to expose SAX Locator information about the source XML in the Java bean instances after unmarshalling.
+.TP 3
+\-Xsync\-methods
+Causes all of the generated method signatures to include the \f2synchronized\fP keyword.
+.TP 3
+\-mark\-generated
+Mark the generated code with the annotation \f2@javax.annotation.Generated\fP.
+.TP 3
+\-episode <file>
+Generate the specified episode file for separate compilation.
+.RE
.LP
+.SS
+Deprecated and Removed Command Line Options
+.LP
.RS 3
.TP 3
\-host & \-port
@@ -215,13 +229,9 @@
.TP 3
\-source
The \-source compatibility switch was introduced in the first JAXB 2.0 Early Access release. We have decided to remove this switch from future releases of JAXB 2.0. If you need to generate 1.0.x code, please use an installation of the 1.0.x codebase.
-.TP 3
-\-Xlocator & \-Xsync\-methods
-These switches have been disabled for now. We plan on releasing this functionality as a separate download in the future.
.RE
.LP
-.RE
.SS
Compiler Restrictions
.LP
@@ -280,7 +290,7 @@
.na
\f2Java Architecture for XML Binding (JAXB)\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/xml/jaxb/index.html
+http://download.oracle.com/javase/7/docs/technotes/guides/xml/jaxb/index.html
.RE
.LP