--- a/jdk/src/linux/doc/man/rmic.1 Thu Apr 30 15:04:39 2009 -0700
+++ b/jdk/src/linux/doc/man/rmic.1 Mon May 04 18:28:26 2009 -0700
@@ -1,6 +1,4 @@
-.'" t
-."
-." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
+." Copyright 2004-2006 Sun Microsystems, Inc. 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
@@ -21,19 +19,20 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
-." `
-.TH rmic 1 "05 Aug 2006"
-." Generated by html2roff
+.TH rmic 1 "04 May 2009"
+." Generated from HTML by html2man (author: Eric Armstrong)
.LP
-.SH NAME
+.SH "Name"
rmic \- The Java RMI Compiler
.LP
+.RS 3
.LP
.LP
\f3rmic\fP generates stub, skeleton, and tie classes for remote objects using either the JRMP or IIOP protocols. Also generates OMG IDL.
.LP
+.RE
.SH "SYNOPSIS"
.LP
@@ -85,6 +84,7 @@
.LP
.LP
+.RS 3
.TP 3
\-bootclasspath path
Overrides location of bootstrap class files
@@ -137,6 +137,7 @@
.TP 3
\-g
Enables generation of all debugging information, including local variables. By default, only line number information is generated.
+.LP
.TP 3
\-idl
Causes \f2rmic\fP to generate OMG IDL for the classes specified and any classes referenced. IDL provides a purely declarative, programming language\-independent way of specifying an object's API. The IDL is used as a specification for methods and data that can be written in and invoked from any language that provides CORBA bindings. This includes Java and C++ among others. See the
@@ -146,6 +147,7 @@
http://www.omg.org/technology/documents/formal/java_language_mapping_to_omg_idl.htm (OMG) document for a complete description.
.LP
When the \f2\-idl\fP option is used, other options also include:
+.RS 3
.TP 3
\-always or \-alwaysgenerate
Forces re\-generation even when existing stubs/ties/IDL are newer than the input class.
@@ -153,13 +155,12 @@
\-factory
Uses factory keyword in generated IDL.
.TP 3
-\-idlModule\ fromJavaPackage[.class]\
-toIDLModule
+\-idlModule\ fromJavaPackage[.class]\ toIDLModule
Specifies IDLEntity package mapping. For example:\ \f2\-idlModule foo.bar my::real::idlmod\fP.
.TP 3
-\-idlFile\ fromJavaPackage[.class]\
-toIDLFile
-Specifies IDLEntity file mapping. For example:\ \f2\-idlFile test.pkg.X TEST16.idl\fP.\
+\-idlFile\ fromJavaPackage[.class]\ toIDLFile
+Specifies IDLEntity file mapping. For example:\ \f2\-idlFile test.pkg.X TEST16.idl\fP.\
+.RE
.LP
.TP 3
\-iiop
@@ -185,6 +186,7 @@
.RE
.LP
When the \f2\-iiop\fP option is used, other options also include:
+.RS 3
.TP 3
\-always or \-alwaysgenerate
Forces re\-generation even when existing stubs/ties/IDL are newer than the input class.
@@ -202,7 +204,8 @@
.na
\f2Portable Object Adapter\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html (POA) defines the native \f2Servant\fP type. In the Java programming language, the \f2Servant\fP type is mapped to the Java \f2org.omg.PortableServer.Servant\fP class. It serves as the base class for all POA servant implementations and provides a number of methods that may be invoked by the application programmer, as well as methods which are invoked by the POA itself and may be overridden by the user to control aspects of servant behavior. Based on the OMG IDL to Java Language Mapping Specification, CORBA V 2.3.1 ptc/00\-01\-08.pdf.
+http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html (POA) defines the native \f2Servant\fP type. In the Java programming language, the \f2Servant\fP type is mapped to the Java \f2org.omg.PortableServer.Servant\fP class. It serves as the base class for all POA servant implementations and provides a number of methods that may be invoked by the application programmer, as well as methods which are invoked by the POA itself and may be overridden by the user to control aspects of servant behavior. Based on the OMG IDL to Java Language Mapping Specification, CORBA V 2.3.1 ptc/00\-01\-08.pdf.
+.RE
.TP 3
\-J
Used in conjunction with any \f2java\fP option, it passes the option following the \f2\-J\fP (no spaces between the \-J and the option) on to the \f2java\fP interpreter.
@@ -212,23 +215,29 @@
.TP 3
\-nowarn
Turns off warnings. If used the compiler does not print out any warnings.
+.LP
.TP 3
\-vcompat
Generates stub and skeleton classes compatible with both the 1.1 and 1.2 JRMP stub protocol versions. (This option was the default in releases prior to 5.0.) The generated stub classes will use the 1.1 stub protocol version when loaded in a JDK 1.1 virtual machine and will use the 1.2 stub protocol version when loaded into a 1.2 (or later) virtual machine. The generated skeleton classes will support both 1.1 and 1.2 stub protocol versions. The generated classes are relatively large in order to support both modes of operation.
.TP 3
\-verbose
Causes the compiler and linker to print out messages about what classes are being compiled and what class files are being loaded.
+.LP
.TP 3
\-v1.1
Generates stub and skeleton classes for the 1.1 JRMP stub protocol version only. Note that this option is only useful for generating stub classes that are serialization\-compatible with pre\-existing, statically\-deployed stub classes that were generated by the \f3rmic\fP tool from JDK 1.1 and that cannot be upgraded (and dynamic class loading is not being used).
+.LP
.TP 3
\-v1.2
(default) Generates stub classes for the 1.2 JRMP stub protocol version only. No skeleton classes are generated with this option because skeleton classes are not used with the 1.2 stub protocol version. The generated stub classes will not work if they are loaded into a JDK 1.1 virtual machine.
+.RE
+
.LP
.SH "ENVIRONMENT VARIABLES"
.LP
.LP
+.RS 3
.TP 3
CLASSPATH
Used to provide the system a path to user\-defined classes. Directories are separated by colons. For example,
@@ -243,6 +252,7 @@
\fP
.fi
.RE
+.RE
.LP
.SH "SEE ALSO"
@@ -250,7 +260,11 @@
.LP
.LP
-java, javac, CLASSPATH
+java(1), javac(1),
+.na
+\f2CLASSPATH\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath
.LP
.LP