diff src/solaris/doc/sun/man/man1/rmic.1 @ 1228:b056c42ea5b4

6837214: Update JDK7 man pages Reviewed-by: darcy, bpatel, tbell Contributed-by: jacob.royal@sun.com
author tbell
date Mon, 04 May 2009 18:28:26 -0700
parents 37a05a11f281
children 00cd9dc3c2b5
line wrap: on
line diff
--- a/src/solaris/doc/sun/man/man1/rmic.1	Thu Apr 30 15:04:39 2009 -0700
+++ b/src/solaris/doc/sun/man/man1/rmic.1	Mon May 04 18:28:26 2009 -0700
@@ -1,5 +1,4 @@
-.'" t
-." Copyright 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
@@ -19,19 +18,21 @@
 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
 ." 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
 
@@ -83,6 +84,7 @@
 .LP
 
 .LP
+.RS 3
 .TP 3
 \-bootclasspath path 
 Overrides location of bootstrap class files 
@@ -135,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 
@@ -144,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. 
@@ -151,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 
@@ -183,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. 
@@ -200,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. 
@@ -210,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, 
@@ -241,6 +252,7 @@
 \fP
 .fi
 .RE
+.RE
 
 .LP
 .SH "SEE ALSO"
@@ -248,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