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

#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&gt;
GRASS GIS <https://grass.osgeo.org>

#3974: Use standard SEE ALSO man page sections
--------------------------+-------------------------
  Reporter: jidanni | Owner: grass-dev@…
      Type: enhancement | Status: new
  Priority: trivial | Milestone:
Component: Docs | Version: unspecified
Resolution: | Keywords:
       CPU: Unspecified | Platform: Unspecified
--------------------------+-------------------------

Comment (by neteler):

To implement that, a change in this code is needed:

https://github.com/OSGeo/grass/tree/master/tools/g.html2man/

--
Ticket URL: <https://trac.osgeo.org/grass/ticket/3974#comment:1&gt;
GRASS GIS <https://grass.osgeo.org>