They are good candidates to use both module->label and
module->description. Using both of those is not an error. If the GUI or
lib/parser.c fails to deal with that, the bug is not in the module.
Just like with option descriptions, when ->label is present it becomes
the short GUI label and ->description then becomes the longer tooltip
text.
In the case where helpful information is removed from one place, care
must be taken to add it back in somewhere else.
They are good candidates to use both module->label and
module->description. Using both of those is not an error. If the GUI or
lib/parser.c fails to deal with that, the bug is not in the module.
I am not sure about using tooltips for module description (i.e.
label/description). The tooltip can be moved to the manual page
('description' section). See [1].
Hamish wrote:
> I notice these two changes: (are there more?)
> http://trac.osgeo.org/grass/changeset/25463
> http://trac.osgeo.org/grass/changeset/29533
>
> They are good candidates to use both module->label and
> module->description. Using both of those is not an error. If the
> GUI or lib/parser.c fails to deal with that, the bug is not in the
> module.
Martin:
I am not sure about using tooltips for module description (i.e.
label/description). The tooltip can be moved to the manual page
('description' section). See [1].
ok, if you follow the thread view from that post you can see Glynn's
replies of Sep 8, 2007 and Mar 23, 2007 which should help explain it.
The dual role of ->description is a bit confusing at first but makes
some sense once it is explained.
A module's (or option's) sub-title need not be shown or thought of as a
tooltip. e.g. --help, --html-description, the TclTk GUI and
tools/module_synopsis.sh all handle it well. For module options, making
it into a tooltip is just a handy thing to do with it. I would hope
wxGUI would handle module->label in a similar way to the TclTk GUI
(unfortunately I still wait for Debian+wx2.8 issues to be resolved
before I can help).
If the information is important enough to be used as a subtitle, by all
means it should be mentioned in the help page as well.
...
> In the case where helpful information is removed from one place,
> care must be taken to add it back in somewhere else.
The tooltip (module->description) has been moved to the manual page.
I saw that, I was wondering about r29533. (I see you've now corrected
that, thanks)
Hamish
____________________________________________________________________________________
Never miss a thing. Make Yahoo your home page. http://www.yahoo.com/r/hs
> Hamish wrote:
> > I notice these two changes: (are there more?)
> > http://trac.osgeo.org/grass/changeset/25463
> > http://trac.osgeo.org/grass/changeset/29533
> >
> > They are good candidates to use both module->label and
> > module->description. Using both of those is not an error. If the
> > GUI or lib/parser.c fails to deal with that, the bug is not in the
> > module.
ok, if you follow the thread view from that post you can see Glynn's
replies of Sep 8, 2007 and Mar 23, 2007 which should help explain it.
The dual role of ->description is a bit confusing at first but makes
some sense once it is explained.
A module's (or option's) sub-title need not be shown or thought of as a
tooltip. e.g. --help, --html-description, the TclTk GUI and
tools/module_synopsis.sh all handle it well. For module options, making
it into a tooltip is just a handy thing to do with it. I would hope
wxGUI would handle module->label in a similar way to the TclTk GUI
(unfortunately I still wait for Debian+wx2.8 issues to be resolved
before I can help).
If the information is important enough to be used as a subtitle, by all
means it should be mentioned in the help page as well.
The wxGUI would handle module->label as well, it is trivial issue. I
am not sure, should I revert these two changes (to add module->label)?