From 661337214024464f9cdd54e9c34c4a4008f24b24 Mon Sep 17 00:00:00 2001 From: Tom Tromey Date: Mon, 8 Apr 2002 18:32:23 +0000 Subject: [PATCH] For PR libgcj/5303: * .cvsignore: Added rmic.1 and rmiregistry.1. * gcj.texi (Top): Link to new nodes. (Invoking rmic): New node. (Invoking rmiregistry): Likewise. * Make-lang.in (java.generated-manpages): Added rmic.1 and rmiregistry.1. (java.maintainer-clean): Likewise. ($(srcdir)/java/rmic.1): New target. ($(srcdir)/java/rmiregistry.1): Likewise. (java.install-man): Handle rmic.1 and rmiregistry.1. From-SVN: r52035 --- gcc/java/.cvsignore | 1 + gcc/java/ChangeLog | 14 +++++ gcc/java/Make-lang.in | 25 ++++++++- gcc/java/gcj.texi | 125 +++++++++++++++++++++++++++++++++++++++++- 4 files changed, 162 insertions(+), 3 deletions(-) diff --git a/gcc/java/.cvsignore b/gcc/java/.cvsignore index 7a026d66f50..dab65347a77 100644 --- a/gcc/java/.cvsignore +++ b/gcc/java/.cvsignore @@ -7,3 +7,4 @@ jv-scan.1 jcf-dump.1 gij.1 jv-convert.1 +rmic.1 rmiregistry.1 diff --git a/gcc/java/ChangeLog b/gcc/java/ChangeLog index b4932ea74e1..8fc2ce76bba 100644 --- a/gcc/java/ChangeLog +++ b/gcc/java/ChangeLog @@ -1,3 +1,17 @@ +2002-04-08 Tom Tromey + + For PR libgcj/5303: + * .cvsignore: Added rmic.1 and rmiregistry.1. + * gcj.texi (Top): Link to new nodes. + (Invoking rmic): New node. + (Invoking rmiregistry): Likewise. + * Make-lang.in (java.generated-manpages): Added rmic.1 and + rmiregistry.1. + (java.maintainer-clean): Likewise. + ($(srcdir)/java/rmic.1): New target. + ($(srcdir)/java/rmiregistry.1): Likewise. + (java.install-man): Handle rmic.1 and rmiregistry.1. + 2002-04-08 Bryce McKinlay * gcj.texi (Invocation): Update JvAttachCurrentThread documentation. diff --git a/gcc/java/Make-lang.in b/gcc/java/Make-lang.in index 00185e5824b..935479a4bab 100644 --- a/gcc/java/Make-lang.in +++ b/gcc/java/Make-lang.in @@ -152,7 +152,8 @@ java.info: $(srcdir)/java/gcj.info java.dvi: java/gcj.dvi java.generated-manpages: $(srcdir)/java/gcj.1 $(srcdir)/java/gcjh.1 \ $(srcdir)/java/jv-scan.1 $(srcdir)/java/jcf-dump.1 \ - $(srcdir)/java/gij.1 $(srcdir)/java/jv-convert.1 + $(srcdir)/java/gij.1 $(srcdir)/java/jv-convert.1 \ + $(srcdir)/java/rmic.1 $(srcdir)/java/rmiregistry.1 # Install hooks: # jc1, gcj, jvgenmain, and gcjh are installed elsewhere as part @@ -233,6 +234,8 @@ java.maintainer-clean: -rm -f $(srcdir)/java/jv-scan.1 $(srcdir)/java/jcf-dump.1 -rm -f $(srcdir)/java/gij.1 -rm -f $(srcdir)/java/jv-convert.1 + -rm -f $(srcdir)/java/rmic.1 + -rm -f $(srcdir)/java/rmiregistry.1 # # Stage hooks: # The main makefile has already created stage?/java. @@ -370,6 +373,20 @@ $(srcdir)/java/jv-convert.1: $(srcdir)/java/gcj.texi (rm -f java/jv-convert.1.T$$$$ && exit 1) rm -f java/jv-convert.pod +$(srcdir)/java/rmic.1: $(srcdir)/java/gcj.texi + -$(TEXI2POD) -D rmic < $(srcdir)/java/gcj.texi > java/rmic.pod + ($(POD2MAN) --section=1 java/rmic.pod > java/rmic.1.T$$$$ && \ + mv -f java/rmic.1.T$$$$ $(srcdir)/java/rmic.1) || \ + (rm -f java/rmic.1.T$$$$ && exit 1) + rm -f java/rmic.pod + +$(srcdir)/java/rmiregistry.1: $(srcdir)/java/gcj.texi + -$(TEXI2POD) -D rmiregistry < $(srcdir)/java/gcj.texi > java/rmiregistry.pod + ($(POD2MAN) --section=1 java/rmiregistry.pod > java/rmiregistry.1.T$$$$ && \ + mv -f java/rmiregistry.1.T$$$$ $(srcdir)/java/rmiregistry.1) || \ + (rm -f java/rmiregistry.1.T$$$$ && exit 1) + rm -f java/rmiregistry.pod + # Install the man pages. java.install-man: installdirs $(GENERATED_JAVA_MANPAGES) -if [ -f $(GCJ)$(exeext) ]; then \ @@ -398,3 +415,9 @@ java.install-man: installdirs $(GENERATED_JAVA_MANPAGES) -rm -f $(man1dir)/jv-convert$(man1ext) -$(INSTALL_DATA) $(srcdir)/java/jv-convert.1 $(man1dir)/jv-convert$(man1ext) -chmod a-x $(man1dir)/jv-convert$(man1ext) + -rm -f $(man1dir)/rmic$(man1ext) + -$(INSTALL_DATA) $(srcdir)/java/rmic.1 $(man1dir)/rmic$(man1ext) + -chmod a-x $(man1dir)/rmic$(man1ext) + -rm -f $(man1dir)/rmiregistry$(man1ext) + -$(INSTALL_DATA) $(srcdir)/java/rmiregistry.1 $(man1dir)/rmiregistry$(man1ext) + -chmod a-x $(man1dir)/rmiregistry$(man1ext) diff --git a/gcc/java/gcj.texi b/gcc/java/gcj.texi index 9f1b41fcf1e..1395b11ac40 100644 --- a/gcc/java/gcj.texi +++ b/gcc/java/gcj.texi @@ -36,6 +36,10 @@ * gij: (gcj)Invoking gij. GNU interpreter for Java bytecode * jv-convert: (gcj)Invoking jv-convert. Convert file from one encoding to another +* rmic: (gcj)Invoking rmic. + Generate stubs for Remote Method Invocation. +* rmiregistry: (gcj)Invoking rmiregistry. + The remote object registry. @end direntry @end format @@ -113,7 +117,7 @@ files and object files, and it can read both Java source code and @file{.class} files. @menu -* Copying:: The GNU General Public License +* Copying:: The GNU General Public License * GNU Free Documentation License:: How you can share and copy this manual * Invoking gcj:: Compiler options supported by @command{gcj} @@ -123,6 +127,8 @@ files and object files, and it can read both Java source code and * Invoking jcf-dump:: Print information about class files * Invoking gij:: Interpreting Java bytecodes * Invoking jv-convert:: Converting from one encoding to another +* Invoking rmic:: Generate stubs for Remote Method Invocation. +* Invoking rmiregistry:: The remote object registry. * About CNI:: Description of the Cygnus Native Interface * Resources:: Where to look for more information @end menu @@ -784,7 +790,7 @@ Print version number, then exit. @c man title jv-convert Convert file from one encoding to another -@c man begin synopsis jv-convert +@c man begin SYNOPSIS jv-convert @command{jv-convert} [@option{OPTION}] @dots{} [@var{INPUTFILE} [@var{OUTPUTFILE}]] @ignore @@ -838,6 +844,121 @@ Print version information, then exit. @c man end +@node Invoking rmic +@chapter Invoking rmic + +@c man title rmic Generate stubs for Remote Method Invocation + +@c man begin SYNOPSIS rmic +@command{rmic} [@option{OPTION}] @dots{} @var{class} @dots{} +@ignore + [@option{-keep}] + [@option{-keepgenerated}] + [@option{-v1.1}] + [@option{-vcompat}] + [@option{-v1.2}] + [@option{-nocompile}] + [@option{-verbose}] + [@option{-d} @var{directory}] + [@option{-help}] + [@option{-version}] +@end ignore +@c man end + +@c man begin DESCRIPTION rmic + +@command{rmic} is a utility included with @code{libgcj} which generates +stubs for remote objects. + +@c FIXME: Add real information here. +@c This really isn't much more than the --help output. + +Note that this program isn't yet fully compatible with the JDK +@command{rmic}. Some options, such as @option{-classpath}, are +recognized but currently ignored. We have left these options +undocumented for now. + +Long options can also be given with a GNU-style leading @samp{--}. For +instance, @option{--help} is accepted. + +@c man end + +@c man begin OPTIONS rmic + +@table @gcctabopt +@item -keep +@itemx -keepgenerated +By default, @command{rmic} deletes intermediate files. Either of these +options causes it not to delete such files. + +@item -v1.1 +Cause @command{rmic} to create stubs and skeletons for the 1.1 +protocol version. + +@item -vcompat +Cause @command{rmic} to create stubs and skeletons compatible with both +the 1.1 and 1.2 protocol versions. This is the default. + +@item -v1.2 +Cause @command{rmic} to create stubs and skeletons for the 1.2 +protocol version. + +@item -nocompile +Don't compile the generated files. + +@item -verbose +Print information about what @command{rmic} is doing. + +@item -d @var{directory} +Put output files in @var{directory}. By default the files are put in +the current working directory. + +@item -help +Print a help message, then exit. + +@item -version +Print version information, then exit. +@end table + +@c man end + + +@node Invoking rmiregistry +@chapter Invoking rmiregistry + +@c man title rmiregistry Remote object registry + +@c man begin SYNOPSIS rmiregistry +@command{rmic} [@option{OPTION}] @dots{} [@var{port}] +@ignore + [@option{--help}] + [@option{--version}] +@end ignore +@c man end + +@c man begin DESCRIPTION rmiregistry + +@command{rmiregistry} starts a remote object registry on the current +host. If no port number is specified, then port 1099 is used. + +@c FIXME: Add real information here. +@c This really isn't much more than the --help output. + +@c man end + +@c man begin OPTIONS rmiregistry + +@table @gcctabopt +@item --help +Print a help message, then exit. + +@item --version +Print version information, then exit. +@end table + +@c man end + + @node About CNI @chapter About CNI