This is the mail archive of the gcc-patches@gcc.gnu.org mailing list for the GCC project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Patch: document jv-convert


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


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]