Docs: reorganize documentation directory structure

[lilypond.git] / scm / documentation-generate.scm

diff --git a/scm/documentation-generate.scm b/scm/documentation-generate.scm
index c8cbdd4f052ca2e577ec4a5cc68ee7157d70ca31..ac33f4f09dd4c9c17671566b228dc6d64f6ced30 100644 (file)
--- a/scm/documentation-generate.scm
+++ b/scm/documentation-generate.scm
@@ -2,7 +2,7 @@
 ;;;;
 ;;;; source file of the GNU LilyPond music typesetter
 ;;;; 
-;;;; (c) 2000--2005 Han-Wen Nienhuys <hanwen@cs.uu.nl>
+;;;; (c) 2000--2009 Han-Wen Nienhuys <hanwen@xs4all.nl>
 ;;;; Jan Nieuwenhuizen <janneke@gnu.org>
 
 ;;; File entry point for generated documentation
@@ -17,9 +17,11 @@
 ;; todo: naming: grob vs. layout property
 
 (map ly:load '("documentation-lib.scm"
+              "lily-sort.scm"
               "document-functions.scm"
               "document-translation.scm"
               "document-music.scm"
+              "document-identifiers.scm"
               "document-backend.scm"
               "document-markup.scm"))
 
@@ -29,9 +31,21 @@
  (slot-ref (all-scheme-functions-doc) 'text)
  (open-output-file "scheme-functions.tely"))
 
+;;(display 
+;; (markup-doc-string)
+;; (open-output-file "markup-commands.tely"))
+
+(call-with-output-file "markup-commands.tely"
+  (lambda (port)
+    (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)))
+
 (display 
- (markup-doc-string)
- (open-output-file "markup-commands.tely"))
+ (identifiers-doc-string)
+ (open-output-file "identifiers.tely"))
 
 
 (display
@@ -44,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))
@@ -53,72 +67,11 @@
 
 (display
  (string-append
-  (texi-file-head "LilyPond program-reference" file-name
+  (texi-file-head "LilyPond Internals Reference" file-name
                  "(lilypond-internals.info)")
   "
 
-@ifhtml
-@macro usermanref{NAME}
-@uref{../lilypond/\\NAME\\.html,\\NAME\\}
-@cindex \\NAME\\
-@end macro
-@end ifhtml
-
-@ifinfo
-@macro usermanref{NAME}
-@ref{\\NAME\\,,,lilypond/lilypond}
-@cindex \\NAME\\
-@end macro
-@end ifinfo
-
-@iftex
-@macro usermanref{NAME}
-@ref{\\NAME\\}@c
-@end macro
-@end iftex
-
-@ifhtml
-@macro glossaryref{NAME}
-@uref{../music-glossary/\\NAME\\.html,\\NAME\\}
-@cindex \\NAME\\
-@end macro
-@end ifhtml
-
-@ifinfo
-@macro glossaryref{NAME}
-@inforef{\\NAME\\,,lilypond/music-glossary}
-@cindex \\NAME\\
-@end macro
-@end ifinfo
-
-
-@macro internalsref{NAME}
-@ref{\\NAME\\}
-@end macro
-
-@ifhtml
-
-@macro inputfileref{DIR,NAME}
-@uref{../../../../\\DIR\\/out-www/collated-files.html#\\NAME\\,@file{\\DIR\\/\\NAME\\}}@c
-@end macro
-
-@end ifhtml
-
-@ifinfo
-
-@macro inputfileref{DIR,NAME}
-@file{\\DIR\\/\\NAME\\}
-@end macro
-
-@end ifinfo
-
-@iftex
-@macro inputfileref{DIR,NAME}@c
-@file{\\DIR\\/\\NAME\\}@c
-@end macro
-@end iftex
-
-
+@include macros.itexi
 
 @ignore
 @omftitle LilyPond internals
@@ -129,15 +82,52 @@
 @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 <texi-node>
-    #:name "Top"
-    #:text 
-    (string-append  "This is the program reference for LilyPond version " (lilypond-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.")
 
     #:children
     (list
@@ -146,17 +136,14 @@
      (backend-doc-node)
      (all-scheme-functions-doc)
      (make <texi-node>
-       #:name "Indexes"
+       #:appendix #t
+       #:name "Indices"
        #:text "
-@unnumbered Concept index
+@appendixsec Concept index
 
 @printindex cp
 
-@unnumbered Variable index
-
-@printindex vr
-
-@unnumbered Function index
+@appendixsec Function index
 
 @printindex fn
 
@@ -164,7 +151,3 @@
 
 (dump-node top-node out-port 0)
 (newline (current-error-port))
-
-
-
-