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.
On step 2 of the Import Management Tool the text mentions a "Maximum Frequency" and the label for the corresponding column is "Final FQN Freq." Seems like these should be the same phrase.
John, can you please check it? I think that the current text is correct, but I am not sure. Thanks.
Maximum FQN refers to the IMT settings in Options window, Final FQN refers to the number of FQNs in the source file after the tool is run. I'm changing the text to "Import statements are created when fully qualified names (FQN) occur more than the Maximum FQN specified in the Import Management Tool settings. You can override the tool's defaults by choosing a different action in the Action column." and closing issue, please reopen if you feel this still isn't clear enough.
Thanks. The new text improves things. Here are some more suggestions for improvements: 1) Explicitly mention the value of the Maximum FQN. Something like: "... occur more than the Maximum FQN (currently XXX) specified ..." 2) Be more clear about how to find the Import Management Tool settings. Something like: "... specified in the Import Management Tool settings (Options|Editing|Java Sources|Import Management Tool Settings)" 3) Better than 2) would be a link or button that would take you directly to the Import Management Tool settings and better yet would be to allows the user to change the Maximum FQN setting in the IMT (I think Svata mentioned something about this in one of the other bug reports). This suggestion is outside the scope of this bug report.
I'm concerned about loading down the IMT with too much text. It's already a full 3 lines! Also, this is all documented in the Help topic - all they have to do is press the little button (which developers hate to do, I know :-) About suggestion 1: Maximum FQN would have to be dynamic to reflect the current setting, don't know if that's possible. A better solution would be 3, which can't be done now and should be done as a more thorough reworking of the IMT. Aboout suggestion 2: Again, I think there's lots of text in this wizard but if people feel strongly I'm willing to add it.
Too much text is a valid concern. Suggestion 1) does not add much text, especially if you drop the "currently". IMHO this is the most important one. When you first use IMT, you have no idea what the Maximum is set to. It should be possible to dynamically get the value. I agree that 2) adds alot of text. A really cool technique would be to make "Import Management Tool settings" a hyperlink that takes you to the right place in Options. That takes us directly into 3).
How about this instead? "Import Statements are created when fully qualified names (FQN) ocur more than four times. You can override the tool's default actions by changing the values in the Action column. You can also change the default threshold in Options | Editing | Java Sources | Import Management Tool Settings | Maximum FQN."
John, can you explain, what was exactly fixed? Thanks.
The explanatory text on the wizard was made clearer. The original issue was confusion between the IMT settings called Maximum FQN and the column in the wizard named Final FQN Frequency. I changed the text to make it more clear. Evan then suggested we mention how to open the IMT settings in the wizard's explanatory. Text. I proposed some other text, but there have been no more comments on it. IMO we should leave it as it is. No other wizard dialogs mention how to reach the Tools | Options settings that control them, and the wizard already has a ton of text on it. And it's all explainged right behind that little Help button, if users weren't afraid to look :-)
OK OK. Thanks.
The most important aspect of this issue is to communicate the maximun FQN. John, you had suggested adding the Maximum FQN to the text: "Import Statements are created when fully qualified names (FQN) ocur more than four times. ^^^^ Is there a problem doing this? The current text is virtually the same as the old text. For comparison here they are. Old text: By default, import statements are created when fully qualified names (FQN) occur more than the Maximum FQN specified. You can override Import Management TOol defaults by choosing a different action in the Action column. Current text: Import statements are created when fully qualified names (FQN) occur more than the Maximum FQN specifed in the Import Management Tool settings. You can overried the tool's defaults by choosing a different action in the Action column.
Yes, we can change it. But we should consider that the sentence is only big enough to say one of the following about the Maximum FQN: * Its default is four. * It's set in the Import Management Tools settings. I think a third sentence is too much text for the wizard. So if you're fine with just mentioning the default number and leaving it up to the user to find out where this default is set, then I'll go ahead and change it. I think this would be fine, as the number of defaults is more immediate of a concern than where to set them (although they are obviously linked).
Added "(default = 4)" to the resource bundle. This solves all the issues.
Resolved for 3.4.x or earlier, no new info since then -> closing.