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 131099 - deprecated contains no pointer in its Javadoc inside editor to its replacement
Summary: deprecated contains no pointer in its Javadoc inside editor to its replacement
Status: RESOLVED FIXED
Alias: None
Product: java
Classification: Unclassified
Component: Editor (show other bugs)
Version: 6.x
Hardware: All All
: P3 blocker with 1 vote (vote)
Assignee: Dusan Balek
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2008-03-25 22:14 UTC by hallorant
Modified: 2010-05-17 19:25 UTC (History)
2 users (show)

See Also:
Issue Type: DEFECT
Exception Reporter:


Attachments
Javadoc view in NB 6.0.1 showing the FolderLookup class (17.21 KB, image/png)
2008-03-26 21:07 UTC, hallorant
Details

Note You need to log in before you can comment on or make changes to this bug.
Description hallorant 2008-03-25 22:14:48 UTC
The FolderLookup has been deprecated but contains no pointer in its Javadoc to its replacement.  A quick @see tag or
description of what class or group of classes is intended to replace its functionality in NetBeans 6 would be helpful.
Comment 1 hallorant 2008-03-25 22:30:50 UTC
Note that I also found nothing about this at:

http://bits.netbeans.org/6.0/javadoc/apichanges.html
Comment 2 Jaroslav Tulach 2008-03-26 19:20:10 UTC
And the reference to Lookups.forPath is what?
http://bits.netbeans.org/dev/javadoc/org-openide-loaders/org/openide/loaders/FolderLookup.html
Comment 3 hallorant 2008-03-26 21:07:24 UTC
Created attachment 59173 [details]
Javadoc view in NB 6.0.1 showing the FolderLookup class
Comment 4 hallorant 2008-03-26 21:10:40 UTC
The Javadoc view in the IDE is, for some reason, not displaying this information.  The message in your web reference
does appear if you open the actual Javadoc in a browser, but not in the Javadoc view within NetBeans.
Comment 5 Dusan Balek 2008-03-28 09:51:57 UTC
Should be fixed in the current dev build.
Comment 6 arittner 2008-12-17 17:00:35 UTC
But in the documentation is no answer how to replace the the deprecated loopkup-Method with forPath. Please note:
forPath includes subolders:

"and use Lookups.forPath(theFolderName) to retrieve a lookup implementation which will scan this folder and its
subfolders for data objects with InstanceCookie matching the lookup template":

http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/doc-files/api.html#folderlookup

The FolderLookup works only for the current folder. 

best regards, josh.

Comment 7 arittner 2009-03-10 11:45:26 UTC
Hi!

I need more clarification about the API. FolderLookup is deprecated, Lookups.forPath works recursive and
Utilities.actionsForPath works recursive. Well, is it impossible to replace the FolderLookup call? Is this an API issue?
Should this issue reopended?

best regards, josh.