X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=scm%2Fdocument-markup.scm;h=7ff76fa3f77dd188a5942c0d7f4642f9f95acef4;hb=c918b938edd83c117d4d10c1ecf3187f46efc696;hp=1db87f01b0ce479f04ff71ca31f2557beb3710b4;hpb=2086beff8cd9949318c97a2a531edb8f04f45f8c;p=lilypond.git

diff --git a/scm/document-markup.scm b/scm/document-markup.scm
index 1db87f01b0..7ff76fa3f7 100644
--- a/scm/document-markup.scm
+++ b/scm/document-markup.scm
@@ -24,13 +24,28 @@
    
   )))
 
+(define (markup-function<? a b)
+  (string<? (symbol->string (procedure-name a)) (symbol->string (procedure-name b))))
 
 (define (markup-doc-node)
   (make <texi-node>
     #:name "Markup functions"
-    #:desc "Definitions of the markup functions"
+    #:desc "Definitions of the markup functions."
+
+
     #:text (apply string-append
-		  (map doc-markup-function markup-function-list) )
+		  
+		  "A @code{\\markup} mode command, eg. @code{bold}, is
+coupled with a Scheme function (@code{bold-markup}) implementing the
+formatting.  For use in Scheme, a function @code{make-bold-markup} is
+also defined, which constructs a Markup expression.
+
+This chapter describes all of the @code{...-markup} functions.
+
+"
+
+		  (map doc-markup-function
+		       (sort markup-function-list markup-function<?) ))
     ))