From: Graham Percival <graham@percival-music.ca>
Date: Sat, 26 Sep 2009 12:24:04 +0000 (+0100)
Subject: Doc: various minor reshuffling and fixes.
X-Git-Tag: release/2.13.5-0~39
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=3c5d87f50f30a7888b858410e6c5b0196cdf4163;p=lilypond.git

Doc: various minor reshuffling and fixes.
---

diff --git a/Documentation/application/lilypond-book.itely b/Documentation/application/lilypond-book.itely
index f17c6cd870..7fe3090315 100644
--- a/Documentation/application/lilypond-book.itely
+++ b/Documentation/application/lilypond-book.itely
@@ -45,13 +45,13 @@ documents.
 @cindex @LaTeX{}, music in
 
 @menu
-* An example of a musicological document::
-* Integrating music and text::
-* Music fragment options::
-* Invoking lilypond-book::
-* Filename extensions::
-* lilypond-book templates::
-* Alternate methods of mixing text and music::
+* An example of a musicological document::  
+* Integrating music and text::  
+* Music fragment options::      
+* Invoking lilypond-book::      
+* Filename extensions::         
+* lilypond-book templates::     
+* Alternate methods of mixing text and music::  
 @end menu
 
 
@@ -166,10 +166,10 @@ Larger examples can be put into a separate file, and introduced with
 Here we explain how to integrate LilyPond with various output formats.
 
 @menu
-* LaTeX::
-* Texinfo::
-* HTML::
-* DocBook::
+* LaTeX::                       
+* Texinfo::                     
+* HTML::                        
+* DocBook::                     
 @end menu
 
 @node LaTeX
@@ -986,13 +986,13 @@ message like @qq{Output would overwrite input file}.
 
 
 @node lilypond-book templates
-@appendixsec lilypond-book templates
+@section lilypond-book templates
 
 These templates are for use with @code{lilypond-book}.  If you're not familiar
 with this program, please refer to 
 @rprogram{lilypond-book}.
 
-@appendixsubsec LaTeX
+@subsection LaTeX
 
 You can include LilyPond fragments in a LaTeX document.
 
@@ -1019,7 +1019,7 @@ d4 c b a
 \end@{document@}
 @end example
 
-@appendixsubsec Texinfo
+@subsection Texinfo
 
 You can include LilyPond fragments in Texinfo; in fact, this entire manual
 is written in Texinfo.
@@ -1044,7 +1044,7 @@ d4 c b a
 @end example
 
 
-@appendixsubsec xelatex
+@subsection xelatex
 
 @verbatim
 \documentclass{article}
@@ -1106,9 +1106,9 @@ This section shows methods to integrate text and music, different than
 the automated method with @command{lilypond-book}.
 
 @menu
-* Many quotes from a large score::
-* Inserting LilyPond output into OpenOffice.org::
-* Inserting LilyPond output into other programs::
+* Many quotes from a large score::  
+* Inserting LilyPond output into OpenOffice.org::  
+* Inserting LilyPond output into other programs::  
 @end menu
 
 @node Many quotes from a large score
diff --git a/Documentation/application/running.itely b/Documentation/application/running.itely
index 1d221793e2..a112a91248 100644
--- a/Documentation/application/running.itely
+++ b/Documentation/application/running.itely
@@ -28,8 +28,10 @@ This chapter details the technicalities of running LilyPond.
 @node Normal usage
 @section Normal usage
 
-Most users run LilyPond through a GUI; see @rlearning{First steps}
-if you have not read this already.
+Most users run LilyPond through a GUI; if you have not done so
+already, read @rlearning{Introduction}.  If you use an alternate
+editor to write lilypond files, see the documentation for that
+program.
 
 
 @node Command-line usage
diff --git a/Documentation/general/manuals.itexi b/Documentation/general/manuals.itexi
index fea6a68024..8aa9679052 100644
--- a/Documentation/general/manuals.itexi
+++ b/Documentation/general/manuals.itexi
@@ -291,9 +291,10 @@ GNU info format for documentation.  FIXME, link broken.
 This book explains all the LilyPond commands which produce
 notation.
 
-@warning{The Notation assumes that the reader knows
-basic material covered in the Learning and is familiar with
-the English musical terms presented in the Musical Glossary.}
+@warning{The Notation assumes that the reader knows basic material
+covered in the Learning manual and is familiar with the English musical
+terms presented in the Musical Glossary.}
+
 @divEnd
 
 @divClass{column-right-top}
@@ -337,7 +338,7 @@ GNU info format for documentation.  FIXME, link broken.
 @unnumberedsec Usage
 
 @divClass{column-left-top}
-@subheading Learning manual
+@subheading Usage manual
 
 This book explains how to execute the programs, how to integrate
 LilyPond notation with other programs, and suggests @qq{best
@@ -386,7 +387,7 @@ GNU info format for documentation.  FIXME, link broken.
 @unnumberedsec Snippets
 
 @divClass{column-left-top}
-@subheading Learning manual
+@subheading Snippets
 
 This shows a selected set of LilyPond snippets from the
 @uref{http://lsr@/.dsi@/.unimi@/.it,LilyPond Snippet Repository}
@@ -484,7 +485,7 @@ This is explained in @@ref@{FIXME AU x.y@}.
 @unnumberedsec Changes
 
 @divClass{column-left-top}
-@subheading Learning manual
+@subheading Changes
 
 This is a summary of important changes and new features in
 LilyPond since the previous stable version.
@@ -538,7 +539,7 @@ GNU info format for documentation.  FIXME, link broken.
 @unnumberedsec Internals
 
 @divClass{column-left-top}
-@subheading Learning manual
+@subheading Internals reference
 
 This is a set of heavily cross linked HTML pages which document
 the nitty-gritty details of each and every LilyPond class, object,