[GRASS5] 5.7: man pages extended

[Hamish]

Markus Neteler <neteler at itc.it> wrote:
> > > I have modified the build script which generates
> > > the HTML manual pages in 5.7 to add a one-line
> > > description of each module. Like that you can
> > > quickly search for a certain functionality.
> 
> 
> Now online at:
>  http://grass.itc.it/grass51/manuals/html57_user/index.html
> (auto-generated from CVS)
> 
> > > So please keep on writing reasonable stuff into
> > >  module->description =
> > ...
> > 
> > > Another useful extension in the C code might be
> > > the introduction of keywords. Per module maybe 
> > > 2-5 keywords. But yes, a lot of work.
> >
> > Could it just search through the module->description strings? most of
> > the keywords will already be in there, & if not probably should be.
> > Adding keywords to every single module is a lot of work...
> 
> Probably we first have to implement an offline search engine
> (something similar as provided by the R-stats where you can search
> within local manual pages). Any ideas?


How does the 'apropos' GNU tool do it?



> > An exception might be where only one of Delaunay/Voronoi is mentioned in
> > the description, but I guess you could always rewrite the line it if
> > need be.
> > 
> > 
> > e.g. Debian's "apt-cache search foo" works on the included 2-3 sentence
> > descriptions.


H