[GRASS-dev] [GRASS GIS] #3143: Scroll to description in the help tab in module forms
GRASS GIS
trac at osgeo.org
Sat Sep 3 09:17:13 PDT 2016
#3143: Scroll to description in the help tab in module forms
-------------------------------------------------+-------------------------
Reporter: wenzeslaus | Owner: grass-dev@…
Type: enhancement | Status: new
Priority: normal | Milestone: 7.4.0
Component: wxGUI | Version: svn-trunk
Keywords: wxPython, HTML, forms, help, manual | CPU: Unspecified
Platform: Linux |
-------------------------------------------------+-------------------------
When you start a module dialog/form, e.g. `r.slope.aspect`, and switch to
''Manual'' tab (or press ''Help'' button) you end up at the beginning of
the module manual page (same as if you do it online or through
`g.manual`). However, it seems more fitting for the GUI, that you go
directly to the description because you already know the name, short
description and perhaps even the keywords of the module. You don't need to
know the synopsis/syntax and your are likely not interested in reading
through all the parameters (option and flags) because you have them in the
GUI.
I suggest to add '#description' to the URL, so that first thing user sees
is the heading DESCRIPTION.
I'm attaching a patch (against trunk, r69358) but I'm not applidng it
because this change would expose a confusing bug - when the window is
resized (a likely event after switching to the manual) the scroll changes
to the start of the page (thus loosing the focus on description section).
The commit r69358 fixes case of loosing scrolling position when switching
back and forth between Manual tab and other tabs. However, this resize-
related bug seems to be coming from wxPython/wxWidgets because this
happens in the wxPython demo as well. Once the wxPython part is solved,
this enhancement can be implemented.
--
Ticket URL: <http://trac.osgeo.org/grass/ticket/3143>
GRASS GIS <https://grass.osgeo.org>
More information about the grass-dev
mailing list