Doc: adding doc strings for \...DashPattern and \harmonicBy... (1887) (issue 5019042)

[janek . lilypond]

Reviewers: ,

Message:
By Marc Hohl
http://code.google.com/p/lilypond/issues/detail?id=1887

Description:
Doc: adding doc strings for \...DashPattern and \harmonicBy...

Please review this at http://codereview.appspot.com/5019042/

Affected files:
  M ly/music-functions-init.ly
  M ly/property-init.ly


Index: ly/music-functions-init.ly
diff --git a/ly/music-functions-init.ly b/ly/music-functions-init.ly
index  
ba8aa761644c75ddd0d009e2b77335cf88e61ebe..f513be3cfecdeb67b83f78ed1af25375932cea16  
100644
--- a/ly/music-functions-init.ly
+++ b/ly/music-functions-init.ly
@@ -402,6 +402,8 @@ grace =
    (_i "Insert @var{music} as grace notes."))

 harmonicByFret = #(define-music-function (parser location fret music)  
(number? ly:music?)
+  (_i "Convert @var{music} into harmonics; the resulting notes resemble
+harmonics played on a fretted instrument by touching the strings above  
@var{fret}.")
   (let* ((fret (number->string fret))
          (pitch (fret->pitch fret)))
         (make-sequential-music
@@ -416,6 +418,9 @@ harmonicByFret = #(define-music-function (parser  
location fret music) (number? l
           #}))))

 harmonicByRatio = #(define-music-function (parser location ratio music)  
(number? ly:music?)
+    (_i "Convert @var{music} into harmonics; the resulting notes resemble
+harmonics played on a fretted instrument by touching the strings above the  
point
+given through @var{ratio}.")
   (let ((pitch (ratio->pitch ratio))
         (fret (ratio->fret ratio)))
        (make-sequential-music
Index: ly/property-init.ly
diff --git a/ly/property-init.ly b/ly/property-init.ly
index  
02acc1b4e6c50f263e44496f6ba14b6a864265ac..fe9447e09c5670d5d1faa397d8ed4c726af48f11  
100644
--- a/ly/property-init.ly
+++ b/ly/property-init.ly
@@ -307,7 +307,7 @@ phrasingSlurDashPattern =
 #(define-music-function (parser location dash-fraction dash-period)
    (number? number?)
    (_i "Set up a custom style of dash pattern for @var{dash-fraction}  
ratio of
-line to space repeated at @var{dash-period} interval.")
+line to space repeated at @var{dash-period} interval for phrasing slurs.")
   #{
      \override PhrasingSlur #'dash-definition =
        $(make-simple-dash-definition dash-fraction dash-period)
@@ -391,6 +391,8 @@ slurNeutral    = \revert Slur #'direction
 slurDashPattern =
 #(define-music-function (parser location dash-fraction dash-period)
   (number? number?)
+  (_i "Set up a custom style of dash pattern for @var{dash-fraction}
+ratio of line to space repeated at @var{dash-period} interval for slurs.")
   #{
      \override Slur #'dash-definition =
        $(make-simple-dash-definition dash-fraction dash-period)
@@ -510,6 +512,8 @@ tieNeutral = \revert Tie #'direction
 tieDashPattern =
 #(define-music-function (parser location dash-fraction dash-period)
   (number? number?)
+  (_i "Set up a custom style of dash pattern for @var{dash-fraction}
+ratio of line to space repeated at @var{dash-period} interval for ties.")
   #{
      \override Tie #'dash-definition =
        $(make-simple-dash-definition dash-fraction dash-period)