This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 34783 - Docs update for #20211
Summary: Docs update for #20211
Status: RESOLVED FIXED
Alias: None
Product: usersguide
Classification: Unclassified
Component: Code (show other bugs)
Version: 3.x
Hardware: All All
: P3 blocker (vote)
Assignee: John Jullion-ceccarelli
URL:
Keywords: UI
Depends on:
Blocks: 20211
  Show dependency tree
 
Reported: 2003-07-07 17:35 UTC by Jesse Glick
Modified: 2004-01-27 21:00 UTC (History)
1 user (show)

See Also:
Issue Type: DEFECT
Exception Reporter:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Jesse Glick 2003-07-07 17:35:48 UTC
Online Help needs to be updated to reflect
behavioral changes in the Ant module as of issue
#20211. Specifically, a lot of old
classpath-related workarounds (e.g.
$nb/modules/docs/org-apache-tools-ant-module/*.jar)
will be obsolete in NB 4.0 as a result of this change.

A user can simply select the version of Ant to use
inside NB; and also select any additional JARs to
put in Ant's "classpath" - the contents of
${ant.home}/lib/*.jar are automatically in the
classpath, but you can add other JARs.

(Typically you would add libs for tasks in
optional.jar, but sometimes you might add JARs for
other reasons as well - some third-party tasks
simply don't run correctly using <classpath>, and
some preexisting build scripts make a lot of
assumptions about the classpath that the user may
not be free to change.)

Help topics likely affected:

"Ant Classpath and Custom Tasks"
"Optional Ant Tasks"
"Configuring Ant Settings"

And don't forget the web page
ant/www/docs/tasks_classpath.html which would need
updating for the same reason.
Comment 1 John Jullion-ceccarelli 2003-07-08 09:52:11 UTC
So the UI changes involved are the addition of the Additional
Classpath and Ant Home properties under Ant Settings. I take it that
both should be entered as absolute paths to the directory/JAR files.
BTW - any reason why the Ant Home property doesn't have a file chooser
property editor?

Is there now any reason to put things in
$nb/modules/docs/org-apache-tools-ant-module/, or should all mentions
of this directory be removed?
Comment 2 Jesse Glick 2003-07-08 15:27:26 UTC
"So the UI changes involved are the addition of the Additional
Classpath and Ant Home properties under Ant Settings. I take it that
both should be entered as absolute paths to the directory/JAR files."
- yes.

"BTW - any reason why the Ant Home property doesn't have a file
chooser property editor?" - it was too problematic to implement for
now (I tried and ran into serious problems). Someone more skilled with
property editors may be able to do it.

"Is there now any reason to put things in
$nb/modules/docs/org-apache-tools-ant-module/, or should all mentions
of this directory be removed?" - please remove all mentions of this
directory in the documentation. There is no longer any reason to use it.
Comment 3 John Jullion-ceccarelli 2004-01-27 09:40:48 UTC
Done.
Comment 4 Patrick Keegan 2004-01-27 21:00:14 UTC
adjusting target milestone. BTW, I just want to verify that these
changes are valid for NB 3.6, even though Filesystems is still intact.