blob: 7c51558ba789ce1e816edf7cb8eb36c126921929 [file] [log] [blame]
rgallardb6435452013-11-25 20:19:02 -08001'\" t
2.\" Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved.
3.\"
4.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
5.\"
6.\" This code is free software; you can redistribute it and/or modify it
7.\" under the terms of the GNU General Public License version 2 only, as
8.\" published by the Free Software Foundation.
9.\"
10.\" This code is distributed in the hope that it will be useful, but WITHOUT
11.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
13.\" version 2 for more details (a copy is included in the LICENSE file that
14.\" accompanied this code).
15.\"
16.\" You should have received a copy of the GNU General Public License version
17.\" 2 along with this work; if not, write to the Free Software Foundation,
18.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
19.\"
20.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
21.\" or visit www.oracle.com if you need additional information or have any
22.\" questions.
23.\"
24.\" Arch: generic
25.\" Software: JDK 8
26.\" Date: 21 November 2013
27.\" SectDesc: Java Web Services Tools
28.\" Title: schemagen.1
29.\"
30.if n .pl 99999
31.TH schemagen 1 "21 November 2013" "JDK 8" "Java Web Services Tools"
32.\" -----------------------------------------------------------------
33.\" * Define some portability stuff
34.\" -----------------------------------------------------------------
35.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
36.\" http://bugs.debian.org/507673
37.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
38.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
39.ie \n(.g .ds Aq \(aq
40.el .ds Aq '
41.\" -----------------------------------------------------------------
42.\" * set default formatting
43.\" -----------------------------------------------------------------
44.\" disable hyphenation
45.nh
46.\" disable justification (adjust text to left margin only)
47.ad l
48.\" -----------------------------------------------------------------
49.\" * MAIN CONTENT STARTS HERE *
50.\" -----------------------------------------------------------------
duke6e45e102007-12-01 00:00:00 +000051
rgallardb6435452013-11-25 20:19:02 -080052.SH NAME
53schemagen \- Generates a schema for every name space that is referenced in your Java classes\&.
54.SH SYNOPSIS
55.sp
56.nf
57
58\fBschemagen\fR [ \fIoptions\fR ] \fIjava\-files\fR
59.fi
60.sp
61.TP
62\fIoptions\fR
63The command-line options\&. See Options\&.
64.TP
65\fIjava-files\fR
66The Java class files to be processed\&.
67.SH DESCRIPTION
68The schema generator creates a schema file for each name space referenced in your Java classes\&. Currently, you cannot control the name of the generated schema files\&. To control the schema file names, see Using SchemaGen with Ant at http://jaxb\&.java\&.net/nonav/2\&.2\&.3u1/docs/schemagenTask\&.html
69.PP
70Start the schema generator with the appropriate \f3schemagen\fR shell script in the bin directory for your platform\&. The current schema generator can process either Java source files or class files\&.
71.sp
72.nf
73\f3schemagen\&.sh Foo\&.java Bar\&.java \&.\&.\&.\fP
74.fi
75.nf
76\f3Note: Writing schema1\&.xsd\fP
77.fi
78.nf
79\f3\fP
80.fi
81.sp
82If your java files reference other classes, then those classes must be accessible on your system \f3CLASSPATH\fR environment variable, or they need to be specified in the \f3schemagen\fR command line with the class path options\&. See Options\&. If the referenced files are not accessible or specified, then you get errors when you generate the schema\&.
83.SH OPTIONS
84.TP
85-d \fIpath\fR
duke6e45e102007-12-01 00:00:00 +000086.br
rgallardb6435452013-11-25 20:19:02 -080087The location where the \f3schemagen\fR command places processor-generated and \f3javac\fR-generated class files\&.
88.TP
89-cp \fIpath\fR
90.br
91The location where the \f3schemagen\fR command places user-specified files\&.
92.TP
93-classpath \fIpath\fR
94.br
95The location where the \f3schemagen\fR command places user-specified files\&.
96.TP
97-encoding \fIencoding\fR
98.br
99Specifies the encoding to use for \f3apt\fR or \f3javac\fR command invocations\&.
100.TP
101-episode \fIfile\fR
102.br
103Generates an episode file for separate compilation\&.
104.TP
105-version
106.br
107Displays release information\&.
108.TP
109-help
110.br
111Displays a help message\&.
112.SH SEE\ ALSO
113.TP 0.2i
114\(bu
115Using SchemaGen with Ant at http://jaxb\&.java\&.net/nonav/2\&.2\&.3u1/docs/schemagenTask\&.html
116.TP 0.2i
117\(bu
118Java Architecture for XML Binding (JAXB) at http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/xml/jaxb/index\&.html
119.RE
120.br
121'pl 8.5i
122'bp