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 54481

Summary:	renaming a package should alter javadoc references
Product:	editor	Reporter:	orat <orat>
Component:	Refactoring	Assignee:	Jan Becicka <jbecicka>
Status:	RESOLVED WONTFIX
Severity:	blocker	CC:	brutzman
Priority:	P3
Version:	4.x
Hardware:	All
OS:	All
Issue Type:	ENHANCEMENT	Exception Reporter:

Description orat 2005-02-03 14:51:27 UTC

References in Javadoc comments (like the @see tag)
should be altered when renaming a package.

(Same with renaming a single class or a method but
I didn't check whether it does it or not)

Comment 1 Jan Becicka 2005-02-03 18:37:04 UTC

Rename of javadoc is already implemented for method and class rename.
Unfortunately not for move class nor package rename.
Tomasi, do you plan to implement it?

Comment 2 brutzman 2009-09-10 05:30:02 UTC

Rename of parameter names in method declarations does not rename @param tags in preceding Javadoc - tested in Netbeans 6.7.1

p.s. this bug is 4.5 years old!

Comment 3 Jan Pokorsky 2009-09-10 14:58:28 UTC

brutzman: rename of @param works even in NB 6.7.1 using Menu/Refactoring/Rename with apply on comments. The instant
rename with ctrl+R was implemented in NB 6.8, see issue 102669. BTW there is a lot of open issues volunteers are welcome!

The reliable refactoring of references in javadoc tags (@see, @link, ...) is not possible without a class index over all
javadocs that is not and most likely is not going to be implemented. What jbecicka mentioned is a full text search and
replace in javadocs of files where some occurrence of the refactored element was found.

As a workaround for package renames you can import the class and use just simple name as the reference in tags if possible.

Comment 4 Martin Balin 2016-07-07 07:29:28 UTC

This old bug may not be relevant anymore. If you can still reproduce it in 8.2 development builds please reopen this issue.

Thanks for your cooperation,
NetBeans IDE 8.2 Release Boss