[Bug libgcj/23258] New: jcf-dump documentation is incomplete (and confusing)

["pebolle at tiscali dot nl" <gcc-bugzilla at gcc dot gnu dot org>]

0) Previously filed downstream here:
https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=164713

1) man jcf-dump and info jcf-dump are (basically) identical. Neither mention:
--bootclasspath
--extdirs
--print-main

2) jcf-dump --help doesn't mention:
--CLASSPATH
--print-main
--print-constants

3) Neither info/man nor --help mention that you can use jcf-dump on (all classes
in) a jar archive.

4) Nowhere in the documentation is it stated clearly that you can jcf-dump
classfiles (not just classes).

5) The description of -o in man and info is slightly puzzling: "Th[is] options
[is] the same as the corresponding gcj option(...)."

6) The descriprition of --extdirs in --help is also intruiging: "Set extensions
directory path". That doesn't seem sufficient to me.

7) I'm happy to submit patches if needed (though you're probably better of with
patches from (one of) the maintainers).

-- 
           Summary: jcf-dump documentation is incomplete (and confusing)
           Product: gcc
           Version: 4.0.1
            Status: UNCONFIRMED
          Severity: enhancement
          Priority: P3
         Component: libgcj
        AssignedTo: unassigned at gcc dot gnu dot org
        ReportedBy: pebolle at tiscali dot nl
                CC: gcc-bugs at gcc dot gnu dot org,java-prs at gcc dot gnu
                    dot org


http://gcc.gnu.org/bugzilla/show_bug.cgi?id=23258