[prev in list] [next in list] [prev in thread] [next in thread] 

List:       ant-dev
Subject:    DO NOT REPLY [Bug 39153]  New:  - Add note on ignored classpath for <java jar="...">
From:       bugzilla () apache ! org
Date:       2006-03-30 12:49:30
Message-ID: bug-39153-472 () http ! issues ! apache ! org/bugzilla/
[Download RAW message or body]

DO NOT REPLY TO THIS EMAIL, BUT PLEASE POST YOUR BUG·
RELATED COMMENTS THROUGH THE WEB INTERFACE AVAILABLE AT
<http://issues.apache.org/bugzilla/show_bug.cgi?id=39153>.
ANY REPLY MADE TO THIS MESSAGE WILL NOT BE COLLECTED AND·
INSERTED IN THE BUG DATABASE.

http://issues.apache.org/bugzilla/show_bug.cgi?id=39153

           Summary: Add note on ignored classpath for <java jar="...">
           Product: Ant
           Version: 1.6.5
          Platform: All
        OS/Version: other
            Status: NEW
          Severity: minor
          Priority: P3
         Component: Documentation
        AssignedTo: dev@ant.apache.org
        ReportedBy: wolfgang.frech@iteratec.de


The <java> task ignores the specified classpath (attribute or nested element)
when executing a executable JAR specified with the jar attribute.
This is the expected behavior if one happens to remember Sun's documentation of
the java command.

  -jar (...)
     When you use this option, the JAR file is the source of all user classes,
and other user class path settings are ignored.

I propose this additions to the documentation of the java task.

1) in attribute table
1.1) add to description of jar attribute
"If used, the classpath defined in the class attribute or nested classpath
element is ignored."

1.2) add to description of classpath
"Ignored if jar attribute is set."

1.4) add to description of classpathref
"Ignored if jar attribute is set."

2) add after description of nested element classpath
"Ignored if jar attribute is set."

3) optional - add note after Errors and Return Codes
Along these lines...
"An executable jar should contain all user code.  
Both the java command line tool and the java task ignore additional classpath
settings.
See (ref to Sun's tooldocs, eg.
http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/java.html)"

4) optional - warn if ignoring a classpath setting
not exactly a documentation RFE.
This would be the real fix.

-- 
Configure bugmail: http://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org

[prev in list] [next in list] [prev in thread] [next in thread]