/usr/share/lilypond/2.16.2/scm/document-context-mods.scm is in lilypond-data 2.16.2-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 | ;;;; This file is part of LilyPond, the GNU music typesetter.
;;;;
;;;; Copyright (C) 2011--2012 Neil Puttock <n.puttock@gmail.com>
;;;;
;;;; 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 <http://www.gnu.org/licenses/>.
(use-modules (ice-9 format))
(define (grob-property-path path)
(string-join (map symbol->string path) " "))
(define (document-mod-list op)
(let ((tag (car op))
(name-sym (cadr op))
(args (cddr op)))
(case tag
((push)
(let ((value (car args))
(path (cdr args)))
(string-append
"@item Sets "
(format "grob property @code{~a} "
(grob-property-path path))
(format "in @code{@rinternals{~a}} to ~a."
name-sym
(scm->texi value))
"\n")))
((pop)
(string-append
"@item Reverts "
(format "grob property @code{~a} "
(grob-property-path (car args)))
(format "in @code{@rinternals{~a}}."
name-sym)
"\n"))
((assign)
(format "@item Sets translator property @code{~a} to ~a.\n"
name-sym
(scm->texi (car args))))
((unset)
(format "@item Unsets translator property @code{~a}.\n"
name-sym))
((consists)
(format "@item Adds @code{@rinternals{~a}}.\n" name-sym))
((remove)
(format "@item Removes @code{@rinternals{~a}}.\n" name-sym))
(else ""))))
(define (document-context-mod context-mod-pair)
(let* ((name-sym (car context-mod-pair))
(mod-list (ly:get-context-mods (cdr context-mod-pair)))
(docstring (filter (lambda (mod)
(eq? (car mod) 'description))
mod-list)))
(format
"@item @code{~a}
@findex ~a
~a
@itemize
~{~a ~}
@end itemize
"
name-sym
name-sym
(if (pair? docstring)
(cadar docstring)
(begin
(ly:warning "context modification `~a' not documented." name-sym)
"(undocumented; fixme)"))
(map document-mod-list mod-list))))
(define (document-mod obj-pair)
(cond
((ly:context-mod? (cdr obj-pair))
(document-context-mod obj-pair))
(else
#f)))
(define context-mods-doc-string
(format
"@table @asis
~a
@end table
"
(string-join
(filter
identity
(map
document-mod
(sort
(ly:module->alist (current-module))
identifier<?)))
"")))
|