From a0f7dd19f570fecad4e6ee3f7f17479b24acf9c4 Mon Sep 17 00:00:00 2001 From: fred Date: Tue, 26 Mar 2002 23:26:46 +0000 Subject: [PATCH] lilypond-1.3.30 --- Documentation/programs.texi | 354 ------------------------------------ 1 file changed, 354 deletions(-) delete mode 100644 Documentation/programs.texi diff --git a/Documentation/programs.texi b/Documentation/programs.texi deleted file mode 100644 index 6fecb0ea43..0000000000 --- a/Documentation/programs.texi +++ /dev/null @@ -1,354 +0,0 @@ -\input texinfo @c -*-texinfo-*- -@setfilename programs.info -@settitle Programs - -@node Top, , , (dir) -@top -@menu -* Programs:: Your Softs- -* Ly2dvi:: Python utility to convert mudela to DVI -* midi2ly:: convert MIDI to -mudela- -@end menu - - - - -@node Programs, , , Top -@chapter Programs - - - - - - - -@node Ly2dvi, , , Top -@menu -* Ly2dvi DESCRIPTION:: Ly2dvi DESCRIPTION -* Ly2dvi SYNOPSIS:: Ly2dvi SYNOPSIS -* Ly2dvi OPTIONS:: Ly2dvi OPTIONS -* Ly2dvi Features:: Ly2dvi Features -* Ly2dvi Environment:: Ly2dvi Environment -* Ly2dvi Files:: Ly2dvi Files -* Ly2dvi Initialization Sequence::Ly2dvi Initialization Sequence -* Ly2dvi See Also:: Ly2dvi See Also -* Ly2dvi Bugs:: Ly2dvi Bugs -* Ly2dvi Remarks:: Ly2dvi Remarks -* Ly2dvi Authors:: Ly2dvi Authors -@end menu -@chapter Ly2dvi - -@node Ly2dvi DESCRIPTION, , , Ly2dvi -@section DESCRIPTION -ly2dvi is a Python script which creates input file for LaTeX, -based on information from the output files from LilyPond. -The script handles multiple files. If a mudela file name is -specified LilyPond is run to make an output (TeX) file. - -One or more LaTeX 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}. - -@node Ly2dvi SYNOPSIS, , , Ly2dvi -@section SYNOPSIS - - ly2dvi [options] inputfile[.ly] [....] - -@node Ly2dvi OPTIONS, , , Ly2dvi -@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 LaTeX 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 LaTeX 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. - (@strong{-L} produces @code{\usepackage[landscape]@{article@}}) -@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 LaTeX 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 LaTeX file after the run. -@item -l,--language= - Specify LaTeX 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 LaTeX file. - With this switch all files are run separately, to produce one - DVI file for each. -@end table - -@node Ly2dvi Features, , , Ly2dvi -@section Features - -ly2dvi responds to several parameters specified in the mudela -file. They are overridden by corresponding command line options. - -@table @samp -@item language=""; - Specify LaTeX language -@item latexheaders=""; - Specify additional LaTeX 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 - -@node Ly2dvi Environment, , , Ly2dvi -@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 - -@node Ly2dvi Files, , , Ly2dvi -@section Files - -@file{titledefs.tex} is inspected for definitions used to extract -additional text definitions from the mudela 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 LaTeX language. Possible value is a valid LaTeX language. -@item LATEXHF=value -Specify additional LaTeX 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 - -@node Ly2dvi Initialization Sequence, , , Ly2dvi -@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. - -@node Ly2dvi See Also, , , Ly2dvi -@section See Also - -lilypond(1), tex(1), latex(1) - -@node Ly2dvi Bugs, , , Ly2dvi -@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 - -@node Ly2dvi Remarks, , , Ly2dvi -@section Remarks - -Many papersizes are now supported. Information on other sizes -(LaTeX 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 - -@node Ly2dvi Authors, , , Ly2dvi -@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/} - - - - - - - -@node midi2ly, , , Top -@menu -* midi2ly DESCRIPTION:: midi2ly DESCRIPTION -* midi2ly OPTIONS:: midi2ly OPTIONS -@end menu -@chapter midi2ly - -@node midi2ly DESCRIPTION, , , 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 - -@node midi2ly OPTIONS, , , midi2ly -@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