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.
| Summary: | New property generates ugly comments | ||
|---|---|---|---|
| Product: | java | Reporter: | carcassi <carcassi> |
| Component: | Beans | Assignee: | Jan Becicka <jbecicka> |
| Status: | NEW --- | ||
| Severity: | blocker | ||
| Priority: | P3 | ||
| Version: | 3.x | ||
| Hardware: | All | ||
| OS: | Windows 95/98 | ||
| Issue Type: | ENHANCEMENT | Exception Reporter: | |
Target milestone was changed from '3.4' to TBD. |
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! :- )