From 71e28be454525b174df8cbf9981dacd93a530a30 Mon Sep 17 00:00:00 2001
From: Trevor Daniels <t.daniels@treda.co.uk>
Date: Fri, 7 Aug 2009 22:08:37 +0100
Subject: [PATCH] Docs: make it easier to find svg, png and eps output options

 - add new subsection to NR 3.4 Controlling output
 - add index entries to these and others
---
 Documentation/application/running.itely | 32 ++++++++++++++++++++-----
 Documentation/notation/input.itely      | 15 ++++++++++++
 2 files changed, 41 insertions(+), 6 deletions(-)

diff --git a/Documentation/application/running.itely b/Documentation/application/running.itely
index b537c8b7ad..3d86a2856a 100644
--- a/Documentation/application/running.itely
+++ b/Documentation/application/running.itely
@@ -59,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
@@ -103,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
@@ -156,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
@@ -171,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.
 
@@ -222,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.
@@ -229,7 +238,9 @@ 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
@@ -242,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
@@ -252,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
@@ -280,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
@@ -290,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}.
 
diff --git a/Documentation/notation/input.itely b/Documentation/notation/input.itely
index 28c1307249..c61abbf4f6 100644
--- a/Documentation/notation/input.itely
+++ b/Documentation/notation/input.itely
@@ -1328,6 +1328,7 @@ lilypond file.ly >display.txt
 @menu
 * Extracting fragments of music::
 * Skipping corrected music::
+* Alternative output formats::
 @end menu
 
 @node Extracting fragments of music
@@ -1412,6 +1413,20 @@ been warned.
 In polyphonic music, @code{Score.skipTypesetting} will affect all
 voices and staves, saving even more time.
 
+@node Alternative output formats
+@subsection Alternative output formats
+
+@cindex scalable vector graphics output
+@cindex SVG output
+@cindex encapsulated postscript output
+@cindex EPS output
+
+The default output formats for the printed score are Portable
+Document Format (PDF) and PostScript (PS).  Scalable Vector
+Graphics (SVG), Encapsulated PostScript (EPS) and Portable
+Network Graphics (PNG) output formats are also available through
+command line options, see @rprogram{Command line options for
+lilypond}.
 
 
 @node MIDI output
-- 
2.39.5