Documentation/man/out/mudela-book.1

   1 .TH "LilyPond" "1" "1998" "The LilyPond package" "mudela-book"
   2 .PP
   3 .PP
   4 .SH "NAME"
   5 mudela-book \- integrate LaTeX and mudela
   6 .PP
   7 .SH "SYNOPSIS"
   8 \fBmudela-book\fP [options] inputfile
   9 .PP
  10 .SH "DESCRIPTION"
  11 \fBmudela-book\fP is a script that helps
  12 integrating mudela and LaTeX\&.  mudela-book runs LilyPond on
  13 fragments of mudela in your source file, and includes the results into
  14 document that can be processed with LaTeX\&.  The result is a text
  15 document with formatted music integrated\&.
  16 .PP
  17 Lilypond will by default create all output files in directory \fBout\fP\&.
  18 The file to give to latex has ext \fB\&.latex\fP\&.
  19 .PP
  20 \fBAbout the input\fP
  21 .PP
  22 If the file contains the ``block\'\'
  23 .PP
  24
  25 .DS
  26
  27
  28         \ebegin{mudela}
  29         CONTENTS
  30         \eend{mudela}
  31
  32 .DE
  33
  34
  35 .PP
  36 then LilyPond is run on CONTENTS\&.  mudela-book puts the result back,
  37 surrounded by \f(CW\epreMudelaExample\fP and \f(CW\epostMudelaExample\fP
  38 commands\&. \f(CW\epreMudelaExample\fP and \f(CWposMudelaExample\fP is
  39 defined to nothing by default, and the user can redefine them
  40 to whatever he wants\&.
  41 .PP
  42 \f(CW\ebegin\fP takes the following options:
  43 .PP
  44 .IP "eps"
  45 the music is created as eps graphics that can be inserted in
  46 the middle of a text line, not only as a separate paragraph
  47 .IP "verbatim"
  48 CONTENTS is copied into the TeX source enclosed in a verbatim block\&.
  49 .IP "11pt, 13pt, 16pt, 20pt, 26pt"
  50 set the fontsize to use for the music
  51 .IP "singleline"
  52 linewidth = -1\&.
  53 .IP "multiline"
  54 linewidth = textwidth
  55 .IP "fragment"
  56 .IP "nonfragment"
  57 Override mudela-book autodetection of what type of code is in the
  58 mudela block, voice contents or complete code\&.
  59 .PP
  60 .SH "OPTIONS"
  61 .PP
  62 .IP
  63 .IP "--default-mudela-fontsize=??pt"
  64 Set the fontsize to use for mudela if no fontsize is given
  65 as option\&.
  66 .IP "--force-mudela-fontsize=??pt"
  67 Force all mudela to use this fontsize, overriding options
  68 given to \ebegin{mudela}
  69 .IP "--outname=FILE"
  70 The name of  file to output\&. If this option  is not given,
  71 the output name derived from the input name\&.
  72 .IP "--outdir=DIRECTORY"
  73 The directory to output lilypond output and input to\&.
  74 .IP "--help"
  75 Print a short help message
  76 .IP "--dependencies"
  77 Write dependencies to outdir/filename\&.dep
  78 .IP "--force-verbatim"
  79 Make all mudela verbatim\&.
  80 .IP "--initfile=FILE"
  81 read command definitions from \fBFILE\fP
  82 .PP
  83 .SH "FILES"
  84 See \fBDocumentation/tex/out/mudela-book-doc\&.dvi\fP for more info\&.
  85 You have to install LaTeX\&.
  86 \fBmudela-book\fP is written in  python 1\&.5, so you have to install
  87 python\&.
  88 .PP
  89 .SH "BUGS"
  90 .PP
  91 The LaTeX \eincludeonly{\&.\&.\&.} command is ignored\&.
  92 .PP
  93 You get trouble if you use the --force-verbatim option and have some
  94 music in \efootnote{\&.\&.\&.} or \emarginpar{\&.\&.\&.}\&.
  95 .PP
  96 Ignores almost all LaTeX commands that changes margins and linewidths\&.
  97 .PP
  98 .SH "AUTHOR"
  99 .PP
 100 Han-Wen Nienhuys <hanwen@cs\&.uu\&.nl>, http://www\&.cs\&.uu\&.nl/people/hanwen
 101 .PP
 102 Tom Cato Amundsen <tomato@xoommail\&.com>