[GRASS-dev] [GRASS GIS] #3974: Use standard SEE ALSO man page sections

GRASS GIS trac at osgeo.org
Sun Nov 17 10:52:43 PST 2019


#3974: Use standard SEE ALSO man page sections
-------------------------+-------------------------
 Reporter:  jidanni      |      Owner:  grass-dev@…
     Type:  enhancement  |     Status:  new
 Priority:  trivial      |  Milestone:
Component:  Docs         |    Version:  unspecified
 Keywords:               |        CPU:  Unspecified
 Platform:  Unspecified  |
-------------------------+-------------------------
 Looking at e.g., /usr/share/man/man1/v.net.path.1grass.gz

 Emacs has a command

     r runs the command Man-follow-manual-reference, which is an
     interactive compiled Lisp function in ‘man.el’.

     It is bound to r, <menu-bar> <Man> <Follow Reference...>.

     (Man-follow-manual-reference REFERENCE)

     Get one of the manpages referred to in the "SEE ALSO" section.
     Specify which REFERENCE to use; default is based on word at point.

 But it can't deal with man pages with non-standard

     SEE ALSO
             v.segment, v.split, v.to.rast, v.to.db

 It needs something like (man cat:)

    SEE ALSO
           tac(1)

 Therefore it is important that the man pages say

    SEE ALSO
            v.segment(1grass), v.split(1grass), v.to.rast(1grass),
 v.to.db(1grass)

-- 
Ticket URL: <https://trac.osgeo.org/grass/ticket/3974>
GRASS GIS <https://grass.osgeo.org>



More information about the grass-dev mailing list