From a86f76455bee1bdec4c52f3c6aa9b737e9f197f7 Mon Sep 17 00:00:00 2001 From: fred Date: Wed, 27 Mar 2002 00:52:58 +0000 Subject: [PATCH] lilypond-1.3.123 --- Documentation/user/features.tely | 725 ------------------------------- Documentation/user/ly2dvi.texi | 258 ----------- Documentation/user/midi2ly.texi | 46 -- 3 files changed, 1029 deletions(-) delete mode 100644 Documentation/user/features.tely delete mode 100644 Documentation/user/ly2dvi.texi delete mode 100644 Documentation/user/midi2ly.texi diff --git a/Documentation/user/features.tely b/Documentation/user/features.tely deleted file mode 100644 index 694729a70a..0000000000 --- a/Documentation/user/features.tely +++ /dev/null @@ -1,725 +0,0 @@ -\input texinfo @c -*-texinfo-*- -@setfilename features.info -@settitle GNU LilyPond Features - -@ignore -TODO - * add more un/badly documented features - * write some text - * add to/merge with refman - - - - there's a very simple, very general noXXX mechanism; try - -noop \property Staff.VoltaBrace = #'() -yes: \property Staff.VoltaBracket = #'((meta . ((interfaces . ())))) - - - visibility? - brew_molecule? -@end ignore - - -@macro keyindex {word} -@cindex \word\ - -@end macro - -@macro indexcode {word} -@cindex \word\ - -@end macro - - - -@node Top -@chapter Features - -@menu -* Arpeggio:: Arpeggio -* Glissando:: Glissando -* Manual beam settings:: Manual beam settings -* Slur attachments:: Slur attachments -* Text spanner:: Text spanner -* Engraver hacking:: Engraver hacking -* Part combiner:: Part combiner -* Markup text:: Markup text -* Apply hacking:: Apply hacking -* Output property:: Output property -* Embedded TeX:: Embedded TeX -* Embedded PostScript:: Embedded PostScript -* Index:: Checking Feature index -@end menu - -@node Arpeggio -@section Arpeggio -@cindex argepeggio - -@cindex broken arpeggio -@c @cindex ``doorlopend'' argpeggio - -You can specify an arpeggio sign on a chord by issuing an -@c duh -@c @code{\arpeggio}@indexcode{\arpeggio} request: -@code{\arpeggio} request: -@cindex @code{\arpeggio} - -@quotation -@lilypond[fragment,relative,verbatim] - \context Voice -@end lilypond -@end quotation - -Typesetting of simultanious chords with arpeggios can be controlled with -the property @code{PianoStaff.connectArpeggios} @footnote{ FIXME: -connectArpeggios. Can't find the English terms for two kinds of -arpeggio (Dutch: gebroken arpeggio vs doorlopend arpeggio).} By -default, LilyPond prints broken arpeggios; when set to true, one -extended arpeggio sign is printed. - -@quotation -@lilypond[fragment,relative,verbatim] - \context PianoStaff < - \property PianoStaff.connectArpeggios = ##t - \context Staff \context Voice - \context Staff=other \context Voice - > -@end lilypond -@end quotation - -@node Glissando -@section Glissando -@cindex glissando - -A glissando line can be requested by issuing a -@c duh -@c @code{\glissando}@indexcode{\glissando} request: -@code{\glissando} request: -@cindex @code{\glissando} - - -@quotation -@lilypond[fragment,relative,verbatim] - c'' \glissando c' -@end lilypond -@end quotation - -Printing of the additional text @code{"gliss."} is currently not -supported. - - -@subsection Follow Thread -@cindex follow thread -@cindex staff switching -@cindex cross staff - -@c Documented here because it looks like a glissando. -A glissando-like line can be printed to connect notes whenever a thread -switches to another staff. This is enabled if the property -@code{PianoStaff.followThread}@indexcode{followThread} is set to true: - -@quotation -@lilypond[fragment,relative,verbatim] - \context PianoStaff < - \property PianoStaff.followThread = ##t - \context Staff \context Voice { - c'1 - \translator Staff=two - b2 a - } - \context Staff=two {\clef bass; \skip 1*2;} - > -@end lilypond -@end quotation - -@node Manual beam settings -@section Manual beam settings -@cindex beams -@cindex beam settings -@cindex manual beams - -In some cases it may be necessary to override LilyPond's automatic -beaming algorithm. For example, the auto beamer will not beam over -rests, so if you want that, specify the begin and end point manually -using @code{[}@indexcode{[} and @code{]}@indexcode{]}: - -@quotation -@lilypond[fragment,relative,verbatim] - \context Staff { - r4 [r8 g'' a] - } -@end lilypond -@end quotation - -Similarly, for beams over bar lines: - -@quotation -@lilypond[fragment,relative,verbatim] - \context Staff { - a''8 r a2 r8 [a a] - } -@end lilypond -@end quotation - -If you have specific wishes for the number of beams, you can fully -control the number of beams through the properties -@code{Voice.stemLeftBeamCount}@indexcode{stemLeftBeamCount}; - -@quotation -@lilypond[fragment,relative,verbatim] - \context Staff { - [f'8 r16 f g a] - [f8 r16 \property Voice.stemLeftBeamCount = #1 f g a] - } -@end lilypond -@end quotation - -and @code{Voice.stemRightBeamCount}@indexcode{stemRightBeamCount}: - -@quotation -@lilypond[fragment,relative,verbatim] - f'32 g a b b a g f - - \property Voice.autoBeamSettings - \set #'(end * * * *) = #(make-moment 1 4) - f32 g a b b a g f - - f32 g a - \property Voice.stemRightBeamCount = #1 b - \property Voice.stemLeftBeamCount = #1 b - a g f -@end lilypond -@end quotation - -Conventionally, stems extend to the middle staff line, and thus so do -beams. The extending of the stems can be controlled through -@code{Voice.Stem}'s grob-property -@code{no-stem-extend}@indexcode{no-stem-extend}: - -@quotation -@lilypond[fragment,relative,verbatim] - \grace a'8 a4 - \property Voice.Stem \set #'no-stem-extend = ##t - \grace g8 g4 [g8 g] -@end lilypond -@end quotation - -The beam symbol can be tweaked through @code{Voice.Beam}'s -grob-properties @code{height-hs} and @code{y-position-hs}. - -Set @code{height-hs} to zero, to get horizontal beams: - -@quotation -@lilypond[fragment,relative,verbatim] - \property Voice.Beam \set #'direction = #1 - \property Voice.Beam \set #'height-hs = #0 - [a''8 e' d c] -@end lilypond -@end quotation - -Both are in half spaces. Here's how you'd specify a weird looking beam -that instead of beaing horizontal, falls two staff spaces (ie, four half -spaces): - -@quotation -@lilypond[fragment,relative,verbatim] - \property Voice.Beam \set #'y-position-hs = #4 - \property Voice.Beam \set #'height-hs = #-4 - [c'8 c] -@end lilypond -@end quotation - -The direction of a perfectly centred beams can be -controlled through @code{Voice.Beam}'s grob-property -@code{default-neutral-direction}@indexcode{default-neutral-direction} - -@quotation -@lilypond[fragment,relative,verbatim] - [b''8 b] - \property Voice.Beam \set #'default-neutral-direction = #-1 - [b b] -@end lilypond -@end quotation - -There are several ways to calculate the direction of a beam. - -[Ross] states that the majority of the notes dictates the -direction (and not the mean of "center distance") - -But is that because it really looks better, or because he wants -to provide some real simple hands-on rules? - -We have our doubts, so we simply provide all sensible alternatives: - -@table @samp -@item majority -number count of up or down notes -@item mean -mean centre distance of all notes -@item median -mean centre distance weighted per note -@end table - -You can spot the differences of these settings from these simple -examples: - -@quotation -@lilypond[fragment,relative,verbatim] - [d''8 a] - \property Voice.Beam \set #'dir-function = #beam-dir-mean - [d a] - \property Voice.Beam \set #'dir-function = #beam-dir-median - [d a] -@end lilypond -@end quotation - -@quotation -@lilypond[fragment,relative,verbatim] - \time 3/8; - [d''8 a a] - \property Voice.Beam \set #'dir-function = #beam-dir-mean - [d a a] - \property Voice.Beam \set #'dir-function = #beam-dir-median - [d a a] -@end lilypond -@end quotation - -These beam direction functions are defined in @file{scm/beam.scm}. If -your favourite algorithm isn't one of these, you can hook up your own. - - - -@node Slur attachments -@section Slur attachments - -The ending of a slur should whenever possible be attached to a note -head. Only in some instances where beams are involved, LilyPond may -attach a slur to a stem end. In some cases, you may want to override -LilyPond's decision, eg to attach the slur to the stem end. This can be -done through @code{Voice.Slur}'s grob-property @code{attachment}: -@c FIXME: make @ref{} to backend doco - -@quotation -@lilypond[fragment,relative,verbatim] - \property Voice.Slur \set #'direction = #1 - \property Voice.Stem \set #'length = #5.5 - g''8(g)g4 - g4(g8)g - \property Voice.Slur \set #'attachment = #'(stem . stem) - g8(g)g4 - g4(g8)g -@end lilypond -*@end quotation - -Trying Before | After example... -@c Fix rolled into 4.0a prerelease - -@multitable @columnfractions .40 .40 -@item -@noindent -@lilypond[fragment,relative,verbatim] -\property Voice.Slur - \set #'direction = #1 -g''8(g)g4 -g4(g8)g -@end lilypond -@tab -@lilypond[fragment,relative,verbatim] -\property Voice.Slur - \set #'direction = #1 -\property Voice.Stem - \set #'length = #5.5 -\property Voice.Slur - \set #'attachment = #'(stem . stem) -g''8(g)g4 -g4(g8)g -@end lilypond -@end multitable - - -Similarly, slurs can be attached to note heads even when beams are -involved (aka Ophee slurs): - -@quotation -@lilypond[fragment,relative,verbatim] - \property Voice.Slur \set #'direction = #1 - \property Voice.Slur \set #'attachment = #'(head . head) - g''16()g()g()g()d'()d()d()d -@end lilypond -@end quotation - -If a slur would strike through a stem or beam, LilyPond will move the -slur away vertically (upward or downward). In some cases, this may -cause ugly slurs that you may want to correct: - -@quotation -@lilypond[fragment,relative,verbatim] - \property Voice.Stem \set #'direction = #1 - \property Voice.Slur \set #'direction = #1 - d'32( d'4 )d8.. - \property Voice.Slur \set #'attachment = #'(stem . stem) - d,32( d'4 )d8.. -@end lilypond -@end quotation - -LilyPond will increase the curvature of a slur trying to stay free of -note heads and stems. However, if the curvature would increase too much, -the slur will be reverted to its default shape. This decision is based -on @code{Voice.Slur}'s grob-property @code{beautiful} value. In some -cases, you may find ugly slurs beautiful, and tell LilyPond so by -increasing the @code{beautiful} value: - -@quotation -@lilypond[verbatim] -\score { - \notes \context PianoStaff < - \time 6/4; - \context Staff=up { s1 * 6/4 } - \context Staff=down < - \clef bass; - \autochange Staff \context Voice - \notes \relative c { - d,8( a' d f a d f d a f d )a - } - > - > - \paper { - linewidth = -1.; - \translator { - \VoiceContext - Slur \override #'beautiful = #5.0 - Slur \override #'direction = #1 - Stem \override #'direction = #-1 - autoBeamSettings \override #'(end * * * *) - = #(make-moment 1 2) - } - \translator { - \PianoStaffContext - VerticalAlignment \override #'threshold = #'(5 . 5) - } - } -} -@end lilypond -@end quotation - - -@node Text spanner -@section Text spanner - -Have crescendo set a text spanner iso hairpin -@lilypond[fragment,relative,verbatim] - \context Voice { - \property Voice.crescendoText = "cresc." - \property Voice.crescendoSpanner = #'dashed-line - a''2\mf\< a a \!a - } -@end lilypond - -@subsection Ottava - -@lilypond[fragment,relative,verbatim] - a'''' b c a - \property Voice.TextSpanner \set #'type = #'dotted-line - \property Voice.TextSpanner \set #'edge-height = #'(0 . 1.5) - \property Voice.TextSpanner \set #'edge-text = #'("8va " . "") - \property Staff.centralCPosition = #-13 - a\spanrequest \start "text" b c a \spanrequest \stop "text" -@end lilypond - - - -@node Engraver hacking -@section Engraver hacking - -No time signature, no barlines... -@lilypond[verbatim] -\score { - \notes \relative c'' { - a b c d - d c b a - } - \paper { - linewidth = -1.; - \translator { - \StaffContext - whichBar = #"" - \remove "Time_signature_engraver"; - } - } -} -@end lilypond - -No staff, no clef, squash pitches -@lilypond[verbatim] -\score { - \notes { c4 c4 c8 c8 } - \paper { - linewidth = -1.; - \translator { - \StaffContext - \remove Staff_symbol_engraver; - \consists Pitch_squash_engraver; - \remove Clef_engraver; - } - } -} -@end lilypond - - -@node Part combiner -@section Part combiner - -@lilypond[verbatim] -\score{ - \context Staff = flauti < - \time 4/4; - \context Voice=one \partcombine Voice - \context Thread=one \notes\relative c'' { - c4 d e f | b,4 d c d | r2 e4 f | c4 d e f | - c4 r e f | c4 r e f | c4 r a r | a a r a | - a2 \property Voice.soloADue = ##f a | - } - \context Thread=two \notes\relative c'' { - g4 b d f | r2 c4 d | a c c d | a4. b8 c4 d - c r e r | r2 s2 | a,4 r a r | a r r a | - a2 \property Voice.soloADue = ##f a | - } - > - \paper{ - linewidth = 80 * \staffspace; - \translator{ - \ThreadContext - \consists Rest_engraver; - } - \translator{ - \VoiceContext - \remove Rest_engraver; - } - } -} -@end lilypond - - - - -@node Markup text -@section Markup text - -Metrome hack... - - - -@lilypond[verbatim] -#(define note '(rows (music "noteheads-2" ((kern . -0.1) "flags-stem")))) -#(define eight-note `(rows ,note ((kern . -0.1) (music ((raise . 3.5) "flags-u3"))))) -#(define dotted-eight-note `(rows ,eight-note (music "dots-dot"))) - -\score { - \notes\relative c'' { - a1^#`(rows ,dotted-eight-note " = 64") - } - \paper { - linewidth = -1.; - \translator{ - \ScoreContext - TextScript \override #'font-shape = #'upright - } - } -} -@end lilypond - - -@node Output property -@section Output property - -@lilypond[fragment,relative,verbatim] - \outputproperty #(make-type-checker 'note-head-interface) - #'extra-offset = #'(2 . 3) - c''2 c -@end lilypond - -Don't move the finger 2, only text "m.d." ... -@lilypond[verbatim] -#(define (make-text-checker text) - (lambda (grob) (equal? text (ly-get-elt-property grob 'text)))) - -\score { - \notes\relative c''' { - \property Voice.Stem \set #'direction = #1 - \outputproperty #(make-text-checker "m.d.") - #'extra-offset = #'(-3.5 . -4.5) - a^2^"m.d." - } - \paper { linewidth = -1.; } -} -@end lilypond - - -@c equalizer - - -@node Apply hacking -@section Apply hacking - -@lilypond[verbatim] -music = \notes { c'4 d'4( e'4 f'4 } - -#(define (reverse-music music) - (let* ((elements (ly-get-mus-property music 'elements)) - (reversed (reverse elements)) - (span-dir (ly-get-mus-property music 'span-direction))) - - (ly-set-mus-property music 'elements reversed) - - (if (dir? span-dir) - (ly-set-mus-property music 'span-direction (- span-dir))) - - (map reverse-music reversed) - - music)) - -\score { - \context Voice { - \music - \apply #reverse-music \music - } - \paper { linewidth = -1.; } -} -@end lilypond - - -LilyPond is more flexible than some users realise. Han-Wen could be -very rich. - -Just too funny not to include. - -@example -@quotation - I've just entered a request on cosource.com : -@quotation - http://www.cosource.com/cgi-bin/cos.pl/wish/info/387 -@end quotation - Here's a copy of my feature request : -@quotation - Your task, if you accept it is to implement a \smarttranspose - command> that would translate such oddities into more natural - notations. Double accidentals should be removed, as well as #E - (-> F), bC (-> B), bF (-> E), #B (-> C). -@end quotation -@end quotation -You mean like this. (Sorry 'bout the nuked indentation.) - -Add IMPLEMENT_TYPE_P(Music, "music?"); to music.cc, and presto, done. - -That's an easy $ 100; if I'd make $ 200/hour for every hour I worked -on Lily, I'd be very rich :) -@end example - - -@lilypond[verbatim] -#(define (unhair-pitch p) - (let* ((o (pitch-octave p)) - (a (pitch-alteration p)) - (n (pitch-notename p))) - - (cond - ((and (> a 0) (or (eq? n 6) (eq? n 2))) - (set! a (- a 1)) (set! n (+ n 1))) - ((and (< a 0) (or (eq? n 0) (eq? n 3))) - (set! a (+ a 1)) (set! n (- n 1)))) - - (cond - ((eq? a 2) (set! a 0) (set! n (+ n 1))) - ((eq? a -2) (set! a 0) (set! n (- n 1)))) - - (if (< n 0) (begin (set! o (- o 1)) (set! n (+ n 7)))) - (if (> n 7) (begin (set! o (+ o 1)) (set! n (- n 7)))) - - (make-pitch o n a))) - -#(define (smart-transpose music pitch) - (let* ((es (ly-get-mus-property music 'elements)) - (e (ly-get-mus-property music 'element)) - (p (ly-get-mus-property music 'pitch)) - (body (ly-get-mus-property music 'body)) - (alts (ly-get-mus-property music 'alternatives))) - - (if (pair? es) - (ly-set-mus-property - music 'elements - (map (lambda (x) (smart-transpose x pitch)) es))) - - (if (music? alts) - (ly-set-mus-property - music 'alternatives - (smart-transpose alts pitch))) - - (if (music? body) - (ly-set-mus-property - music 'body - (smart-transpose body pitch))) - - (if (music? e) - (ly-set-mus-property - music 'element - (smart-transpose e pitch))) - - (if (pitch? p) - (begin - (set! p (unhair-pitch (Pitch::transpose p pitch))) - (ly-set-mus-property music 'pitch p))) - - music)) - - -music = \notes \relative c' { c4 d e f g a b c } - -\score { - \notes \context Staff { - \transpose ais' \music - \apply #(lambda (x) (smart-transpose x (make-pitch 0 5 1))) - \music - } - \paper { linewidth = -1.; } -} -@end lilypond - - -@node Embedded TeX -@section Embedded TeX -@lilypond[fragment,relative,verbatim] - a''^"3 $\\times$ \\`a deux" -@end lilypond - -@node Embedded PostScript -@section Embedded PostScript - -Arbitrary lines and curves not supported... - -[TODO:] Make a direct postscript command? - -@lilypond[verbatim] -\score { - \notes \relative c'' { - a-#"\\embeddedps{3 4 moveto 5 3 rlineto stroke}" - -#"\\embeddedps{ [ 0 1 ] 0 setdash 3 5 moveto 5 -3 rlineto stroke}" - b-#"\\embeddedps{3 4 moveto 0 0 1 2 8 4 20 3.5 rcurveto stroke}" - s2 - a'1 - } - \paper { linewidth = 70 * \staffspace; } -} -@end lilypond - - -@node Index -@section Checking Feature index - -@printindex cp - - -@bye - - - diff --git a/Documentation/user/ly2dvi.texi b/Documentation/user/ly2dvi.texi deleted file mode 100644 index 959802de65..0000000000 --- a/Documentation/user/ly2dvi.texi +++ /dev/null @@ -1,258 +0,0 @@ -\input texinfo @c -*-texinfo-*- -@setfilename ly2dvi.info -@settitle ly2dvi - -@chapter Ly2dvi - -@section DESCRIPTION -ly2dvi is a Python script which creates input file for La@TeX{}, -based on information from the output files from LilyPond. -The script handles multiple files. If a lilypond file name is -specified LilyPond is run to make an output (@TeX{}) file. - -One or more La@TeX{} files are created, based on information found -in the output (@TeX{}) files, and latex is finally run to create -one or more DVI files. - -The majority of this utility came from a bourne script written by Jan -Arne Fagertun name @file{ly2dvi}. - -@section SYNOPSIS - - ly2dvi [options] inputfile[.ly] [....] - - -@section OPTIONS - -@table @samp -@item -D,--debug - Set debug mode. There are two levels - in level one some debug - info is written, in level two the command @strong{set -x} is run, which - echoes every command in the ly2dvi script. -@item -F,--headers= - Name of additional La@TeX{} headers file. This is included in the - tex file at the end of the headers, last line before @code{\begin@{document@}} -@item -H,--Heigth= - Set paper heigth (points). Used together with width and La@TeX{} name of - papersize in case of papersize unknown to ly2dvi. -@item -K,--keeplilypond - Keep LilyPond output after the run. -@item -L,--landscape - Set landscape orientation - portrait is the default. - Use together with @code{dvips -t landscape} if you run dvips - separately. -@item -N,--nonumber - Switch off page numbering. -@item -O,--orientation= - Set orientation landscape - obsolete, use @strong{-L} instead. -@item -P,--postscript - In addition to the DVI file, also Generate a postsript file. -@item -W,--Width= - Set paper width (points). Used together with heigth and La@TeX{} name of - papersize in case of papersize unknown to ly2dvi. -@item -d,--dependencies - Tell lilypond to make dependencies file. -@item -h,--help - Print help. -@item -k,--keeply2dvi - Keep the La@TeX{} file after the run. -@item -l,--language= - Specify La@TeX{} language. - (@strong{-l norsk} produces @code{\usepackage[norsk]@{babel@}}). -@item -o,--output= - Set output directory. -@item -p,--papersize= - Specify papersize. - (@strong{-p a4} produces @code{\usepackage[a4paper]@{article@}}) -@item -s,--separate - Normally all output files are included into one La@TeX{} file. - With this switch all files are run separately, to produce one - DVI file for each. -@end table - - -@section Features - -ly2dvi responds to several parameters specified in the lilypond -file. They are overridden by corresponding command line options. - -@table @samp -@item language=""; - Specify La@TeX{} language -@item latexheaders=""; - Specify additional La@TeX{} headers file -@item orientation=""; - Set orientation. -@item paperlinewidth=""; - Specify the width (pt, mm or cm) of the printed lines. -@item papersize=""; - Specify name of papersize. -@end table - -@section Environment - -@table @samp -@item LILYPONDPREFIX - Sets the root directory of the LilyPond installation -@item LILYINCLUDE - Additional directories for input files. -@item TMP - Temporary directory name. Default is /tmp -@end table - -@section Files - -@file{titledefs.tex} is inspected for definitions used to extract -additional text definitions from the lilypond file. In the current -version the following are defined: - -@table @samp -@item title - The title of the music. Centered on top of the first page. -@item subtitle - Subtitle, centered below the title. -@item poet - Name of the poet, leftflushed below the below subtitle. -@item composer - Name of the composer, rightflushed below the subtitle. -@item metre - Meter string, leftflushed below the below poet. -@item opus - Name of the opus, rightflushed below the below composer. -@item arranger - Name of the arranger, rightflushed below the opus. -@item instrument - Name of the instrument, centered below the arranger -@item piece - Name of the piece, leftflushed below the instrument -@end table - -@file{$LILYPONDPREFIX/share/.lilyrc $HOME/.lilyrc ./.lilyrc} are files -to set up default running conditions. On Windows OS initialization -files are named @file{_lilyrc}. The file syntax is as follows: - -@example -VARIABLE-NAME=VALUE -@end example - - -Where @strong{VARIABLE-NAME} is the name of the variable documented below -and @strong{VALUE} is either a string, a 1, or a 0. All files are parsed, -in the shown sequence. In the current version the following are -allowed: - -@table @samp -@item DEBUG=value -This turns off (default) or on the debug capabilities. Possible -values are 0 (off) and 1 (on). -@item DEPENDENCIES=value -This turns off (default) or on the ability to generate a Makefile -dependency list. Possible values are 0 (off) and 1 (on). -@item KEEPLILYPOND=value -This turns off (default) or on the ability to keep the log file -associated with the LilyPond job. Possible values are 0 (off) and 1 -(on). -@item KEEPLY2DVI=value -This turns off (default) or on the ability to keep the temporary files -that are generated by the ly2dvi job. Possible values are 0 (off) and -1 (on) -@item LANGUAGE=value -Specify La@TeX{} language. Possible value is a valid La@TeX{} language. -@item LATEXHF=value -Specify additional La@TeX{} headers file. Possible value is a file -specification. -@item LILYINCLUDE=value -Additional directories for input files. Possible value is a delimited -directory path list. -@item LILYPONDPREFIX=value -This defines the LilyPond root directory. Possible value is a valid -directory specification to the LilyPond distribution location. -@item NONUMBER=value -This turns off (default) or on the page numbering capability. -Possible values are 0 (page numbering enabled) and 1 (page numbering -disabled). -@item ORIENTATION=value -This sets the image orientation. Possible values are -portrait (default) and landscape. -@item OUTPUTDIR=value -This defines the directory where the resultant files will be -generated. Possible value is a valid directory specification. -Default is the current working directory. -@item PAPERSIZE=value -This defines the papersize the image will be sized to fit. Possible -values are a0, a1, a2, a3, a4 (default), a5, a6, a7, a8, a9, a10, b0, -b1, b2, b3, b4, b5, archA, archB, archC, archD, archE, flsa, flse, -halfletter, ledger, legal, letter, or note. -@item PHEIGHT=value -Specify paperheight (points - an inch is 72.27, a cm is 28.453 points). -@item POSTSCRIPT=value -This turns off (default) or on the capability of additionally -generating a postscript file. Possible values are 0 (off) and 1 (on). -@item PWIDTH=value -Specify paperwidth (points - an inch is 72.27, a cm is 28.453 points). -@item SEPARATE=value -This turns off (default) or on the capability of generating multiple -dvi and postscript files from multiple source files. The default is -to generate a concatenation of the source files. Possible values are -0 (single file) and 1 (separate files). -@item TMP=value -This defines the emporary directory. Actually this is not used at the -present. Possible value is a valid directory specification that is -writable to the user. -@end table - -@section Initialization Sequence -The initialization process reads inputs for several sources. Below is -a list of priorities for lowest to hightest proirity. - -@itemize @bullet -@item Program's defaults -@item Values found in LilyPond output file -@item Environment variables -@item $LILYPONDPREFIX/share/lilypond/.lilyrc -@item $HOME/.lilyrc -@item ./.lilyrc -@item command line options -@end itemize - -Note that this differs slightly from the original bourne shell -version. - -@section See Also - -lilypond(1), tex(1), latex(1) - -@section Bugs - -If you have found a bug, you should send a bugreport. - -@itemize @bullet -@item Send a copy of the input which causes the error. -@item Send a description of the platform you use. -@item Send a description of the LilyPond and ly2dvi version you use. -@item Send a description of the bug itself. -@item Send it to @email{bug-gnu-music@@gnu.org} (you don't have to subscribe - to this mailinglist). -@end itemize - -@section Remarks - -Many papersizes are now supported. Information on other sizes -(La@TeX{} names, horizontal and vertical sizes) should be mailed to -the author or to the mailing list. - -Supported papersizes are: - -a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, archA, archB, archC, archD, -archE, b0, b1, b2, b3, b4, b5, flsa, flse, halfletter, ledger, legal, -letter, note - -@section Authors -Python Version author: -@email{daboys@@austin.rr.com, Jeffrey B. Reed}, -@uref{http://home.austin.rr.com/jbr/jeff/lilypond/} - -Original bourne shell version author: -@email{Jan.A.Fagertun@@energy.sintef.no, Jan Arne Fagertun}, -@uref{http://www.termo.unit.no/mtf/people/janaf/} - diff --git a/Documentation/user/midi2ly.texi b/Documentation/user/midi2ly.texi deleted file mode 100644 index 7a4609d436..0000000000 --- a/Documentation/user/midi2ly.texi +++ /dev/null @@ -1,46 +0,0 @@ -\input texinfo @c -*-texinfo-*- -@setfilename midi2ly.info -@settitle midi2ly - - -@chapter midi2ly - -@section DESCRIPTION -midi2ly translates a MIDI input file to Mudela (GNU LilyPond source -format). midi2ly is part of the GNU LilyPond music typesetting package. - - midi2ly [options] midi-file - -@section OPTIONS - -@table @samp -@item -b, --no-quantify, - Write exact durations, e.g.: `a4*385/384'. -@item -D, --debug, - Print lots of debugging stuff. -@item -h, --help, - Show a summary of usage. -@item -I, --include=@file{DIR}, - Add DIR to search path. -@item -k, --key=ACC[:MINOR], - Set default key. ACC > 0 sets number of sharps; ACC < 0 sets number - of flats. A minor key is indicated by ":1". -@item -n, --no-silly, - Assume no plets or double dots, assume smallest (reciprocal) duration 16. -@item -o, --output=@file{FILE}, - Set @file{FILE} as default output. -@item -p, --no-plets, - Assume no plets. -@item -q, --quiet, - Be quiet. -@item -s, --smallest=N, - Assume no shorter (reciprocal) durations than N. -@item -v, --verbose, - Be verbose. -@item -w, --warranty, - Show the warranty with which midi2ly comes. (It comes with @strong{NO WARRANTY}!) -@item -x, --no-double-dots, - Assume no double dotted notes. -@end table - -@bye -- 2.39.5