Merge branch 'lilypond/translation' of ssh://jomand@git.sv.gnu.org/srv/git/lilypond

[lilypond.git] / Documentation / application / running.itely

diff --git a/Documentation/application/running.itely b/Documentation/application/running.itely
index f0b891a80f3c485260d811a88396a532455e3883..23ab331f3f776841cd60c8190baa5edb38c29ff1 100644 (file)
--- a/Documentation/application/running.itely
+++ b/Documentation/application/running.itely
@@ -43,7 +43,8 @@ By @q{command-line}, we mean the command line in the operating system.
 Windows users might be more familiar with the terms @q{DOS shell} or
 @q{command shell}; MacOS@tie{}X users might be more familiar with the terms
 @q{terminal} or @q{console}.  They should also consult 
-FIXME @c @ref{Setup for MacOS X}.
+FIXME 
+@c @ref{Setup for MacOS X}.
 
 Describing how to use this part of an operating system is outside the
 scope of this manual; please consult other documentation on this topic
@@ -58,12 +59,6 @@ if you are unfamiliar with the command-line.
 @node Invoking lilypond
 @subsection Invoking @command{lilypond}
 
-@cindex Invoking @command{lilypond}
-@cindex command line options for @command{lilypond}
-@cindex options, command line
-@cindex switches
-
-
 The @command{lilypond} executable may be called as follows from the command line.
 
 @example
@@ -102,6 +97,11 @@ will output @var{base}@file{-violin.pdf} and
 @node Command line options for lilypond
 @subsection Command line options for @command{lilypond}
 
+@cindex Invoking @command{lilypond}
+@cindex command line options for @command{lilypond}
+@cindex options, command line
+@cindex switches
+
 The following options are supported:
 
 @table @code
@@ -155,11 +155,15 @@ is the same as
 
 Here are a few interesting options.
 
+@cindex help, command line
+
 @table @samp
 @item help
 Running @code{lilypond -dhelp} will print all of the @code{-d} options
 available.
 
+@cindex paper-size, command line
+
 @item paper-size
 This option sets the default paper-size,
 @example
@@ -170,6 +174,8 @@ This option sets the default paper-size,
 Note that the string must be enclosed in escaped quotes ( @code{\"} ).
 @c Match " in previous line to help context-sensitive editors
 
+@cindex safe, command line
+
 @item safe
 Do not trust the @code{.ly} input.
 
@@ -221,6 +227,10 @@ the output format to use for the back-end.  Choices for @code{format} are
   lead to huge files.
 
 @item eps
+
+@cindex Postscript, encapulated
+@cindex EPS (Encapsulated PostScript)
+
  for encapsulated PostScript.  This dumps every page (system) as a separate
 @file{EPS} file, without fonts, and as one collated @file{EPS} file with
 all pages (systems) including fonts.
@@ -228,11 +238,13 @@ all pages (systems) including fonts.
 This mode is used by default by @command{lilypond-book}.
 
 @item svg
+
 @cindex SVG (Scalable Vector Graphics)
+
  for SVG (Scalable Vector Graphics).
 
- This creates a single SVG file containing the entire music output
- with no embedded fonts.  It is recommended to install the Century
+ This creates a single SVG file, without embedded fonts, for every
+ page of output.  It is recommended to install the Century
  Schoolbook fonts, included with your LilyPond installation, for
  optimal rendering.  Under UNIX, simply copy these fonts from the
  LilyPond directory (typically
@@ -241,7 +253,9 @@ This mode is used by default by @command{lilypond-book}.
  SVG editor or user agent.
 
 @item scm
+
 @cindex Scheme dump
+
  for a dump of the raw, internal Scheme-based drawing commands.
 
 @item null
@@ -251,6 +265,7 @@ This mode is used by default by @command{lilypond-book}.
 Example: @code{lilypond -dbackend=svg @var{filename}.ly}
 
 @item preview
+@cindex preview, command line
 Generate an output file containing the titles and the first system
 
 @item print-pages
@@ -279,9 +294,13 @@ Set init file to @var{file} (default: @file{init.ly}).
 Set the default output file to @var{FILE}.  The appropriate
 suffix will be added (e.g. @code{.pdf} for pdf)
 
+@cindex PostScript output
+
 @item --ps
 Generate PostScript.
 
+@cindex Portable Network Graphics (PNG) output
+
 @item --png
 Generate pictures of each page, in PNG format.  This implies
 @code{--ps}.  The resolution in DPI of the image may be set with
@@ -289,6 +308,8 @@ Generate pictures of each page, in PNG format.  This implies
 -dresolution=110
 @end example
 
+@cindex Portable Document Format (PDF) output
+
 @item --pdf
 Generate PDF.  This implies @code{--ps}.