6 @file{ly2dvi} is a Python script which creates input file for La@TeX{},
7 based on information from the output files from LilyPond.
8 The script handles multiple files. If a LilyPond file name is
9 specified LilyPond is run to make an output (@TeX{}) file.
11 One or more La@TeX{} files are created, based on information found
12 in the output (@TeX{}) files, and latex is finally run to create
13 one or more DVI files.
15 @subsection Invoking ly2dvi
18 ly2dvi [OPTION]... [FILE]...
21 @unnumberedsec Options
25 Keep the temporary directory including LilyPond and ly2dvi output
26 files. The temporary directory is created in the current directory as @code{ly2dvi.dir}.
27 @item -d,--dependencies
28 Write makefile dependencies for every input file.
31 @item -I,--include=@var{DIR}
32 Add @var{DIR} to LilyPond's include path.
34 Produce MIDI output only.
36 Do not run LilyPond; useful for debugging ly2dvi.
37 @item -o,--output=@var{FILE}
38 Generate output to @var{FILE}. The extension of @var{FILE} is ignored.
40 Also generate PostScript output.
41 @item -s,--set=@var{KEY}=@var{VAL}
42 Add @var{key}= @var{val} to the settings, overriding those specified
43 in the files. Possible keys: language, latexheaders, latexpackages,
44 papersize, pagenumber, linewidth, orientation, textheight.
46 Show version information
50 Show the warranty with which GNU LilyPond comes. (It comes with
51 @strong{NO WARRANTY}!)
54 @subsection Titling layout
56 Ly2dvi extracts the following header fields from the .ly files to
61 The title of the music. Centered on top of the first page.
63 Subtitle, centered below the title.
65 Name of the poet, leftflushed below the below subtitle.
67 Name of the composer, rightflushed below the subtitle.
69 Meter string, leftflushed below the below poet.
71 Name of the opus, rightflushed below the below composer.
73 Name of the arranger, rightflushed below the opus.
75 Name of the instrument, centered below the arranger
77 Name of the piece, leftflushed below the instrument
81 @subsection Additional parameters
83 Ly2dvi responds to several parameters specified in the LilyPond
84 file. They can be overridden by supplying the @code{--set} command line
89 Specify La@TeX{} language: the @code{babel} package will be
90 included. Default: unset.
92 Read from the @code{\header} block.
95 Specify additional La@TeX{} headers file.
97 Normally read from the @code{\header} block. Default value: empty
100 Specify additional La@TeX{} packages file. This works cumulative,
101 so you can add multiple packages using multiple @code{-s=latexpackages} options.
102 Normally read from the @code{\header} block. Default value:
106 Set orientation. Choices are @code{portrait} or @code{landscape}. Is
107 read from the @code{\paper} block, if set.
110 Is read from the @code{\paper} block.
113 Specify the papersize. Is read from the @code{\paper} block.
116 @subsection Environment variables
120 selects the language for the warning messages of Ly2dvi and LilyPond.
125 Assumes that @code{cp} and @code{rm} are in the path.
127 Cannot generate @TeX{} or @code{PostScript} only.
129 If find something that you consider a bug, please send a bugreport (See
130 @ref{Bug reports}) to @email{bug-gnu-music@@gnu.org}.
134 @email{hanwen@@cs.uu.nl,Han-Wen Nienhuys}.
136 Earlier incarnations of ly2dvi were written by
137 @email{daboys@@austin.rr.com, Jeffrey B. Reed} (Python version), and
138 @email{Jan.A.Fagertun@@energy.sintef.no, Jan Arne Fagertun} (Bourne