[java patch] add rudimentary gcj-dbtool manpage

[Matthias Klose <doko at cs dot tu-berlin dot de>]

Just another rudimentary man page.

Ok to checkin?

2004-12-05  Matthias Klose  <doko@debian.org>

	* Make-lang.in: Add gcj-dbtool to man page targets.
	* gcj.texi: Add chapter `Invoking gcj-dbtool'.
	Fix typo in 'Invoking grmiregistry' chapter.


--- src/gcc/java/gcj.texi~	2004-12-05 19:00:31.000000000 +0000
+++ src/gcc/java/gcj.texi	2004-12-05 22:32:48.000000000 +0000
@@ -70,6 +70,8 @@
                             Generate stubs for Remote Method Invocation.
 * grmiregistry: (gcj)Invoking grmiregistry.
                             The remote object registry.
+* gcj-dbtool: (gcj)Invoking gcj-dbtool.
+                            Manipulate gcj map database files.
 @end direntry
 @end format
 
@@ -113,8 +115,9 @@
 * Invoking jcf-dump::   Print information about class files
 * Invoking gij::	Interpreting Java bytecodes
 * Invoking jv-convert:: Converting from one encoding to another
-* Invoking grmic::        Generate stubs for Remote Method Invocation.
+* Invoking grmic::      Generate stubs for Remote Method Invocation.
 * Invoking grmiregistry:: The remote object registry.
+* Invoking gcj-dbtool:: Manipulate gcj map database files.
 * About CNI::           Description of the Compiled Native Interface
 * System properties::   Modifying runtime behavior of the libgcj library
 * Resources::		Where to look for more information
@@ -1105,7 +1108,7 @@
 @c man title grmiregistry Remote object registry
 
 @c man begin SYNOPSIS grmiregistry
-@command{grmic} [@option{OPTION}] @dots{} [@var{port}]
+@command{grmiregistry} [@option{OPTION}] @dots{} [@var{port}]
 @ignore
   [@option{--help}]
   [@option{--version}]
@@ -1134,6 +1137,52 @@
 
 @c man end
 
+@node Invoking gcj-dbtool
+@chapter Invoking gcj-dbtool
+
+@c man title gcj-dbtool  Manipulate gcj map database files
+
+@c man begin SYNOPSIS gcj-dbtool
+@command{gcj-dbtool} [@option{OPTION}] @dots{} [@var{port}]
+@ignore
+  [@option{--help}]
+  [@option{--version}]
+@end ignore
+@c man end
+
+@c man begin DESCRIPTION gcj-dbtool
+
+@command{gcj-dbtool} is used to manipulate gcj map database files.
+
+@c FIXME: Add real information here.
+@c This really isn't much more than the --help output.
+
+@c man end
+
+@c man begin OPTIONS gcj-dbtool
+
+@table @gcctabopt
+
+@item -n @var{file}.gcjdb [@var{size}]
+Create a new gcj map database.
+
+@item -a @var{file}.gcjdb @var{file}.jar @var{file}.so
+Add the contents of file.jar to the database.
+
+@item -t @var{file}.gcjdb
+Test a gcj map database.
+
+@item -l @var{file}.gcjdb
+List a gcj map database.
+
+@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
--- src/gcc/java/Make-lang.in~	2004-12-05 19:00:31.000000000 +0000
+++ src/gcc/java/Make-lang.in	2004-12-05 22:39:01.000000000 +0000
@@ -188,7 +188,7 @@
 dvi:: doc/gcj.dvi
 html:: $(htmldir)/java/index.html
 JAVA_MANFILES = doc/gcj.1 doc/gcjh.1 doc/jv-scan.1 doc/jcf-dump.1 doc/gij.1 \
-                doc/jv-convert.1 doc/grmic.1 doc/grmiregistry.1
+                doc/jv-convert.1 doc/grmic.1 doc/grmiregistry.1 doc/gcj-dbtool.1
 
 java.man: $(JAVA_MANFILES)
 
@@ -273,6 +273,7 @@
 	-rm -f $(docobjdir)/jv-convert.1
 	-rm -f $(docobjdir)/grmic.1
 	-rm -f $(docobjdir)/grmiregistry.1
+	-rm -f $(docobjdir)/gcj-dbtool.1
 #
 # Stage hooks:
 # The main makefile has already created stage?/java.
@@ -412,7 +413,7 @@
 	$(TEXI2HTML) -I $(docdir)/include -I $(srcdir)/java -o $(@D) $<
 
 .INTERMEDIATE: gcj.pod gcjh.pod jv-scan.pod jcf-dump.pod gij.pod \
-  jv-convert.pod grmic.pod grmiregistry.pod
+  jv-convert.pod grmic.pod grmiregistry.pod gcj-dbtool.pod
 
 gcj.pod: java/gcj.texi
 	-$(TEXI2POD) -D gcj < $< > $@
@@ -430,14 +431,17 @@
 	-$(TEXI2POD) -D grmic < $< > $@
 grmiregistry.pod: java/gcj.texi
 	-$(TEXI2POD) -D grmiregistry < $< > $@
+gcj-dbtool.pod: java/gcj.texi
+	-$(TEXI2POD) -D gcj-dbtool < $< > $@
 
 # Install the man pages.
 java.install-man: installdirs \
                   $(DESTDIR)$(man1dir)/$(JAVA_INSTALL_NAME)$(man1ext) \
 		  $(JAVA_TARGET_INDEPENDENT_BIN_TOOLS:%=doc/%.1) \
-		  doc/gij.1 doc/jv-convert.1 doc/grmic.1 doc/grmiregistry.1
+		  doc/gij.1 doc/jv-convert.1 doc/grmic.1 doc/grmiregistry.1 \
+		  doc/gcj-dbtool.1
 	for tool in $(JAVA_TARGET_INDEPENDENT_BIN_TOOLS) \
-		gij jv-convert grmic grmiregistry ; do \
+		gij jv-convert grmic grmiregistry gcj-dbtool ; do \
 	  tool_transformed_name=`echo $$tool|sed '$(program_transform_name)'`; \
 	  man_name=$(DESTDIR)$(man1dir)/$${tool_transformed_name}$(man1ext); \
 	  rm -f $$man_name ; \