Opened 4 years ago

Last modified 4 years ago

#3974 new enhancement

Use standard SEE ALSO man page sections

Reported by: jidanni Owned by: grass-dev@…
Priority: trivial Milestone: 7.8.3
Component: Docs Version: unspecified
Keywords: Cc:
CPU: Unspecified Platform: Unspecified

Description

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)

Change History (2)

comment:1 by neteler, 4 years ago

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

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

comment:2 by neteler, 4 years ago

Milestone: 7.8.3
Note: See TracTickets for help on using tickets.