(define (all-grobs-doc)
(make <texi-node>
#:name "All layout objects"
- #:desc "Description and defaults for all Grobs"
+ #:desc "Description and defaults for all graphical objects (grobs)."
#:children
(map (lambda (x) (grob-doc (cdr x))) all-grob-descriptions)))
(define (all-interfaces-doc)
(make <texi-node>
#:name "Graphical Object Interfaces"
- #:desc "Building blocks of graphical objects"
+ #:desc "Building blocks of graphical objects."
#:children
(map interface-doc interface-description-alist)))
(define (backend-doc-node)
(make <texi-node>
#:name "Backend"
- #:desc "Reference for the layout engine"
+ #:desc "Reference for the layout engine."
#:children
(list
(all-grobs-doc)
(all-interfaces-doc)
(make <texi-node>
#:name "User backend properties"
- #:desc "All tunable properties in a big list"
+ #:desc "All tunable properties in a big list."
#:text (backend-properties-doc-string all-user-grob-properties))
(make <texi-node>
#:name "Internal backend properties"
- #:desc "All internal layout properties in a big list"
+ #:desc "All internal layout properties in a big list."
#:text (backend-properties-doc-string all-internal-grob-properties)))))
(sfdocs (sort fdocs string<?)))
(make <texi-node>
#:name "Scheme functions"
- #:desc "Primitive functions exported by LilyPond"
+ #:desc "Primitive functions exported by LilyPond."
#:text
(apply string-append sfdocs))))
(define (music-props-doc)
(make <texi-node>
#: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) string<?))
(descs (map (lambda (prop)
(string-append
"\nMusic event type @code{"
(symbol->string (car entry))
- "} is in Music objects of type "
+ "} is in music objects of type "
(human-listify
(sort
(map (lambda (x) (ref-ify (symbol->string x)))
(define (music-doc-node)
(make <texi-node>
#:name "Music definitions"
- #:desc "Definition of the Input data structures"
+ #:desc "Definition of the input data structures."
#:children
(list
(music-expressions-doc)
(make <texi-node>
#:name "Contexts"
- #:desc "Complete descriptions of all contexts"
+ #:desc "Complete descriptions of all contexts."
#:children
(map context-doc contexts))))
(define (all-engravers-doc)
(make <texi-node>
#:name "Engravers"
- #:desc "All separate engravers"
+ #:desc "All separate engravers."
#:text "See @usermanref{Modifying context plug-ins}."
#:children
(map engraver-doc all-engravers-list)))
(define (translation-doc-node)
(make <texi-node>
#:name "Translation"
- #:desc "From music to layout"
+ #:desc "From music to layout."
#:children
(list
(all-contexts-doc)
(all-engravers-doc)
(make <texi-node>
#:name "Tunable context properties"
- #:desc "All tunable context properties"
+ #:desc "All tunable context properties."
#:text (translation-properties-doc-string
all-user-translation-properties))
(make <texi-node>
#:name "Internal context properties"
- #:desc "All internal context properties"
+ #:desc "All internal context properties."
#:text (translation-properties-doc-string
all-internal-translation-properties)))))
(make <texi-node>
#:name "Top"
#:text
- (string-append "This is the program reference for LilyPond version " (lilypond-version))
+ (string-append "This is the program reference for version "
+ (lilypond-version)
+ " of LilyPond, the GNU music typesetter.")
#:children
(list