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 207238 - Commentary in ApiGen Properties dialog
Summary: Commentary in ApiGen Properties dialog
Status: RESOLVED FIXED
Alias: None
Product: php
Classification: Unclassified
Component: ApiGen (show other bugs)
Version: 7.2
Hardware: All All
: P3 normal (vote)
Assignee: Tomas Mysik
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2012-01-12 20:34 UTC by andrewsville
Modified: 2012-03-25 09:43 UTC (History)
0 users

See Also:
Issue Type: DEFECT
Exception Reporter:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description andrewsville 2012-01-12 20:34:04 UTC 
When you look at the properties (checkboxes) and you are not an experienced ApiGen user, you will probably have no idea what they actually mean.

It would be a great help if there was a commentary for each checkbox. The best way would probably be a tooltip that would appear when one places the cursor over the appropriate checkbox.
Comment 1 andrewsville 2012-01-12 20:52:24 UTC 
As the source of such commentaries you can use ApiGen. When you run it with the --help option you get the shortest description of every configuration option we have :)
Comment 2 Tomas Mysik 2012-01-13 05:00:27 UTC 
Confirmed. BTW in NetBeans, AFAIK we don't use tooltips much, we usually use another label just after the form field but I'm afraid we already have many of checkboxes in the panel so perhaps tooltips will be the only possible solution here.

Thanks.
Comment 3 Tomas Mysik 2012-03-23 13:07:05 UTC 
Fixed, please verify.

Thanks.

http://hg.netbeans.org/web-main/rev/7847ec7bfea8
Comment 4 Quality Engineering 2012-03-24 10:59:19 UTC 
Integrated into 'main-golden', will be available in build *201203240400* on http://bits.netbeans.org/dev/nightly/ (upload may still be in progress)
Changeset: http://hg.netbeans.org/main-golden/rev/7847ec7bfea8
User: Tomas Mysik <tmysik@netbeans.org>
Log: #207238 - Commentary in ApiGen Properties dialog
Comment 5 Quality Engineering 2012-03-25 09:43:57 UTC 
Integrated into 'main-golden', will be available in build *201203250401* on http://bits.netbeans.org/dev/nightly/ (upload may still be in progress)
Changeset: http://hg.netbeans.org/main-golden/rev/7847ec7bfea8
User: Tomas Mysik <tmysik@netbeans.org>
Log: #207238 - Commentary in ApiGen Properties dialog