X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=scm%2Fdocumentation-generate.scm;h=6219ce53c3f3a0de56b2ad3f8ff3d26a4f190f7b;hb=ece2e45d587f63565e81af44e1937ebe1f5e47a8;hp=1650bf1b96329de267e15aafccf3f63b9cc374ee;hpb=510e58fb7b680bde0388c893d46c1030debcf252;p=lilypond.git diff --git a/scm/documentation-generate.scm b/scm/documentation-generate.scm index 1650bf1b96..6219ce53c3 100644 --- a/scm/documentation-generate.scm +++ b/scm/documentation-generate.scm @@ -1,29 +1,28 @@ -;;; generate-documentation.scm -- Generate documentation -;;; -;;; source file of the GNU LilyPond music typesetter -;;; -;;; (c) 2000--2004 Han-Wen Nienhuys -;;; Jan Nieuwenhuizen +;;;; generate-documentation.scm -- Generate documentation +;;;; +;;;; source file of the GNU LilyPond music typesetter +;;;; +;;;; (c) 2000--2007 Han-Wen Nienhuys +;;;; Jan Nieuwenhuizen ;;; File entry point for generated documentation - ;;; Running LilyPond on this file generates the documentation -;(set-debug-cell-accesses! 5000) +;;(set-debug-cell-accesses! 5000) ;;;;;;;;;;;;;;;; ;;;;;;;;;;;;;;;; TODO : make modules of these! ;;;;;;;;;;;;;;;; -; todo: naming: grob vs. layout property +;; todo: naming: grob vs. layout property (map ly:load '("documentation-lib.scm" "document-functions.scm" "document-translation.scm" "document-music.scm" + "document-identifiers.scm" "document-backend.scm" - "document-markup.scm" - )) + "document-markup.scm")) ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; @@ -35,97 +34,110 @@ (markup-doc-string) (open-output-file "markup-commands.tely")) +(display + (markup-list-doc-string) + (open-output-file "markup-list-commands.tely")) + +(display + (identifiers-doc-string) + (open-output-file "identifiers.tely")) + (display (backend-properties-doc-string all-user-grob-properties) - (open-output-file "layout-properties.tely") ) + (open-output-file "layout-properties.tely")) (display (translation-properties-doc-string all-user-translation-properties) - (open-output-file "context-properties.tely") ) -;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; + (open-output-file "context-properties.tely")) +;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; (define file-name "lilypond-internals") (define outname (string-append file-name ".texi")) - (define out-port (open-output-file outname)) (writing-wip outname) - - - - (display (string-append (texi-file-head "LilyPond program-reference" file-name - "(lilypond-internals.info)") + "(lilypond/lilypond-internals.info)") " +@c NOTE: This is documentation-generate.scm, not macros.itexi + + @ifhtml -@macro usermanref{NAME} -@uref{../lilypond/\\NAME\\.html,\\NAME\\} +@c ***** HTML ***** + +@macro ruser{NAME} +@ref{\\NAME\\,,,lilypond} @cindex \\NAME\\ @end macro -@end ifhtml -@ifinfo -@macro usermanref{NAME} -@ref{\\NAME\\,,,lilypond/lilypond} +@macro glossaryref{NAME} +@ref{\\NAME\\,,,music-glossary} @cindex \\NAME\\ @end macro -@end ifinfo -@iftex -@macro usermanref{NAME} -@ref{\\NAME\\}@c +@macro inputfileref{DIR,NAME} +@uref{source/\\DIR\\/out-www/collated-files.html#\\NAME\\,@file{\\DIR\\/\\NAME\\}}@c @end macro -@end iftex -@ifhtml -@macro glossaryref{NAME} -@uref{../music-glossary/\\NAME\\.html,\\NAME\\} -@cindex \\NAME\\ +@macro q{TEXT} +@html +‘\\TEXT\\’ +@end html @end macro @end ifhtml + @ifinfo +@c ***** info ***** + +@macro ruser{NAME} +@inforef{\\NAME\\,,,lilypond} +@cindex \\NAME\\ +@end macro + @macro glossaryref{NAME} @inforef{\\NAME\\,,lilypond/music-glossary} @cindex \\NAME\\ @end macro -@end ifinfo - -@macro internalsref{NAME} -@ref{\\NAME\\} +@macro inputfileref{DIR,NAME} +@file{\\DIR\\/\\NAME\\} @end macro -@ifhtml - -@macro inputfileref{DIR,NAME} -@uref{../../../../\\DIR\\/out-www/collated-files.html#\\NAME\\,@file{\\DIR\\/\\NAME\\}}@c +@macro q{TEXT} +`\\TEXT\\' @end macro +@end ifinfo -@end ifhtml -@ifinfo +@iftex +@c ***** TeX ***** -@macro inputfileref{DIR,NAME} -@file{\\DIR\\/\\NAME\\} +@macro ruser{NAME} +@ref{\\NAME\\}@c @end macro -@end ifinfo - -@iftex @macro inputfileref{DIR,NAME}@c @file{\\DIR\\/\\NAME\\}@c @end macro + +@macro q{TEXT} +`\\TEXT\\' +@end macro @end iftex +@macro internalsref{NAME} +@ref{\\NAME\\} +@end macro + @ignore @omftitle LilyPond internals @@ -137,16 +149,16 @@ @end ignore -" - - - ) out-port) +") + out-port) (define top-node (make #: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 @@ -161,24 +173,11 @@ @printindex cp -@unnumbered Variable index - -@printindex vr - @unnumbered Function index @printindex fn -\n@bye" - - - ) - ))) - +\n@bye")))) (dump-node top-node out-port 0) (newline (current-error-port)) - - - -