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

[GRASS GIS]

#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>