Re: libgcj/5303: Undocumented java programs

Re: libgcj/5303: Undocumented java programs

[tromey]

Synopsis: Undocumented java programs

Responsible-Changed-From-To: unassigned->tromey
Responsible-Changed-By: tromey
Responsible-Changed-When: Mon Apr  8 11:31:41 2002
Responsible-Changed-Why:
    I'm marking this medium priority.  I believe all the parts important for 3.1 have been fixed.
    What remains can be fixed later.
    

http://gcc.gnu.org/cgi-bin/gnatsweb.pl?cmd=view%20audit-trail&database=gcc&pr=5303

Re: libgcj/5303: Undocumented java programs

[jsm28]

Synopsis: Undocumented java programs

State-Changed-From-To: open->analyzed
State-Changed-By: jsm28
State-Changed-When: Mon Jan  7 12:00:52 2002
State-Changed-Why:
    Confirming my own PR, and marking priority "high" as a
    regression in documentedness since 3.0.

http://gcc.gnu.org/cgi-bin/gnatsweb.pl?cmd=view%20audit-trail&database=gcc&pr=5303

libgcj/5303: Undocumented java programs

[Joseph Myers]

>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: