Informal CLI syntax

[jidanni]

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.

[neteler]

Good point. Fixed in

• master: ​https://github.com/OSGeo/grass/commit/c6e49db4da5e25537577cfeeab4a5b1a0949f35b
• relbranch78: ​https://github.com/OSGeo/grass/commit/2b465c1d8b04869c0866d719190ad811702629ee

[jidanni]

Wait, you still need to fix v.in.ascii, as mentioned above.

And in fact tons more of the man pages suffer the same problem.

[neteler]

ok - pull requests are welcome.

[neteler]

Ticket retargeted after milestone closed