X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=scm%2Fdocument-markup.scm;h=41b6f61f1baca92695c01187cce0d748016f51f7;hb=6ae36b6f8a7cf2df5f4e46c3c06820fccd9f35e1;hp=77ee9b97dce4fee30b81c818af65d53c310b1f56;hpb=0b6a02a3e81c60eec7944d3e7433ae0634c972a0;p=lilypond.git diff --git a/scm/document-markup.scm b/scm/document-markup.scm index 77ee9b97dc..41b6f61f1b 100644 --- a/scm/document-markup.scm +++ b/scm/document-markup.scm @@ -1,9 +1,20 @@ -;;;; document-markup.scm -- part of generated backend documentation +;;;; This file is part of LilyPond, the GNU music typesetter. ;;;; -;;;; source file of the GNU LilyPond music typesetter -;;;; -;;;; (c) 1998--2007 Han-Wen Nienhuys +;;;; Copyright (C) 1998--2012 Han-Wen Nienhuys ;;;; Jan Nieuwenhuizen +;;;; +;;;; LilyPond is free software: you can redistribute it and/or modify +;;;; it under the terms of the GNU General Public License as published by +;;;; the Free Software Foundation, either version 3 of the License, or +;;;; (at your option) any later version. +;;;; +;;;; LilyPond is distributed in the hope that it will be useful, +;;;; but WITHOUT ANY WARRANTY; without even the implied warranty of +;;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +;;;; GNU General Public License for more details. +;;;; +;;;; You should have received a copy of the GNU General Public License +;;;; along with LilyPond. If not, see . (define (doc-markup-function-properties func) @@ -49,8 +60,8 @@ (string-append "\n\n@item @code{\\" c-name "} " signature-str - "\n@findex \\" f-name "\n" - + "\n@funindex \\" c-name "\n" + "\n@cindex \\" c-name "\n" (if (string? doc-str) doc-str "") @@ -62,18 +73,19 @@ "@end itemize\n")))))) (define (markup-functionstring (procedure-name a)) (symbol->string (procedure-name b)))) + (ly:string-cistring (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))) + (category-name (string-capitalize (regexp-substitute/global #f + "-" category-string 'pre " " 'post))) + (markup-functions (hash-fold (lambda (markup-function dummy functions) + (cons markup-function functions)) + '() + (hashq-ref markup-functions-by-category + category)))) (make + #:appendix #t #:name category-name #:desc "" #:text (string-append @@ -83,21 +95,14 @@ (sort markup-functions markup-function + #:appendix #t #:name "Text markup commands" #:desc "" #:text "The following commands can all be used inside @code{\\markup @{ @}}." #:children (let* (;; when a new category is defined, update `ordered-categories' - (ordered-categories '(font align graphic music fret-diagram other)) + (ordered-categories '(font align graphic music instrument-specific-markup other)) (raw-categories (hash-fold (lambda (category functions categories) (cons category categories)) (list) @@ -108,10 +113,16 @@ raw-categories)))) (map markup-category-doc-node categories)))) -(define (markup-list-doc-node) - (make - #:name "Text markup list commands" - #:desc "" - #:text (string-append - "The following commands can all be used with @code{\\markuplines}.\n" - (markup-list-doc-string)))) +(define (markup-list-doc-string) + (string-append + "@table @asis" + (apply string-append + (map doc-markup-function + (sort (hash-fold (lambda (markup-list-function dummy functions) + (cons markup-list-function functions)) + '() + markup-list-functions) + markup-function