From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 24015 invoked by alias); 7 Jan 2002 19:56:02 -0000 Mailing-List: contact gcc-prs-help@gcc.gnu.org; run by ezmlm Precedence: bulk List-Archive: List-Post: List-Help: Sender: gcc-prs-owner@gcc.gnu.org Received: (qmail 23927 invoked by uid 71); 7 Jan 2002 19:56:01 -0000 Resent-Date: 7 Jan 2002 19:56:01 -0000 Resent-Message-ID: <20020107195601.23921.qmail@sources.redhat.com> Resent-From: gcc-gnats@gcc.gnu.org (GNATS Filer) Resent-To: nobody@gcc.gnu.org Resent-Cc: gcc-prs@gcc.gnu.org, gcc-bugs@gcc.gnu.org, java-prs@gcc.gnu.org Resent-Reply-To: gcc-gnats@gcc.gnu.org, Joseph Myers Received:(qmail 21938 invoked from network); 7 Jan 2002 19:49:51 -0000 Received: from unknown (HELO lilac.csi.cam.ac.uk) (131.111.8.44) by sources.redhat.com with SMTP; 7 Jan 2002 19:49:51 -0000 Received: from jsm28.trin.cam.ac.uk ([131.111.231.99] ident=[nIpSViJu1BFUo9r80muuIv9AOBy0m3QC]) by lilac.csi.cam.ac.uk with esmtp (Exim 3.34 #1) id 16NfmI-0003A5-00; Mon, 07 Jan 2002 19:49:50 +0000 Received: from jsm28 by jsm28.trin.cam.ac.uk with local (Exim 3.33 #1) id 16NfmI-00039c-00; Mon, 07 Jan 2002 19:49:50 +0000 Message-Id: Date: Mon, 07 Jan 2002 11:56:00 -0000 From: Joseph Myers To: gcc-gnats@gcc.gnu.org Cc: jsm28@cam.ac.uk X-Send-Pr-Version:3.113 Subject: libgcj/5303: Undocumented java programs X-SW-Source: 2002-01/txt/msg00311.txt.bz2 List-Id: >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: