| [frogs] LSR snippets for contributors and Frogs |
[ Thread Index |
Date Index
| More lilynet.net/frogs Archives
]
- To: Mark Polesky <markpolesky@xxxxxxxxx>
- Subject: [frogs] LSR snippets for contributors and Frogs
- From: Valentin Villenave <v.villenave@xxxxxxxxx>
- Date: Fri, 24 Jul 2009 12:42:41 +0200
- Cc: Graham Percival <graham@xxxxxxxxxxxxxxxxx>, John Mandereau <john.mandereau@xxxxxxxxx>, "Carl D. Sorensen" <c_sorensen@xxxxxxx>, frogs@xxxxxxxxxxx
- Dkim-signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:received:date:message-id:subject :from:to:cc:content-type:content-transfer-encoding; bh=vPQj58jNRduxU583KQOUvrYAej6iiqH9yhMJrw4fk9I=; b=Pnj8YLKzcUe5XOkEx+ADLjOlPGXFJ+FlJptxUU/VbyeSErl7bPx/OtCtfMBxJwmUpw PhLflSViNhiwofQV62VBb53GJZlaRk03bcqrB8Ro3EN+vjB7hMkTrkuyZ6mXyT775F6b 1tDLs5Ww7PWGCL5QSSq6RiGH1uwR/DYvXjly4=
- Domainkey-signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:date:message-id:subject:from:to:cc:content-type :content-transfer-encoding; b=s2FG9ItCBVvbZQrIJ2v555C/p+Wbp0MA2QlCn6p1NSt/XW7C/NsC3aVcO9MvJH5W2t q49uSOuu13r7jSPCECOWfmaOd7+2PiqqZk2qzhG+lbxyLlNn8SlV/q5RaLlxqCluz36+ dn4r/dgGfzMvUQuDgSdq/ZcLBfsd+mxcsCEPY=
> 2009/7/24 Mark Polesky <markpolesky@xxxxxxxxx>:
>> Sometimes I wish
>> there was something like an LSRD (for developers). You know, snippets
>> showing how to trace grob-parents, how to sort objects by specific
>> properties, how to know when to use #'(0 . 1) and when to use
>> #'(-0.5 . 0.5). These sorts of things.
>>
>> What's sorely lacking in my opinion is a good reference documentation
>> for stuff like music-map, how to get a context from within a music-
>> function, the difference between ly:font-design-size and
>> ly:font-magnification, stuff like that. I'm learning all this stuff on
>> my own but it's like swimming through JELL-O. In the dark. And I think
>> there are a lot of useful functions that are totally undocumented (like
>> make-sequential-music and its kin). Sometimes I'll find stuff totally
>> accidentally, like lily-library.scm.
>
>> I think
>> there should be a "Snippets List for Developers" node on the
>> Developers resources page.
Hi everybody,
as Mark suggested, I have taken the liberty to add a new "devel" tag
to the LSR. I can rename it to "frog" or "contributors" or whatever,
but devel came to my mind first.
Although most average LilyPonders may have to copy-paste, sometimes, a
Scheme hack or something a bit complicated, I can imagine a need for
snippets that aren't useful to users at all, but could be of help to
contributors, developers or bugfixers. If you stumble upon such a
snippet, you may know tag it as "devel", and it should not be too
hard, in the future, to gather all devel-tagged snippets on a page,
for example on the developer's documentation index page, or as an
appendix to the CG?
Either way, tagging the snippets is only a first step, and does not
determine what we'll do with these snippets. So, I added the tag
already, and in the meantime we'll discuss what to do from here.
(now I'll just wait for Graham's "this is a crappy idea" reply... :-)
Regards,
Valentin
---
----
Join the Frogs!