This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
Patch: document jv-convert
- From: Tom Tromey <tromey at redhat dot com>
- To: Gcc Patch List <gcc-patches at gcc dot gnu dot org>
- Cc: Java Patch List <java-patches at gcc dot gnu dot org>, "Joseph S. Myers" <jsm28 at cam dot ac dot uk>
- Date: 09 Jan 2002 17:26:02 -0700
- Subject: Patch: document jv-convert
- Reply-to: tromey at redhat dot com
This patch documents jv-convert. It is for PR 5303.
Ordinarily I would just check this in, seeing as I wrote gcj.texi.
However, I thought I'd get Joseph's comments on the texinfo first.
Also I suppose I need approval for the Make-lang.in changes.
Tom
Index: ChangeLog
from Tom Tromey <tromey@redhat.com>
For PR libgcj/5303:
* Make-lang.in (java.install-man): Handle jv-convert man page.
(java.generated-manpages): Added jv-convert.1.
(java.uninstall): Remove jv-convert.1.
(java.maintainer-clean): Likewise.
($(srcdir)/java/jv-convert.1): New target.
* gcj.texi (Top): Link to jv-convert node.
(Individual utilities): Likewise.
(Invoking jv-convert): New node.
Index: Make-lang.in
===================================================================
RCS file: /cvs/gcc/gcc/gcc/java/Make-lang.in,v
retrieving revision 1.78
diff -u -r1.78 Make-lang.in
--- Make-lang.in 2001/12/23 16:07:13 1.78
+++ Make-lang.in 2002/01/10 00:10:24
@@ -1,6 +1,6 @@
# Top level makefile fragment for the GNU compiler for the Java(TM)
# language.
-# Copyright (C) 1996, 1998, 1999, 2000, 2001 Free Software Foundation, Inc.
+# Copyright (C) 1996, 1998, 1999, 2000, 2001, 2002 Free Software Foundation, Inc.
#This file is part of GNU CC.
@@ -151,7 +151,7 @@
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/gij.1 $(srcdir)/java/jv-convert.1
# Install hooks:
# jc1, gcj, jvgenmain, and gcjh are installed elsewhere as part
@@ -192,6 +192,7 @@
-rm -rf $(man1dir)/jv-scan$(man1ext)
-rm -rf $(man1dir)/jcf-dump$(man1ext)
-rm -rf $(man1dir)/gij$(man1ext)
+ -rm -rf $(man1dir)/jv-convert$(man1ext)
java.install-info: installdirs
if [ -f jc1$(exeext) ] ; then \
@@ -228,6 +229,7 @@
-rm -f $(srcdir)/java/gcj.1 $(srcdir)/java/gcjh.1
-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
#
# Stage hooks:
# The main makefile has already created stage?/java.
@@ -356,6 +358,13 @@
(rm -f java/gij.1.T$$$$ && exit 1)
rm -f java/gij.pod
+$(srcdir)/java/jv-convert.1: $(srcdir)/java/gcj.texi
+ -$(TEXI2POD) -D jv-convert < $(srcdir)/java/gcj.texi > java/jv-convert.pod
+ ($(POD2MAN) --section=1 java/jv-convert.pod > java/jv-convert.1.T$$$$ && \
+ mv -f java/jv-convert.1.T$$$$ $(srcdir)/java/jv-convert.1) || \
+ (rm -f java/jv-convert.1.T$$$$ && exit 1)
+ rm -f java/jv-convert.pod
+
# Install the man pages.
java.install-man: installdirs $(GENERATED_JAVA_MANPAGES)
-if [ -f $(GCJ)$(exeext) ]; then \
@@ -381,3 +390,6 @@
-rm -f $(man1dir)/gij$(man1ext)
-$(INSTALL_DATA) $(srcdir)/java/gij.1 $(man1dir)/gij$(man1ext)
-chmod a-x $(man1dir)/gij$(man1ext)
+ -rm -f $(man1dir)/jv-convert$(man1ext)
+ -$(INSTALL_DATA) $(srcdir)/java/jv-convert.1 $(man1dir)/jv-convert$(man1ext)
+ -chmod a-x $(man1dir)/jv-convert$(man1ext)
Index: gcj.texi
===================================================================
RCS file: /cvs/gcc/gcc/gcc/java/gcj.texi,v
retrieving revision 1.17
diff -u -r1.17 gcj.texi
--- gcj.texi 2001/12/17 19:20:05 1.17
+++ gcj.texi 2002/01/10 00:10:25
@@ -34,6 +34,8 @@
* jcf-dump: (gcj)Invoking jcf-dump.
Print information about Java class files
* gij: (gcj)Invoking gij. GNU interpreter for Java bytecode
+* jv-convert: (gcj)Invoking jv-convert.
+ Convert file from one encoding to another
@end direntry
@end format
@@ -120,6 +122,7 @@
* Invoking jv-scan:: Print information about source files
* Invoking jcf-dump:: Print information about class files
* Invoking gij:: Interpreting Java bytecodes
+* Invoking jv-convert:: Converting from one encoding to another
* Resources:: Where to look for more information
@end menu
@@ -765,6 +768,65 @@
@item --version
Print version number, then exit.
+@end table
+
+@c man end
+
+@node Invoking jv-convert
+@chapter Invoking jv-convert
+
+@c man title jv-convert Convert file from one encoding to another
+
+@c man begin synopsis jv-convert
+jv-convert [@option{OPTION}] @dots{} [@var{INPUTFILE} [@var{OUTPUTFILE}]]
+@ignore
+
+ [@option{--encoding} @var{name}]
+ [@option{--from} @var{name}]
+ [@option{--to} @var{name}]
+ [@option{-i} @var{file}] [@option{-o} @var{file}]
+ [@option{--reverse}] [@option{--help}] [@option{--version}]
+@end ignore
+@c man end
+
+@c man begin DESCRIPTION jv-convert
+
+@code{jv-convert} is a utility included with @code{libgcj} which
+converts a file from one encoding to another. It is similar to the Unix
+@code{iconv} utility.
+
+The encodings supported by @code{jv-convert} are platform-dependent.
+Currently there is no way to get a list of all supported encodings.
+
+@c man end
+
+@c man begin OPTIONS jv-convert
+
+@table @gcctabopt
+@item --encoding @var{name}
+@itemx --from @var{name}
+Use @var{name} as the input encoding. The default is the current
+locale's encoding.
+
+@item --to @var{name}
+Use @var{name} as the output encoding. The default is the
+@code{JavaSrc} encoding; this is ASCII with @samp{\u} escapes for
+non-ASCII characters.
+
+@item -i @var{file}
+Read from @var{file}. The default is to read from standard input.
+
+@item -o @var{file}
+Write to @var{file}. The default is to write to standard output.
+
+@item --reverse
+Swap the input and output encodings.
+
+@item --help
+Print a help message, then exit.
+
+@item --version
+Print version information, then exit.
@end table
@c man end