]> git.donarmstrong.com Git - lilypond.git/commit
Issue 4121/2: Store markup command argument list names in docstring
authorDavid Kastrup <dak@gnu.org>
Sat, 20 Sep 2014 17:57:38 +0000 (19:57 +0200)
committerDavid Kastrup <dak@gnu.org>
Wed, 24 Sep 2014 13:45:40 +0000 (15:45 +0200)
commit0fe36c1225b6060ef0431089d41fde5cc6bab3ce
treee78d3e2f9ba7addbc615d285509f6f725028723d
parent8aa5e3c7392cc29515c55d57a0bf0e6da8dc03ce
Issue 4121/2: Store markup command argument list names in docstring

For one thing, the doc string does not make a lot of sense without the
argument list and it cannot reliably be deduced from the doc string
itself.

For another, GUILEv2 does not do us the favor of storing the original
argument list anywhere where it could be retrieved with a useful amount
of labor.

While it would be nice to put the types of the arguments into the doc
string as well, the signature's actual predicates are only evaluated
after macro expansion and that is too late for generating the doc
string.

So we just stick the argument list (after uncurrying) as a line at the
top.
scm/document-markup.scm
scm/markup-macros.scm