.

[lilypond.git] / Documentation / user / invoking.itexi

diff --git a/Documentation/user/invoking.itexi b/Documentation/user/invoking.itexi
index 9e11df8788ea1f7a74ee5428becd427f4a0a2c9e..feaa644aafe3b72b40480284344c6560448d2b09 100644 (file)
--- a/Documentation/user/invoking.itexi
+++ b/Documentation/user/invoking.itexi
@@ -2,19 +2,31 @@
 @node Invoking LilyPond
 @chapter Invoking LilyPond
 
+This chapter details the technicalities of running LilyPond.
+
+ 
 @menu
+* Invoking the lilypond binary::  
 * Reporting bugs::              
-* Website::                     
 * Point and click::             
 * Invoking ly2dvi::             Titling LilyPond scores.
 @end menu
 
+
+
+@node Invoking the lilypond binary
+@section Invoking the lilypond binary
 @cindex Invoking LilyPond
 @cindex command line options
 @cindex options, command line
 @cindex switches
 
-Usage:
+
+The LilyPond system consists of two parts: a binary executable, which
+is responsible for the formatting functionality, and support scripts,
+which post-process the resulting output. Normally, the support scripts
+are called, which in turn invoke the @code{lilypond} binary. However,
+@code{lilypond} may be called directly as follows.
 
 @example
         lilypond [@var{option}]@dots{} @var{file}@dots{}
@@ -32,7 +44,7 @@ block, then the rest of the scores will be output in numbered files,
 starting with @file{filename-1.tex}.  Several files can be specified;
 they will each be processed independently.  @footnote{The status of
   GUILE is not reset across invocations, so be careful not to change any
-  default settings from within Scheme .}
+  default settings from within Scheme.}
 
 
 @section Command line options
@@ -96,7 +108,7 @@ web). Volunteers are welcome to do a new audit.
 @end ignore
 
 @item -v,--version
-Show version information 
+Show version information.
 @item -V,--verbose
 Be verbose: show full paths of all  files read, and give timing
 information.
@@ -187,12 +199,15 @@ This selects the language for the warning messages
 
 
 
-@cindex bugs
-@cindex reporting bugs
 
 @node Reporting bugs
 @section Reporting bugs
 
+@cindex bugs
+@cindex reporting bugs
+
+
+
 Since there is no finder's fee which doubles every year, there is no
 need to wait for the prize money to grow. Send a bug report today!
 
@@ -219,17 +234,7 @@ ly2dvi.
 
 @end itemize
 
-You can send the report to @email{bug-lilypond@@gnu.org}. This is a
-mailinglist, but you do not have to be subscribed to it to post.
-
-@node Website
-@section Website
-
-If you are reading this manual in print, it is possible that the
-website contains updates to the manual. You can find the website at
-@uref{http://www.lilypond.org/}.
-
-
+You can send the report to @email{bug-lilypond@@gnu.org}.
 
 @node Point and click
 @section Point and click
@@ -275,10 +280,11 @@ column location.
 @c move this elsewhere?
 
 There is also support for emacs: lilypond-mode for emacs provides
-indentation, autocompletion, syntax coloring, handy compile short-cuts
-and reading Info documents of lilypond inside emacs.  If lilypond-mode
-is not installed on your platform, then refer to the installation
-instructions for more information.
+keyword autocompletion, indentation, LilyPond specific parenthesis
+matching and syntax coloring, handy compile short-cuts and reading
+LilyPond manuals using Info.  If lilypond-mode is not installed on
+your platform, then refer to the installation instructions for more
+information.
 
 @cindex emacs
 @cindex emacs mode
@@ -437,7 +443,7 @@ in the files. Possible keys: @code{language}, @code{latexheaders},
 @code{pagenumber}, @code{linewidth}, @code{orientation},
 @code{textheight}.
 @item -v,--version
-Show version information .
+Show version information.
 @item -V,--verbose
 Be verbose.
 @item --debug