[frogs] Adding docstring support to def-grace-function |
[ Thread Index |
Date Index
| More lilynet.net/frogs Archives
]
- To: frogs <frogs@xxxxxxxxxxx>
- Subject: [frogs] Adding docstring support to def-grace-function
- From: "Patrick McCarty" <pnorcks@xxxxxxxxx>
- Date: Tue, 6 Jan 2009 23:51:56 -0800
- Dkim-signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from:to :subject:mime-version:content-type:content-transfer-encoding :content-disposition; bh=YLvagiqXHh1rIALXPHVR5OfXPxyIRIXbrlPskwhgZcw=; b=kj5OxzpkIBs6gxeFMwWd9AxEjmmuHa9CMq+95J8R5JmO+3rKSSmDBZtAPc4zpqxwXu i3fxLFQKWaBwsUbo0/h3jfU/KM9lpKWTcGhx041/UIORrzPZQUTf29mbr5iDGNnrogJG GsFGPpNx+iYb0gjfBjbpsBie5nn9o8WnEvgqU=
- Domainkey-signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:to:subject:mime-version:content-type :content-transfer-encoding:content-disposition; b=D/vdUASXJ2C2hmRnWysaecSGcY+4JLiaQ5RVUJMEIAqCJkmyJNW0tRto4AgziJBsPV 0h5dSMqrrW3rMNwyxkAmM+HUkpTrl2cBPvAyQamtAthPElo4v6pVDSTNQTPOsEy+Cu15 oDqI/tvaBdxoDCJnBeJeC2bABXPQDSzI9qNKU=
Hi Frogs,
This issue was recently mentioned on the mailing list:
There are three music functions in Appendix B14 that cannot have
docstrings. These functions are:
acciaccatura
appoggiatura
grace
The reason docstrings cannot be added is because these functions are
defined *indirectly* through the def-grace-function procedure. You
can find the definition of def-grace-function in
scm/music-functions.scm.
In order to add docstrings to these three functions, we have to do two things:
A. Decide on the syntax
B. Revise the definition of def-grace-function to accomodate docstrings
For A., using acciaccatura as an example, I propose the following syntax:
acciaccatura =
#(def-grace-function (_i "add docstring") startAcciaccaturaMusic
stopAcciaccaturaMusic)
Is anyone else interested in tackling B. ? I can work on it if nobody
is interested.
Thanks,
Patrick
---
----
Join the Frogs!