X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=scm%2Fdocumentation-generate.scm;h=09c3f35d495ce595e70d2c1f46c47ad023f93aa6;hb=3d8089a42af6304edb8dad56220e845c84832bb2;hp=d79a701bc06468d5102ed1f441e66bf8dd279815;hpb=375279298392a64be4f415b058fff88b3523540a;p=lilypond.git diff --git a/scm/documentation-generate.scm b/scm/documentation-generate.scm index d79a701bc0..09c3f35d49 100644 --- a/scm/documentation-generate.scm +++ b/scm/documentation-generate.scm @@ -1,8 +1,8 @@ -;;;; generate-documentation.scm -- Generate documentation +;;;; documentation-generate.scm -- Generate documentation ;;;; ;;;; source file of the GNU LilyPond music typesetter ;;;; -;;;; (c) 2000--2007 Han-Wen Nienhuys +;;;; (c) 2000--2009 Han-Wen Nienhuys ;;;; Jan Nieuwenhuizen ;;; File entry point for generated documentation @@ -17,6 +17,7 @@ ;; todo: naming: grob vs. layout property (map ly:load '("documentation-lib.scm" + "lily-sort.scm" "document-functions.scm" "document-translation.scm" "document-music.scm" @@ -36,11 +37,11 @@ (call-with-output-file "markup-commands.tely" (lambda (port) - (dump-node (markup-doc-node) port 2 #t))) + (dump-node (markup-doc-node) port 2))) (call-with-output-file "markup-list-commands.tely" (lambda (port) - (dump-node (markup-list-doc-node) port 2 #t))) + (dump-node (markup-list-doc-node) port 2))) (display (identifiers-doc-string) @@ -57,7 +58,7 @@ ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; -(define file-name "lilypond-internals") +(define file-name "internals") (define outname (string-append file-name ".texi")) (define out-port (open-output-file outname)) @@ -66,83 +67,11 @@ (display (string-append - (texi-file-head "LilyPond program-reference" file-name - "(lilypond/lilypond-internals.info)") + (texi-file-head "LilyPond Internals Reference" file-name + "(lilypond-internals.info)") " -@c NOTE: This is documentation-generate.scm, not macros.itexi - - -@macro q{TEXT} -@quoteleft{}\\TEXT\\@quoteright{} -@end macro - -@macro qq{TEXT} -@quotedblleft{}\\TEXT\\@quotedblright{} -@end macro - - -@ifhtml -@c ***** HTML ***** - -@ifset bigpage - -@macro ruser{TEXT} -@ref{\\TEXT\\,,,lilypond-big-page,Notation Reference} -@cindex \\TEXT\\ -@end macro - -@end ifset - -@ifclear bigpage - -@macro ruser{NAME} -@ref{\\NAME\\,,,lilypond,Notation Reference} -@cindex \\NAME\\ -@end macro - -@end ifclear - -@macro inputfileref{DIR,NAME} -@uref{source/\\DIR\\/out-www/collated-files.html#\\NAME\\,@file{\\DIR\\/\\NAME\\}}@c -@end macro - -@end ifhtml - - -@ifinfo -@c ***** info ***** - -@macro ruser{NAME} -@ref{\\NAME\\,,,lilypond,Notation Reference} -@cindex \\NAME\\ -@end macro - -@macro inputfileref{DIR,NAME} -@file{\\DIR\\/\\NAME\\} -@end macro - -@end ifinfo - - -@iftex -@c ***** TeX ***** - -@macro ruser{NAME} -@ref{\\NAME\\}@c -@end macro - -@macro inputfileref{DIR,NAME}@c -@file{\\DIR\\/\\NAME\\}@c -@end macro - -@end iftex - - -@macro rinternals{NAME} -@ref{\\NAME\\} -@end macro - +@include macros.itexi @ignore @omftitle LilyPond internals @@ -153,15 +82,50 @@ @omfcategory Applications|Publishing @end ignore +@iftex +@afourpaper +@end iftex + +@finalout + +@titlepage +@title LilyPond +@subtitle The music typesetter +@titlefont{Internals Reference} +@author The LilyPond development team + +Copyright @copyright{} 1999--2009 by the authors + +@vskip 20pt + +For LilyPond version @version{} +@end titlepage + @contents -") + +@ifnottex") out-port) (define top-node (make - #:name "Top" - #:text - (string-append "This is the program reference for version " + #:name "GNU LilyPond -- Internals Reference" + #:text + (string-append "@end ifnottex + +@ifhtml +@ifclear bigpage +This document is also available as a +@uref{source/Documentation/internals.pdf,PDF} and as +@uref{source/Documentation/internals-big-page.html,one big page}. +@end ifclear +@ifset bigpage +This document is also available as a +@uref{source/Documentation/internals.pdf,PDF} and as a +@uref{source/Documentation/internals/index.html,HTML indexed multiple pages}. +@end ifset +@end ifhtml + +This is the Internals Reference (IR) for version " (lilypond-version) " of LilyPond, the GNU music typesetter.") @@ -172,13 +136,14 @@ (backend-doc-node) (all-scheme-functions-doc) (make - #:name "Indexes" + #:appendix #t + #:name "Indices" #:text " -@unnumbered Concept index +@appendixsec Concept index @printindex cp -@unnumbered Function index +@appendixsec Function index @printindex fn