X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=scm%2Fdocument-markup.scm;h=cffdf2afda238cac9da1d14a85db6ac3efa1c6d5;hb=b7af9cadbecca6f3a9eb7cae32fcf9d72b5ca1e7;hp=9a5e51eb19e7ec53349febb59f85747f70300b2e;hpb=0f224ac096e1285d91fcea83ec8368c18ef5cf9c;p=lilypond.git

diff --git a/scm/document-markup.scm b/scm/document-markup.scm
index 9a5e51eb19..cffdf2afda 100644
--- a/scm/document-markup.scm
+++ b/scm/document-markup.scm
@@ -2,51 +2,113 @@
 ;;;;
 ;;;;  source file of the GNU LilyPond music typesetter
 ;;;; 
-;;;; (c) 1998--2006 Han-Wen Nienhuys <hanwen@xs4all.nl>
+;;;; (c) 1998--2007 Han-Wen Nienhuys <hanwen@xs4all.nl>
 ;;;;                 Jan Nieuwenhuizen <janneke@gnu.org>
 
+
+(define (doc-markup-function-properties func)
+  (let ((properties (hashq-ref markup-functions-properties func))
+        (prop-strings (list)))
+    (for-each (lambda (prop-spec)
+                (set! prop-strings
+                      (if (list? prop-spec)
+                          ;; either (prop value) or (prop)
+                          (cons (if (null? (cdr prop-spec))
+                                    (format #f "@item @code{~a}\n" (car prop-spec))
+                                    (format #f "@item @code{~a} (~a)\n"
+                                            (car prop-spec)
+                                            (let ((default (cadr prop-spec)))
+                                              (if (and (list? default)
+                                                       (null? default))
+                                                  "'()"
+                                                  default))))
+                                prop-strings)
+                          ;; a markup command: get its properties
+                          ;; FIXME: avoid cyclical references
+                          (append (doc-markup-function-properties prop-spec)
+                                  prop-strings))))
+              (or properties (list)))
+    prop-strings))
+
 (define (doc-markup-function func)
   (let* ((doc-str  (procedure-documentation func))
-	 (f-name (symbol->string (procedure-name  func)))
-	 (c-name (regexp-substitute/global #f "-markup$" f-name  'pre "" 'post))
-	 (sig (object-property func 'markup-signature))
-	 (arg-names
-	  (map symbol->string 
-	       (cddr (cadr (procedure-source func)))))
-	 
-	 (sig-type-names (map type-name sig))
-	 (signature-str
-	  (string-join
-	   (map (lambda (x) (string-append
-			     "@var{" (car x) "} ("  (cadr x) ")" ))
-		(zip arg-names  sig-type-names))
-	   " " )))
+         (f-name (symbol->string (procedure-name  func)))
+         (c-name (regexp-substitute/global #f "-markup(-list)?$" f-name  'pre "" 'post))
+         (sig (object-property func 'markup-signature))
+         (arg-names (let ((arg-list (cadr (procedure-source func))))
+                      (if (list? arg-list)
+                          (map symbol->string (cddr arg-list))
+                          (make-list (length sig) "arg"))))
+         (sig-type-names (map type-name sig))
+         (signature-str
+          (string-join
+           (map (lambda (x) (string-append
+                             "@var{" (car x) "} ("  (cadr x) ")" ))
+                (zip arg-names  sig-type-names))
+           " " )))
     
     (string-append
      "\n\n@item @code{\\" c-name "} " signature-str
-     
-     "\n@findex " f-name "\n"
-     "\n@cindex @code{" c-name "}\n"
+     "\n@findex \\" f-name "\n"
      
      (if (string? doc-str)
-	 doc-str
-	 ""))))
+         doc-str
+         "")
+     (let ((prop-strings (doc-markup-function-properties func)))
+       (if (null? prop-strings)
+           "\n"
+           (string-append "\n\n\nUsed properties:\n@itemize\n"
+                          (apply string-append prop-strings)
+                          "@end itemize\n"))))))
 
 (define (markup-function<? a b)
   (string<? (symbol->string (procedure-name a)) (symbol->string (procedure-name b))))
+ 
+(define (markup-category-doc-node category)
+  (let* ((category-string (symbol->string category))
+         (match (string-match "-" category-string))
+         (category-name (string-capitalize
+                         (if match
+                             (regexp-substitute #f match 'pre " " 'post)
+                             category-string)))
+        (markup-functions (hashq-ref markup-functions-by-category
+                                          category)))
+    (make <texi-node>
+      #:name category-name
+      #:desc ""
+      #:text (string-append
+              "@table @asis"
+              (apply string-append
+                     (map doc-markup-function
+                          (sort markup-functions markup-function<?)))
+              "\n@end table"))))
 
-(define (markup-doc-string)
+(define (markup-list-doc-string)
   (string-append
-   
    "@table @asis"
    (apply string-append
-	  
-	  (map doc-markup-function
-	       (sort markup-function-list markup-function<?)))
+          (map doc-markup-function
+               (sort markup-list-function-list markup-function<?)))
    "\n@end table"))
 
 (define (markup-doc-node)
   (make <texi-node>
-    #:name "Markup functions"
-    #:desc "Definitions of the markup functions."
-    #:text (markup-doc-string)))
+    #:name "Text markup commands"
+    #:desc ""
+    #:text "The following commands can all be used inside @code{\\markup @{ @}}."
+    #:children (let ((categories (sort (hash-fold (lambda (category function+properties categories)
+                                                    (cons category categories))
+                                                  (list)
+                                                  markup-functions-by-category)
+                                       (lambda (c1 c2)
+                                         (string<? (symbol->string c1)
+                                                   (symbol->string c2))))))
+                 (map markup-category-doc-node categories))))
+
+(define (markup-list-doc-node)
+  (make <texi-node>
+    #:name "Text markup list commands"
+    #:desc ""
+    #:text (string-append
+            "The following commands can all be used with @code{\\markuplines}.\n"
+            (markup-list-doc-string))))