Merge branch 'ja/doc-lint-sections-and-synopsis'

Doc lint updates to encourage the newer and easier-to-use
`synopsis` format, with fixes to a handful of existing uses.

* ja/doc-lint-sections-and-synopsis:
  doc lint: check that synopsis manpages have synopsis inlines
  doc:git-for-each-ref: fix styling and typos
  doc: check for absence of the form --[no-]parameter
  doc: check for absence of multiple terms in each entry of desc list
  doc: check well-formedness of delimited sections
  doc: test linkgit macros for well-formedness

for-each-ref.h

@@ -15,7 +15,7 @@ struct repository;
 	"                         [--merged[=<object>]] [--no-merged[=<object>]]\n" \
 	"                         [--contains[=<object>]] [--no-contains[=<object>]]\n" \
 	"                         [(--exclude=<pattern>)...] [--start-after=<marker>]\n" \
-	"                         [ --stdin | <pattern>... ]"
+	"                         [ --stdin | (<pattern>...)]"
 
 /*
  * The core logic for for-each-ref and its clones.