Amended specification.

Specification.md

@@ -0,0 +1,17 @@
+Program:
+
+program *program name here*
+version "*version information here*"
+help "*help information here*"
+
+Usage:
+
+*program name* *(optional argument list)*
+*program name* **alternative form** *(optional argument list)*
+*...*
+
+Arguments:
+
+*some grammar for composite arguments*
+
+*--longform*, *(optional shortform)*, *(optional arguments)*, *description*

examples/true/true.argspec

@@ -1,6 +1,6 @@
 Program:
 
-true
+program true
 version "true (GNU coreutils) 8.31"
 license "Copyright (C) 2019 Free Software Foundation, Inc."
 help "NOTE: your shell may have its own version of true, which usually supersedes the version described here."