#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>
_______________________________________________
grass-dev mailing list
grass-dev@lists.osgeo.org
https://lists.osgeo.org/mailman/listinfo/grass-dev
