From: Graham Percival <graham@percival-music.ca>
Date: Wed, 5 Aug 2009 06:49:04 +0000 (-0700)
Subject: Doc: structure of LM 1.
X-Git-Tag: release/2.13.4-1~202
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=f37ac364bc2219c86df7b285e5cef7d50e69e071;p=lilypond.git

Doc: structure of LM 1.
---

diff --git a/Documentation/learning/generating.itely b/Documentation/learning/generating.itely
index 04541dd3fd..abe47d67bc 100644
--- a/Documentation/learning/generating.itely
+++ b/Documentation/learning/generating.itely
@@ -16,7 +16,7 @@ This chapter gives a basic introduction to working with LilyPond.
 
 @menu
 * Compiling a file::            
-* Alternate editors::           
+* Advanced editors::            
 * How to write input files::    
 * How to read the manuals::     
 @end menu
@@ -97,7 +97,7 @@ view or print the output.
 
 Note that there are several other text editors available with
 better support for LilyPond.  For more information, see
-@ref{Alternate editors}.
+@ref{Advanced editors}.
 
 @warning{The first time you ever run LilyPond, it may take a
 minute or two because all of the system fonts have to be analyzed
@@ -181,14 +181,51 @@ Converting to `test.pdf'...
 
 
 
-@node Alternate editors
-@section Alternate editors
+@node Advanced editors
+@section Advanced editors
+
+FIXME: add text
+
+@menu
+* Denemo::                      
+* LilyPondTool::                
+* Emacs::                       
+* Vim::                         
+@end menu
+
+
+@node Denemo
+@subsection Denemo
+
+Available on:
+
+
+
+@node LilyPondTool
+@subsection LilyPondTool
+
+Available on:
+
+
+@node Emacs
+@subsection Emacs
+
+Available on: Windows, MacOS X, Unix
+
+
+@node Vim
+@subsection Vim
+
+Available on: Windows, MacOS X, Unix
+
 
 
 
 @node How to write input files
 @section How to write input files
 
+FIXME: insert text
+
 @menu
 * Simple notation::             
 * Working on input files::      
@@ -581,6 +618,19 @@ comments:
 @node How to read the manuals
 @section How to read the manuals
 
+FIXME: fluff here
+
+@menu
+* Omitting braces::             
+* Clickable examples::          
+* Overview of manuals::         
+@end menu
+
+
+@node Omitting braces
+@unnumberedsubsec Omitting braces
+
+
 @cindex how to read the manual
 @cindex manual, reading
 @cindex reading the manual
@@ -615,7 +665,8 @@ own.  Most people want to add material to an existing piece, so we
 format the manual this way.
 
 
-@subheading Clickable examples
+@node Clickable examples
+@unnumberedsubsec Clickable examples
 
 Many people learn programs by trying and fiddling around with the
 program.  This is also possible with LilyPond.  If you click on a
@@ -636,12 +687,12 @@ same output (line-width and all), copy everything from @qq{Start
 cut-&-pastable section} to the bottom of the file.
 
 
-@seealso
-There are more tips for constructing input files in
-@ref{Suggestions for writing LilyPond input files}.  But it might be
-best to read through the rest of the tutorial first.
-
 
+@node Overview of manuals
+@unnumberedsubsec Overview of manuals
 
+FIXME: a brief discussion about the rest of the LM, and pointers
+to specific places.  like NR for general reference, AU for
+suggestions for writing files, etc.