This is the mail archive of the
java-prs@gcc.gnu.org
mailing list for the Java project.
libgcj/5303: Undocumented java programs
- From: Joseph Myers <jsm28 at cam dot ac dot uk>
- To: gcc-gnats at gcc dot gnu dot org
- Cc: jsm28 at cam dot ac dot uk
- Date: Mon, 07 Jan 2002 19:49:50 +0000
- Subject: libgcj/5303: Undocumented java programs
>Number: 5303
>Category: libgcj
>Synopsis: Undocumented java programs
>Confidential: no
>Severity: serious
>Priority: medium
>Responsible: unassigned
>State: open
>Class: doc-bug
>Submitter-Id: net
>Arrival-Date: Mon Jan 07 11:56:00 PST 2002
>Closed-Date:
>Last-Modified:
>Originator: Joseph S. Myers
>Release: 3.1 20020107 (experimental)
>Organization:
none
>Environment:
System: Linux digraph 2.2.20 #2 Sat Nov 10 16:44:22 UTC 2001 i686 unknown
Architecture: i686
host: i686-pc-linux-gnu
build: i686-pc-linux-gnu
target: i686-pc-linux-gnu
configured with: ../gcc-cvs/configure --prefix=/opt/gcc/mainline --disable-shared --enable-threads=posix --with-system-zlib
>Description:
GCC now installs the following Java-related programs without any
documentation: they are not documented in gcj.texi, nor in their own
Texinfo manuals, nor even in man pages (though man pages would not be
sufficient for GNU documentation).
addr2name.awk (which is also broken; it starts #!/bin/awk when awk is
in /usr/bin on my system, rather than being properly autoconfigured).
grepjar (which doesn't even support --help)
jar (which doesn't support --help though the usage message it gives
when passed --help isn't far off correct --help output)
jv-convert (which doesn't support --help)
rmic (which doesn't support --help though the usage message given
isn't far off correct --help output)
rmiregistry (which, given --help, crashes with a backtrace on my
system, then hangs)
Of these, addr2name.awk, jar and jv-convert were already present and
undocumented in 3.0.x. The others are new, and so constitute
regressions in documentedness.
>How-To-Repeat:
Try to find documentation of any of the above programs.
>Fix:
Document the above programs. Failing that, remove (or at least
disable installation of) all the undocumented programs that are new
since 3.0 before 3.1 is released.
>Release-Note:
>Audit-Trail:
>Unformatted: