Re: [GSoC][RFC PATCH v2 1/2] builtin/refs: add list subcommand

> > diff --git a/Documentation/refs-list-options.adoc b/Documentation/refs-list-options.adoc
> > @@ -0,0 +1,80 @@
> > +// Shared options for for-each-ref and refs list
> > +<pattern>...::
> > +       If one or more patterns are given, only refs are shown that
> > +       match against at least one pattern, either using fnmatch(3) or
> > +       literally, in the latter case matching completely or from the
> > +       beginning up to a slash.
>
> Nit: We probably don't want the "// Shared options for..." comment. If
> someone needs to know which commands share this documentation, a
> suitable "grep" invocation will provide the same information but will
> be correct at that point in time, whereas a comment like this one can
> become stale over time.