[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