.TH "LilyPond" "1" "1998" "The LilyPond package" "mudela-book" 
.PP 
.PP 
.SH "NAME" 
mudela-book \- integrate LaTeX and mudela
.PP 
.SH "SYNOPSIS" 
\fBmudela-book\fP [options] inputfile
.PP 
.SH "DESCRIPTION" 
\fBmudela-book\fP is a script that helps
integrating mudela and LaTeX\&.  mudela-book runs LilyPond on
fragments of mudela in your source file, and includes the results into
document that can be processed with LaTeX\&.  The result is a text
document with formatted music integrated\&.
.PP 
Lilypond will create a directory to put temporary files, the default
dir name is \fBout\fP\&. When you run mudela on a file, like this:
.PP 

.DS 
 
mudelab-book myfile\&.tex
.DE 
 

.PP 
the a file \fBout/myfile\&.latex\fP will be created\&. And to create
the \fB\&.dvi\fP file you should type:
.PP 

.DS 
 
latex out/myfile\&.latex
.DE 
 

.PP 
This will create \fBmyfile\&.dvi\fP in the current directory\&. Bad things
will happen if you cd to \fBout\fP and then runs 
.DS 
 
latex myfile\&.latex
.DE 
 

.PP 
\fBAbout the input\fP
.PP 
If the file contains the ``block\'\'
.PP 

.DS 
 

        \ebegin{mudela}
        CONTENTS
        \eend{mudela}

.DE 
 

.PP 
then LilyPond is run on CONTENTS\&.  mudela-book puts the result back,
surrounded by \f(CW\epreMudelaExample\fP and \f(CW\epostMudelaExample\fP
commands\&. \f(CW\epreMudelaExample\fP and \f(CWposMudelaExample\fP is
defined to nothing by default, and the user can redefine them
to whatever he wants\&.
.PP 
\f(CW\ebegin\fP takes the following options:
.PP 
.IP "floating" 
the created graphics can be inserted in the middle of a text line, 
not only as a separate paragraph
.IP "fragment" 
mudela-book adds some redtape\&. You
can substitute voice-contents for CONTENTS in this case\&.
.IP "verbatim" 
CONTENTS is copied into the TeX source enclosed in a verbatim block\&.
.IP "11pt, 13pt, 16pt, 20pt, 26pt" 
set the fontsize to use for the music
.PP 
.SH "OPTIONS" 
.PP 
.IP 
.IP "--mudela-fontsize" 
Set the fontsize to use for mudela if no fontsize is given
as option\&.
.IP "--force-mudela-fontsize" 
Force all mudela to use this fontsize, overriding options
given to \ebegin{mudela}
.IP "--outname" 
The name of  file to output\&. If this option  is not given,
the output name derived from the input name\&.
.IP "--outdir" 
The directory to output lilypond output and input to\&.
.IP "--help" 
Print a short help message
.IP "--dependencies" 
Write dependencies to outdir/filename\&.dep
.IP "--force-verbatim" 
Make all mudela verbatim\&.
.PP 
.SH "FILES" 
You have to install LaTeX\&. \fBmudela-book\fP is not tested on LaTeX 2\&.09
and will probably fail on something else than LaTeX2e\&.
.PP 
\fBmudela-book\fP is written in  python 1\&.5, so you have to install 
python\&.
.PP 
.SH "BUGS" 
.PP 
The LaTeX \eincludeonly{\&.\&.\&.} command is ignored\&.
.PP 
You get trouble if you use the --force-verbatim option and have some
music in \efootnote{\&.\&.\&.} or \emarginpar{\&.\&.\&.}\&.
.PP 
Ignores almost all LaTeX commands that changes margins and linewidths\&.
.PP 
.SH "AUTHOR" 
.PP 
Han-Wen Nienhuys <hanwen@cs\&.uu\&.nl>, http://www\&.cs\&.uu\&.nl/people/hanwen
.PP 
Tom Cato Amundsen <tomato@xoommail\&.com>