X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=scm%2Fdocument-music.scm;h=e0c9106f49d0a3e8096bf3012cce5f32808226f9;hb=a010a8e33a55d7b7c592804a2a30c90a33c9884d;hp=2e8c40f2f09ca579e61bee070e5c6b3b9981e004;hpb=5274f7944a00e046d6c980925c9188df6b82d865;p=lilypond.git diff --git a/scm/document-music.scm b/scm/document-music.scm index 2e8c40f2f0..e0c9106f49 100644 --- a/scm/document-music.scm +++ b/scm/document-music.scm @@ -1,20 +1,20 @@ ;;;; document-markup.scm -- part of generated backend documentation ;;;; ;;;; source file of the GNU LilyPond music typesetter -;;;; -;;;; (c) 1998--2006 Han-Wen Nienhuys +;;;; +;;;; (c) 1998--2007 Han-Wen Nienhuys ;;;; Jan Nieuwenhuizen (define (music-props-doc) (make #:name "Music properties" - #:desc "All music properties, including descriptions" + #:desc "All music properties, including descriptions." #:text (let* ((ps (sort (map symbol->string all-music-properties) stringtexi 'music (string->symbol prop))) ps)) - (texi (description-list->texi descs))) + (texi (description-list->texi descs #f))) texi))) (define music-types->names (make-vector 61 '())) @@ -22,13 +22,14 @@ (let* ((class (ly:camel-case->lisp-identifier (car entry))) (classes (ly:make-event-class class))) (if classes - (map (lambda (cl) - (hashq-set! music-types->names cl - (cons (car entry) - (hashq-ref music-types->names cl '())))) - classes) + (map + (lambda (cl) + (hashq-set! music-types->names cl + (cons (car entry) + (hashq-ref music-types->names cl '())))) + classes) #f))) - + music-descriptions) (define (strip-description x) @@ -36,33 +37,39 @@ "")) (define (music-type-doc entry) - (make - #:name (symbol->string (car entry)) - #:text - (string-append - "\nMusic event type @code{" - (symbol->string (car entry)) - "} is in Music objects of type " - (human-listify - (sort - (map (lambda (x) (ref-ify (symbol->string x))) - (cdr entry)) stringstring + (map ly:translator-name + (filter + (lambda (x) + (engraver-accepts-music-type? (car entry) x)) + all-engravers-list))))))) + (make + #:name (symbol->string (car entry)) + #:text + (string-append + "\nMusic event type @code{" + (symbol->string (car entry)) + "} is in music objects of type " + (human-listify + (sort + (map (lambda (x) (ref-ify (symbol->string x))) + (cdr entry)) stringstring - (map ly:translator-name - (filter - (lambda (x) (engraver-accepts-music-type? (car entry) x)) all-engravers-list))))) - "." - "\n\n"))) + "\n\n" + (if (equal? accept-list "none") + "Not accepted by any engraver or performer" + (string-append + "Accepted by: " + accept-list)) + ".")))) (define (music-types-doc) (make #:name "Music classes" - #:children + #:children (map music-type-doc (sort (hash-table->alist music-types->names) alistlisp-identifier namesym)) (classes (ly:make-event-class class)) + (accept-list (if classes + (human-listify + (map ref-ify + (map symbol->string + (map ly:translator-name + (filter + (lambda (x) + (engraver-accepts-music-types? classes x)) + all-engravers-list))))) + "")) (event-texi (if classes (string-append "\n\nEvent classes:\n" - (human-listify (map ref-ify (map symbol->string classes))) + (human-listify + (map ref-ify (map symbol->string classes))) "." - "\n\nAccepted by: " - (human-listify - (map ref-ify - (map symbol->string (map ly:translator-name - (filter - (lambda (x) (engraver-accepts-music-types? classes x)) all-engravers-list))))) + "\n\n" + (if (equal? accept-list "none") + "Not accepted by any engraver or performer" + (string-append + "Accepted by: " + accept-list)) ".") ""))) @@ -94,7 +112,8 @@ (description-list->texi (map (lambda (x) (property->texi 'music x props)) - (map car props)))))) + (map car props)) + #t)))) (define (music-object-doc obj) (make @@ -111,7 +130,7 @@ (define (music-doc-node) (make #:name "Music definitions" - #:desc "Definition of the Input data structures" + #:desc "Definition of the input data structures." #:children (list (music-expressions-doc)