X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=scm%2Fdocument-identifiers.scm;h=fcd8f932146181b6dc016eac3d1b9d04fbbd1796;hb=b293e2046fc5a4cedf01d602c77b55ff41376735;hp=ffccf72c30e06294902362e10ba4fc4703ac7fc5;hpb=1c846b2c2348b4e0ca4a3c2e8fb267047ba2d203;p=lilypond.git diff --git a/scm/document-identifiers.scm b/scm/document-identifiers.scm index ffccf72c30..fcd8f93214 100644 --- a/scm/document-identifiers.scm +++ b/scm/document-identifiers.scm @@ -1,6 +1,6 @@ ;;;; This file is part of LilyPond, the GNU music typesetter. ;;;; -;;;; Copyright (C) 2006--2011 Han-Wen Nienhuys +;;;; Copyright (C) 2006--2012 Han-Wen Nienhuys ;;;; ;;;; LilyPond is free software: you can redistribute it and/or modify ;;;; it under the terms of the GNU General Public License as published by @@ -26,23 +26,29 @@ (map symbol->string (cddr (cadr (procedure-source func))))) (doc (procedure-documentation func)) - (sign (object-property func 'music-function-signature)) - (type-names (map type-name sign)) - + (sign (ly:music-function-signature music-func)) + (type-names (map (lambda (pred) + (if (pair? pred) + (format #f "[~a]" (type-name (car pred))) + (format #f "(~a)" (type-name pred)))) + sign)) (signature-str (string-join - (map (lambda (x) (format "@var{~a} (~a)" - (car x) - (cadr x))) - (zip arg-names type-names))))) - (format - "@item @code{~a}~a~a -@findex ~a + (map (lambda (arg type) (format #f "@var{~a} ~a" arg type)) + arg-names (cdr type-names))))) + (format #f + "@item @code{~a} ~a ~a~a +@funindex ~a ~a " - name-sym (if (equal? "" signature-str) "" " - ") signature-str + name-sym (car type-names) + (if (equal? "" signature-str) "" " - ") signature-str name-sym - (if doc doc "(undocumented; fixme)")))) + (if doc + doc + (begin + (ly:warning "music function `~a' not documented." name-sym) + "(undocumented; fixme)"))))) (define (document-object obj-pair) @@ -52,15 +58,8 @@ (else #f))) - -(define (identifierstring (car a)) - (symbol->string (car b)))) - - (define-public (identifiers-doc-string) - (format + (format #f "@table @asis ~a @end table