Patch for my bit of Frogs Task 1

[Ian Hulin]

(Apolgoes to the list for this coming late, I'm sorting out my subscription via
gmane) 

Hi Carl,

Here's a patch for ny bit of the first Frogs Task, but I've got some questions.
I've noticed that music-functions-init.ly is supposed to be alphabetical, but
several are out of order (e.g. pageBreak followed by noPageBreak because they've
been grouped by function).
Also the updated lyric-handling functions are not there (addlyrics, lyricsto,
lyricmode).  I've put a TODO comment in about this in the file, but are there
any other files the build uses as a source for documentation streams that I need
to add doc strings to?

I've also attached a small example of using mapMusic to use different
articulation styles for a passage of music - any use as an LSR snippet?

Cheers,

Ian Hulin



Author: Ian Hulin <address@hidden>  2009-01-09 16:16:40
Committer: Ian Hulin <address@hidden>  2009-01-09 16:16:40
Parent: 4e0f54f94babca93881e1510865c3e7237ecee0d (Change example for fret
diagrams to show opposing-landscape)
Branch: FrogsIanHulin
Follows: release/2.12.1-1
Precedes: 

    Frogs Task 1 - add documentation strings for functions \musicMap to 
\pageBreak

-------------------------- ly/music-functions-init.ly --------------------------
index a112b67..5dc2d5a 100644
@@ -340,13 +340,23 @@ makeClusters =
 
 musicMap =
 #(define-music-function (parser location proc mus) (procedure? ly:music?)
+(_i "Apply a function operating on a single piece of music to an entire music
expression.
+ Usage: @var{proc} The function must be a procedure written in Scheme.  
+        @var{mus} The music expression to which @var{proc} is to be applied.
+       The scheme function will be applied  to each item in the music 
expression.
+ The function could be used, for example, to apply a series of different
articulations 
+ to a repeated section of music" )
             (music-map proc mus))
-
-
-
+%
+% TODO Ensure that entries are generated for \addlyrics, \lyricmode \lyricsto
+%      and other lyrics functions
+%
 oldaddlyrics =
 #(define-music-function (parser location music lyrics) (ly:music? ly:music?)
-
+(_i "Obsolete function @code{oldaddlyrics} @var(lyrics) was used to add a 
block 
+    of lyrics text to a music expression.
+    Please use @code(addlyrics) @var{lyrics} or @code{lyricsto} and 
+    @code{lyricmode) instead.")
               (make-music 'OldLyricCombineMusic 
                           'origin location
                           'elements (list music lyrics)))