]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/user/invoking.itely
*** empty log message ***
[lilypond.git] / Documentation / user / invoking.itely
index b03c966f9029ce2255a9a5c87ea4838233d02592..39cb70009f0dcc299b7f987f7df52be7b5a6b0f4 100644 (file)
@@ -82,7 +82,7 @@ extents of strings of text.
 @file{EPS} file, without fonts, and as one collated @file{EPS} file with
 all pages (systems) including fonts.
 
-This mode  is used by default by lilypond-book.
+This mode is used by default by lilypond-book.
 
 @item svg
  for SVG (Scalable Vector Graphics)
@@ -94,6 +94,21 @@ This mode  is used by default by lilypond-book.
  
 @cindex output format, setting
 
+@item -d,--define-default=@var{var}=@var{val}
+This defines an internal variable @var{var} as the Scheme value
+@var{val}.
+
+Supported values include:
+@table @code
+@item resolution
+set PNG resolution
+@item preview-include-book-title
+include book-titles in preview
+@end table
+
+These settings are returned when calling
+@code{(ly:get-option 'command-line-settings)} from Scheme.
+
 @item -h,--help
 Show a summary of usage.
 
@@ -216,15 +231,6 @@ real root filesystem.  The entire content of the LilyPond installation
 (e.g., @file{/usr/share/lilypond})
 should be copied.
 
-@ignore
-FIXME:  fact-check; delete very soon.  -gp
-, and the content of the @file{fonts},
-@file{dvips} and @file{web2c} directories of the @TeX{} installation
-(usually under @file{/usr/share/texmf}) should be copied, too.  If your
-@TeX{} installation uses @file{ls-R} caches, copy also the cache inside the root
-of the installation.
-@end ignore
-
 If problems arise, the simplest way to trace them down is to run
 LilyPond using @command{strace}, which will allow you to determine which
 files are missing.
@@ -256,6 +262,7 @@ Show the warranty with which GNU LilyPond comes. (It comes with
 
 @section Environment variables
 
+@ignore
 For processing both the @TeX{} and the PostScript output, the
 appropriate environment variables must be set.  The following scripts
 do this:
@@ -300,12 +307,17 @@ file tree.  A typical setting would be
 
 @end table
 
-
 @cindex PostScript
 @cindex TEXMF
 @cindex printing postscript
 
-The binary itself recognizes the following environment variables:
+@end ignore
+
+
+@cindex LANG
+@cindex LILYPONDPREFIX
+
+@code{Lilypond} recognizes the following environment variables:
 @table @code
 @item LILYPONDPREFIX
 This specifies a directory where locale messages and
@@ -316,8 +328,6 @@ subdirectories called @file{ly/}, @file{ps/}, @file{tex/}, etc.
 This selects the language for the warning messages.
 @end table
 
-@cindex LANG
-@cindex LILYPONDPREFIX
 
 @node Error messages
 @section Error messages
@@ -409,7 +419,7 @@ version number.  In most cases, to upgrade your input file it is sufficient
 to run
 
 @example
-covert-ly -e myfile.ly
+convert-ly -e myfile.ly
 @end example
 
 If there are no changes to myfile.ly and file called myfile.ly.NEW
@@ -485,12 +495,12 @@ http://savannah.gnu.org/cgi-bin/viewcvs/*checkout*/lilypond/lily-bugs/bugs/conve
 @end ignore
 @verbatim
 
-There are a few things that the convert-ly cannot handle.  Here's a list of limitations
-that the community has complained about.
+There are a few things that the convert-ly cannot handle.  Here's a
+list of limitations that the community has complained about.
 
-This bug report structure has been chosen because convert-ly has a structure that doesn't
-allow to smoothly implement all needed changes.  Thus this is just a wishlist, placed
-here for reference.
+This bug report structure has been chosen because convert-ly has a
+structure that doesn't allow to smoothly implement all needed changes.
+Thus this is just a wishlist, placed here for reference.
 
 1.6->2.0:
  Doesn't always convert figured bass correctly, specifically things like {< >}. Mats' comment on working around this:
@@ -524,11 +534,15 @@ reproduce the problem.  Make it small, so we can easily debug the
 problem.  Don't forget to tell which version of LilyPond you use!  Send
 the report to @email{bug-lilypond@@gnu.org}.
 
+@ignore
+@c the bug database is not up to date enough. 
+
 When you've found a bug, have a look at our
-@uref{http://@/lilypond@/.org/@/doc/@/v2.3/@/bugs/,bug database} to see if
+@uref{http://@/lilypond@/.org/@/doc/@/v2.5/@/bugs/,bug database} to see if
 it has already been reported.  You could also try to do a few searches
 on the mailing list for the bug.  Sometimes the bug will have already
 been reported and a fix or workaround is already known.
+@end ignore
 
 Here is an example of a good bug report:
 
@@ -538,14 +552,14 @@ following example, the accidental touches the note head.
 
 Using Mac OSX 10.3.5, fink package lilypond-unstable
 
-\version "2.3.22"
+\version "2.5.18"
 \relative c''@{
    a4 b cis d
 @}
 @end example
 
 @lilypond[quote]
-\version "2.3.22"
+\version "2.5.18"
 \relative c''{
   \override Accidental #'extra-offset = #'(1.0 . 0)
   a4 b cis d
@@ -572,7 +586,7 @@ and syntax coloring, handy compile short-cuts and reading LilyPond
 manuals using Info.  If @file{lilypond-mode} is not installed on your
 platform, then read the
 @ifhtml
-@uref{../../../topdocs/out-www/INSTALL.html,installation instructions}.
+@uref{source/Documentation/topdocs/out-www/INSTALL.html,installation instructions}.
 @end ifhtml
 @ifnothtml
 installation instructions.
@@ -583,7 +597,7 @@ installation instructions.
 For @uref{http://@/www@/.vim@/.org,VIM}, a @file{vimrc} is supplied, along
 with syntax coloring tools.  For more information, refer to the
 @ifhtml
-@uref{../../../topdocs/out-www/INSTALL.html,installation instructions}.
+@uref{source/Documentation/topdocs/out-www/INSTALL.html,installation instructions}.
 @end ifhtml
 @ifnothtml
 installation instructions.
@@ -592,7 +606,7 @@ installation instructions.
 
 @item JEdit
 
-The @uref{http://@/www@/.jedit@/.org/,jEdit} editor has a LilyPond plugin.
+The @uref{http://@/www@/.jedit@/.org@/,jEdit} editor has a LilyPond plugin.
 This plugin includes a DVI viewer, integrated help and viewing via
 GhostScript.  It can be installed by doing @key{Plugins > Plugin
 Manager}, and selecting @code{LilyTool} from the @key{Install} tab.