From: John Mandereau <john.mandereau@gmail.com>
Date: Mon, 8 Dec 2008 20:26:21 +0000 (+0100)
Subject: Document 'null' as supported backend
X-Git-Tag: release/2.12.0-1~13^2~34
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=98797fc60f299f8e84d9719cef45c2db4131532b;p=lilypond.git

Document 'null' as supported backend

Also move @cindex entries to correct places.
---

diff --git a/Documentation/user/running.itely b/Documentation/user/running.itely
index 32c9bb49c8..1addc89ab8 100644
--- a/Documentation/user/running.itely
+++ b/Documentation/user/running.itely
@@ -208,12 +208,13 @@ The safe mode will prevent many useful LilyPond snippets from being
 compiled.  The @code{--jail} is a more secure alternative, but
 requires more work to set up.
 
+@cindex output format, setting
 @item backend
 the output format to use for the back-end.  Choices for @code{format} are
 @table @code
 @item ps
- for PostScript.
 @cindex PostScript output
+ for PostScript.
 
   Postscript files include TTF, Type1 and OTF fonts.  No subsetting of
   these fonts is done.  When using oriental character sets, this can
@@ -227,23 +228,24 @@ 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 dumps every page as a separate
 @file{SVG} file, with embedded fonts.
-@cindex SVG (Scalable Vector Graphics)
   You need a SVG viewer which supports embedded fonts, or a SVG
   viewer which is able to replace the embedded fonts with OTF fonts.
   Under UNIX, you may use @uref{http://www.inkscape.org,Inkscape}
   (version 0.42 or later), after copying the OTF fonts from the LilyPond directory
   (typically @file{/usr/share/lilypond/VERSION/fonts/otf/}) to @file{~/.fonts/}.
 @item scm
- for a dump of the raw, internal Scheme-based drawing commands.
 @cindex Scheme dump
+ for a dump of the raw, internal Scheme-based drawing commands.
+
+@item null
+ do not output a printed score; has the same effect as @code{-dno-print-pages}.
 @end table
 
 Example: @code{lilypond -dbackend=svg @var{filename}.ly}
 
-@cindex output format, setting
-
 @item preview
 Generate an output file containing the titles and the first system
 
diff --git a/scm/lily.scm b/scm/lily.scm
index 7122ac3694..bddb9982a7 100644
--- a/scm/lily.scm
+++ b/scm/lily.scm
@@ -31,7 +31,7 @@
     ;; - [subject-]-verb-object-object
 
     (anti-alias-factor 1 "render at higher resolution and scale down result\nto prevent jaggies in PNG")
-    (backend ps "which backend to use by default; Options: eps, ps [default], scm, svg)")
+    (backend ps "which backend to use by default; Options: eps, null, ps [default], scm, svg)")
     (check-internal-types #f "check every property assignment for types")
     (clip-systems #f "Generate cut-out snippets of a score")
     (datadir #f "LilyPond prefix for data files (Readonly).")