From 47a9f2d21ee0f3897e21c9aaaf91c8c57821347b Mon Sep 17 00:00:00 2001
From: nsceaux <nsceaux>
Date: Wed, 10 Aug 2005 22:17:40 +0000
Subject: [PATCH] Documentation/user/programming-interface.itely (Displaying
 music expressions): doc for \displayLilyMusic. Also some precisions in
 "Markup construction in Scheme"

---
 ChangeLog                                     |  6 ++++++
 .../user/programming-interface.itely          | 21 ++++++++++++++++---
 2 files changed, 24 insertions(+), 3 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 9532c6feff..cbb02816f3 100644
--- 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 5516e55324..e3ebda08e7 100644
--- 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 ( ... )}
-- 
2.39.5