Misc updates for pitches.

[lilypond.git] / Documentation / user / setup.itely

diff --git a/Documentation/user/setup.itely b/Documentation/user/setup.itely
index 6d7bca23aa8daca06d49b295aab7614df235efc2..63599d440dc33fe7de77be7c322ac8c21c10b5bb 100644 (file)
--- a/Documentation/user/setup.itely
+++ b/Documentation/user/setup.itely
@@ -10,23 +10,34 @@
 @node Setup
 @chapter Setup
 
-This chapter discusses how to set up LilyPond to integrate with various
-programs.
+This chapter discusses various post-install configuration options for
+LilyPond and various other programs.  This chapter may be safely treated
+as a reference: only read a section if it applies to you.
 
 @menu
-* Notes for the MacOS X app::   
+* Setup for specific Operating Systems::  
 * Text editor support::         
 * Point and click::             
 @end menu
 
 
-@node Notes for the MacOS X app
-@section Notes for the MacOS X app
+@node Setup for specific Operating Systems
+@section Setup for specific Operating Systems
+
+This section explains how to perform additional setup for specific
+operating systems.
+
+@menu
+* MacOS X on the command-line::  
+@end menu
+
+
+@node MacOS X on the command-line
+@subsection MacOS X on the command-line
 
 The scripts (such as lilypond-book, convert-ly, abc2ly, and even
-lilypond itself) are also
-included inside MacOS X .app. They can be run from the command line by
-invoking them directly, e.g.
+lilypond itself) are included inside MacOS X .app.  They can be run from
+the command line by invoking them directly, e.g.
 
 @example
 @var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond
@@ -89,7 +100,7 @@ There is support from different text editors for LilyPond.
 @menu
 * Emacs mode::                  
 * Vim mode::                    
-* LilyPondTool::                
+* jEdit::                       
 * TexShop::                     
 * TextMate::                    
 @end menu
@@ -151,8 +162,8 @@ where $@{LILYPOND_VERSION@} is your lilypond version.  If Lilypond was not
 installed in @file{/usr/local/}, then change this path accordingly.
 
 
-@node LilyPondTool
-@subsection LilyPondTool
+@node jEdit
+@subsection jEdit
 
 Created as a plugin for the @uref{http://@/www@/.jedit@/.org@/,jEdit}
 text editor, LilyPondTool is the most feature-rich text-based tool for
@@ -195,7 +206,7 @@ in the PDF viewer.  This makes it easier to find input that causes
 some error in the sheet music.
 
 When this functionality is active, LilyPond adds hyperlinks to the PDF
-file. These hyperlinks are sent to the web-browser, which opens a
+file.  These hyperlinks are sent to the web-browser, which opens a
 text-editor with the cursor in the right place.
 
 To make this chain work, you should configure your PDF viewer to
@@ -211,7 +222,7 @@ urlCommand     "lilypond-invoke-editor %s"
 @end example
 
 The program @file{lilypond-invoke-editor} is a small helper
-program. It will invoke an editor for the special @code{textedit}
+program.  It will invoke an editor for the special @code{textedit}
 URIs, and run a web browser for others.  It tests the environment
 variable @code{EDITOR} for the following patterns,
 
@@ -234,10 +245,10 @@ this will invoke
 @end example
 @end table
 
-The environment variable @code{LYEDITOR} is used to override this. It
+The environment variable @code{LYEDITOR} is used to override this.  It
 contains the command line to start the editor, where @code{%(file)s},
 @code{%(column)s}, @code{%(line)s} is replaced with the file, column
-and line respectively. The  setting
+and line respectively.  The  setting
 
 @example
 emacsclient --no-wait +%(line)s:%(column)s %(file)s
@@ -250,7 +261,7 @@ invocation.
 
 @cindex file size, output
 
-The point and click links enlarge the output files significantly. For
+The point and click links enlarge the output files significantly.  For
 reducing the size of PDF and PS files, point and click may be switched
 off by issuing