Bug 1095307

Summary: java-1.8.0-openjdk: improve/fix javac man page
Product: [Fedora] Fedora Reporter: Michal Srb <msrb>
Component: java-1.8.0-openjdkAssignee: Deepak Bhole <dbhole>
Status: CLOSED DEFERRED QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: rawhideCC: ahughes, dbhole, jvanek, omajid
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2014-05-09 16:38:15 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Michal Srb 2014-05-07 12:37:07 UTC 
Description of problem:

From javac man page, section "PROGRAMMATIC INTERFACE":

EXAMPLE
    To compile as though providing command-line arguments, use the following syntax:

    JavaCompiler javac = ToolProvider.getSystemJavaCompiler();
    JavaCompiler javac = ToolProvider.getSystemJavaCompiler();


I believe it's a bug. Second line of the code snippet is the same as a first one.
Same example, but in older version of the javac man page [1] looks like following:

    JavaCompiler javac = ToolProvider.getSystemJavaCompiler();
    int rc = javac.run(null, null, null, args);

Which seems to be much better.

[1]: http://docs.oracle.com/javase/7/docs/technotes/tools/solaris/javac.html

Version-Release number of selected component (if applicable):
java-1.8.0-openjdk-devel-1.8.0.5-4.b13.fc21.x86_64
Comment 1 Omair Majid 2014-05-09 16:22:58 UTC 
Filed upstream: https://bugs.openjdk.java.net/browse/JDK-8042840
Comment 2 Deepak Bhole 2014-05-09 16:38:15 UTC 
Transferred to upstream, please track the bug in comment #1 instead of this one.