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, latexoptions,
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
79 Line to print at the bottom of last page. Default: ``Lily was here,
80 @var{version-number}''.
84 @subsection Additional parameters
86 Ly2dvi responds to several parameters specified in the LilyPond
87 file. They can be overridden by supplying the @code{--set} command line
92 Specify La@TeX{} language: the @code{babel} package will be
93 included. Default: unset.
95 Read from the @code{\header} block.
98 Specify additional La@TeX{} headers file.
100 Normally read from the @code{\header} block. Default value: empty
103 Specify additional La@TeX{} packages file. This works cumulative,
104 so you can add multiple packages using multiple @code{-s=latexpackages} options.
105 Normally read from the @code{\header} block. Default value:
109 Specify additional options for the La@TeX{} @code{\documentclass}. You can put any valid value here. This was designed to allow ly2dvi to produce output for double-sided paper, with balanced margins and pagenumbers on alternating sides. To achieve this specify @code{twoside}
112 Set orientation. Choices are @code{portrait} or @code{landscape}. Is
113 read from the @code{\paper} block, if set.
116 Is read from the @code{\paper} block.
119 Specify the papersize. Is read from the @code{\paper} block.
122 @subsection Environment variables
126 selects the language for the warning messages of Ly2dvi and LilyPond.
131 Assumes that @code{cp} and @code{rm} are in the path.
133 Cannot generate @TeX{} or @code{PostScript} only.
135 If find something that you consider a bug, please send a bugreport (See
136 @ref{Bug reports}) to @email{bug-gnu-music@@gnu.org}.
140 @email{hanwen@@cs.uu.nl,Han-Wen Nienhuys}.
142 Earlier incarnations of ly2dvi were written by
143 @email{daboys@@austin.rr.com, Jeffrey B. Reed} (Python version), and
144 @email{Jan.A.Fagertun@@energy.sintef.no, Jan Arne Fagertun} (Bourne