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 24502 - New property generates ugly comments
Summary: New property generates ugly comments
Status: NEW
Alias: None
Product: java
Classification: Unclassified
Component: Beans (show other bugs)
Version: 3.x
Hardware: All Windows 95/98
: P3 blocker with 2 votes (vote)
Assignee: Jan Becicka
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2002-06-06 23:12 UTC by carcassi
Modified: 2010-09-23 08:29 UTC (History)
0 users

See Also:
Issue Type: ENHANCEMENT
Exception Reporter:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description carcassi 2002-06-06 23:12:46 UTC
When you to create a bean property with the getter
and setter the generated comment ("Getter for property 
xxx") IMHO is a bad example of documentation. :-)

If you really want to make it generate the comment, I 
really think the user should be asked for a description 
for the property. Something like two extra field at the 
end of the bean property dialog: "description", that is 
used for the first line of the getter and setter (ex. "the 
text displayed in title"), and "constraints", that is used 
for the comment of the parameter for the setter
(ex. "must be a non-null String").

Just a thought, I am sure there are even better 
solutions... but the "Getter for property xxx" is awful! :-
)
Comment 1 Marek Grummich 2002-07-22 08:27:46 UTC
Target milestone was changed from '3.4' to TBD.