]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/lilypond.pod
partial: 0.1.41.jcn
[lilypond.git] / Documentation / lilypond.pod
index c2d26569354600196d85ced6763d45a837a60b9f..26a6664150d5a40b5ac11abe29d02cd75d1bfd72 100644 (file)
@@ -8,9 +8,10 @@ lilypond - the GNU music typesetter
 
 =head1 DESCRIPTION
 
-GNU LilyPond is a program which converts music definition files into
-visual or auditive output: it can typeset formatted sheet music to a
-TeX file and play (mechanical) performances to MIDI files.
+LilyPond is the GNU Project music typesetter.  The program generates
+visual or auditive output from a music definition file: it can typeset 
+formatted sheet music to a TeX file and play (mechanical) performances 
+to a MIDI file.
 
 =head1 OPTIONS
 
@@ -22,7 +23,8 @@ add F<FILE> to the search path for input files.
 
 =item B<-M,--midi>
 
-do midi output only.
+This disables TeX output. If you have a \midi definition, it will do
+the midi output only.
 
 =item B<-d,--debug>,
 
@@ -30,6 +32,10 @@ Turn debugging info on.  GNU LilyPond reads the file F<.dstreamrc>,
 which lists what functions and classes may produce copious debugging
 output.
 
+=item B<-t,--test>,
+
+Switch on any experimental features.  Not for general public use.
+
 =item B<-w,--warranty>,
 
 Show the warranty with which GNU LilyPond comes. (It comes with B<NO
@@ -43,17 +49,21 @@ Set the default output file to F<FILE>.
 
 Show a summary of usage.
 
-=item B<-i,--init=>F<FILE>
+=item B<-i,--init=>F<FILE>,
+
+Set init file to F<FILE> (default: F<lily-init.ly>).
 
-set init file to F<FILE> (default: F<symbol.ly>).
+=item B<--include, -I>=F<DIRECTORY>,
 
-=item B<--include, -I>=F<DIRECTORY>
+Add F<DIRECTORY> to the search path for input files.
 
-add F<DIRECTORY> to the search path for input files.
+=item B<--ignore-version, -V>,
 
-=item B<--ignore-version, -V>
+Make incompatible mudela version non-fatal.
 
-make incompatible mudela version non-fatal.
+=item B<--postscript, -p>,
+
+Try to use PostScript where possible.
 
 =back
 
@@ -79,31 +89,31 @@ MIDI to Mudela conversion through the mi2mu program.
 
 =item *
 
-Multiple staffs in one score.  Each staff can have different meters.
+Multiple staffs in one score.  Each staff can have different meters.
 
 =item *
 
-beams, slurs, ties, chords, super/subscripts (accents and text),
+Beams, slurs, ties, chords, super/subscripts (accents and text)
 triplets, general n-plet (triplet, quadruplets, etc.), lyrics,
-transposition dynamics (both absolute and hairpin style)
+transposition dynamics (both absolute and hairpin style).
 
 =item *
 
-multiple voices within one staff; beams optionally shared
+Multiple voices within one staff; beams optionally shared
 between voices.  Up to four voices is handled cleanly.
 
 =item *
 
-multiple scores within one input file.  Each score is output to
+Multiple scores within one input file.  Each score is output to
 a different file.
 
 =item *
 
-clef changes, meter changes, cadenza-mode, key changes, repeat bars
+Clef changes, meter changes, cadenza-mode, key changes, repeat bars.
 
 =back
 
-=head1 DISCLAIMER & COPYING POLICY
+=head1 DISCLAIMER AND COPYING POLICY
 
 GNU LilyPond is copyright 1996, 1997 by its authors.  GNU LilyPond is
 distributed under the terms of the GNU General Public License.  GNU LilyPond 
@@ -139,11 +149,11 @@ general, try to find out
 
 =item *
 
-if the bug has been fixed in a newer release.  
+If the bug has been fixed in a newer release.  
 
 =item *
 
-if the bug has been found earlier, consult F<TODO> and F<BUGS>
+If the bug has been found earlier, consult F<TODO> and F<BUGS>.
 
 =back 
 
@@ -152,20 +162,20 @@ If you have found a bug, then you should send a bugreport.
 =over 4
 
 =item *
-send a copy of the input which causes the error
+Send a copy of the input which causes the error.
 
 =item *
-send a description of the platform you use
+Send a description of the platform you use.
 
 =item *
-send a description of the LilyPond version you use (with
-compile/configure options please)
+Send a description of the LilyPond version you use (with
+compile/configure options please).
 
 =item *
-send a description of the bug itself.
+Send a description of the bug itself.
 
 =item *
-send it to bug-gnu-music@vuse.vanderbilt.edu
+Send it to bug-gnu-music@gnu.org.
 
 =back
 
@@ -191,7 +201,7 @@ Than it would help if you send a dump of the Interval and the Item
 
 =over 5
 
-=item F<symbol.ly>
+=item F<lily-init.ly>
 
 The initialisation file with symbol tables etc.  It
 includes files from the directory F<init/>.
@@ -204,6 +214,8 @@ B<LILYINCLUDE> an (one) additional directory for finding lilypond data.
 
 =head1 BUGS
 
+Lots of them.  See F<TODO> and F<BUGS>
+
 =head1 SEE ALSO
 
 =over 4
@@ -235,7 +247,7 @@ LilyPond documentation
 GNU LilyPond is
 updated very frequently, the latest version is always available at:
 ftp://pcnov095.win.tue.nl/pub/lilypond and
-ftp://alpha.gnu.ai.mit.edu/gnu/lilypond/
+ftp://alpha.gnu.org/gnu/lilypond/
 
 
 For programs which are part of the GNU music project, the following
@@ -244,29 +256,29 @@ mailing list have been setup:
 
 =over 4
 
-=item info-gnu-music@vuse.vanderbilt.edu
+=item info-gnu-music@gnu.org
 
 For information on the GNU Music project, to subscribe: send mail with
-subject "subscribe" to info-gnu-music-request@vuse.vanderbilt.edu
+subject "subscribe" to info-gnu-music-request@gnu.org
 
-=item help-gnu-music@vuse.vanderbilt.edu
+=item help-gnu-music@gnu.org
 
 For help with programs from the GNU music project.  To subscribe: send
 mail with subject "subscribe" to
-help-gnu-music-request@vuse.vanderbilt.edu
+help-gnu-music-request@gnu.org
 
-=item bug-gnu-music@vuse.vanderbilt.edu
+=item bug-gnu-music@gnu.org
 
 If you have bugreports, you should send them to this list.  If you want
 to read all bugreports, you should subscribe to this list.  To
 subscribe: send mail with subject "subscribe" to
-bug-gnu-music-request@vuse.vanderbilt.edu
-       
-=item gnu-music-discuss@vuse.vanderbilt.edu,
+bug-gnu-music-request@gnu.org
+
+=item gnu-music-discuss@gnu.org,
 
 For discussions concerning the GNU Music project, to subscribe: send
 mail with subject "subscribe" to
-gnu-music-discuss-request@vuse.vanderbilt.edu,
+gnu-music-discuss-request@gnu.org,
 
 
 =back