Bug 164713

Summary:	jcf-dump documentation is incomplete (and confusing)
Product:	[Fedora] Fedora	Reporter:	Paul Bolle <pebolle>
Component:	gcc4	Assignee:	Jakub Jelinek <jakub>
Status:	CLOSED UPSTREAM	QA Contact:
Severity:	low	Docs Contact:
Priority:	medium
Version:	4
Target Milestone:	---
Target Release:	---
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2005-08-05 22:19:22 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Paul Bolle 2005-07-30 21:25:56 UTC

Description of problem:
The documentation of jcf-dump is incomplete (and confusing)

Version-Release number of selected component (if applicable):
gcc-java-4.0.1-4.fc4


How reproducible:
Always

Steps to Reproduce:
1. n/a
2.
3.
  
Actual results:
n/a

Expected results:
n/a

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

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

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

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

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

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

6) Should I file a bug upstream? If so, what is the actual gcc component involved?

Comment 1 Jakub Jelinek 2005-08-05 22:19:22 UTC

Yes, this should be definitely filed upstream, not here.
http://gcc.gnu.org/bugzilla/, component libgcj.
When it is fixed upstream, it will eventually make it into Fedora Core packages.

Comment 2 Paul Bolle 2005-08-06 04:51:35 UTC

OK, I've done that. Upstream is http://gcc.gnu.org/bugzilla/show_bug.cgi?id=23258