ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bugzi...@apache.org
Subject [Bug 3090] New: - Examples on "Javadoc" core task could be improved.
Date Fri, 10 Aug 2001 19:05:46 GMT
PLEASE DO NOT REPLY TO THIS MESSAGE. TO FURTHER COMMENT
ON THE STATUS OF THIS BUG PLEASE FOLLOW THE LINK BELOW
AND USE THE ON-LINE APPLICATION. REPLYING TO THIS MESSAGE
DOES NOT UPDATE THE DATABASE, AND SO YOUR COMMENT WILL
BE LOST SOMEWHERE.

http://nagoya.apache.org/bugzilla/show_bug.cgi?id=3090

*** shadow/3090	Fri Aug 10 12:05:46 2001
--- shadow/3090.tmp.17287	Fri Aug 10 12:05:46 2001
***************
*** 0 ****
--- 1,33 ----
+ +============================================================================+
+ | Examples on "Javadoc" core task could be improved.                         |
+ +----------------------------------------------------------------------------+
+ |        Bug #: 3090                        Product: Ant                     |
+ |       Status: NEW                         Version: 1.3                     |
+ |   Resolution:                            Platform: All                     |
+ |     Severity: Enhancement              OS/Version: All                     |
+ |     Priority: Other                     Component: Core tasks              |
+ +----------------------------------------------------------------------------+
+ |  Assigned To: ant-dev@jakarta.apache.org                                   |
+ |  Reported By: acroyear@io.com                                              |
+ |      CC list: Cc:                                                          |
+ +----------------------------------------------------------------------------+
+ |          URL:                                                              |
+ +============================================================================+
+ |                              DESCRIPTION                                   |
+ Because the package-list is sent to javadoc "as-is", there's a discrepency
+ between the options for the packages to be javadoc'ed and the options for the
+ "group" tag.  I tried to use comma-separated lists in "group" and it failed to
+ work right, putting those into "Other Packages" instead of where I specified. 
+ Regular Expressions didn't work either the way the work in other parts of the
+ ant system.  I finally found out why by reading the documentation for the
+ javadoc tool in jdk1.3.1, where I discovered that javadoc uses ':' or ';' for a
+ separator in the -group option based on the platform, even though it uses comma
+ separated for the package list itself.  Ant does no processing on these
+ arguments the way it does for its fileset and javac tags.
+ 
+ This also means there may be a system-dependency error in using group in the
+ javadoc task that I don't think is handled by ant correctly (though I can't
+ confirm it now, not having a windows box to test on).  group should either 1)
+ use commas to be consistent with the other package list or 2) accept both ":"
+ and ";" and correctly convert them across platforms the way the classpath system
+ of ant does.
\ No newline at end of file

Mime
View raw message