Documentation/user/programming-interface.itely (Displaying music

expressions): doc for \displayLilyMusic. Also some precisions in
"Markup construction in Scheme"

diff --git a/ChangeLog b/ChangeLog
index 9532c6feff8e9c77ebe61828331a18132933d885..cbb02816f363128a71865edec2db47da1e57bc29 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2005-08-10  Nicolas Sceaux  <nicolas.sceaux@free.fr>
+
+       * Documentation/user/programming-interface.itely (Displaying music
+       expressions): doc for \displayLilyMusic. Also some precisions in
+       "Markup construction in Scheme"
+
 2005-08-10  Mats Bengtsson  <mabe@drongo.s3.kth.se>
 
        * scm/define-markup-commands.scm (normal-text): Added 2 new

diff --git a/Documentation/user/programming-interface.itely b/Documentation/user/programming-interface.itely
index 5516e5532449b49bcc1d010f344b326289260811..e3ebda08e75efc82e25c6e4e9b43f94a113a90af 100644 (file)
--- a/Documentation/user/programming-interface.itely
+++ b/Documentation/user/programming-interface.itely
@@ -315,6 +315,7 @@ exporting LilyPond input to other formats
 
 @cindex internal storage
 @cindex @code{\displayMusic}
+@cindex @code{\displayLilyMusic}
 
 When writing a music function, it is often instructive to inspect how
 a music expression is stored internally.  This can be done with the
@@ -322,10 +323,24 @@ music function @code{\displayMusic}.
 
 @example
 @{
-\displayMusic @{ c'4\f @}
+  \displayMusic @{ c'4\f @}
 @}
 @end example
 
+Conversely, displaying a music expression in LilyPond notation can be
+done using the music function @code{\displayLilyMusic}. For instance:
+
+@example
+@{
+  \displayLilyMusic \transpose c a, @{ c e g a bes @}
+@}
+@end example
+
+will display:
+
+@example
+@{ a, cis e fis g @}
+@end example
 
 @node Using LilyPond syntax inside Scheme
 @subsection Using LilyPond syntax inside Scheme
@@ -467,9 +482,9 @@ is this table:
 @quotation
 @multitable @columnfractions .3 .3
 @item @b{LilyPond} @tab @b{Scheme}
-@item @code{\markup @{ ... @}} @tab @code{( markup ... )}
+@item @code{\markup markup1 @}} @tab @code{(markup markup1)}
 @item @code{\markup @{ markup1 markup2 ... @}} @tab 
-        @code{(markup #:line ( markup1 markup2 ... ))}
+        @code{(markup markup1 markup2 ... )}
 @item @code{\command} @tab @code{#:command}
 @item @code{\variable} @tab @code{variable}
 @item @code{\center-align @{ ... @}} @tab @code{#:center-align ( ... )}