[GRASS-dev] [GRASS GIS] #3953: Informal CLI syntax

GRASS GIS trac at osgeo.org
Sat Nov 16 21:53:55 PST 2019

#3953: Informal CLI syntax
 Reporter:  jidanni      |      Owner:  grass-dev@…
     Type:  enhancement  |     Status:  new
 Priority:  minor        |  Milestone:
Component:  Docs         |    Version:  unspecified
 Keywords:               |        CPU:  Unspecified
 Platform:  Unspecified  |
 From its examples, one concurs the SYNOPSIS

        v.segment input=name    [layer=strin...

 should by written

        v.segment [input=]name  [layer=strin...
 or enhance the v.segment examples to match the SYNOPSIS.

 Also on man v.in.ascii the examples
 contain in= and out=. If these are informal aliases for input= and
 output=, then the SYNOPSIS should say so. Else they are invalid examples.
 Same with Usage message seen with v.in.ascii --help.

 Anyway there seem to be many man pages with examples from a previous
 informal age, not matching the more formal syntax in their SYNOPSIS.

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

More information about the grass-dev mailing list