Documentation/man/mudela-book.yo

   1
   2 mailto(janneke@gnu.org)
   3 COMMENT(
   4         (PIPETHROUGH(echo -n `date '+%d/%b/%y'|tr '[a-z]' '[A-Z]'`)())
   5 )
   6 manpage(LilyPond)
   7         (1)
   8         (1998)
   9         (The LilyPond package)
  10         (mudela-book)
  11
  12 metalC(Automatically generated by yodl(1) from mudela-book.yo.)
  13
  14 manpagename(mudela-book)(integrate LaTeX and mudela)
  15
  16 manpagesynopsis() bf(mudela-book) [options] inputfile
  17
  18 manpagedescription() file(mudela-book) is a script that helps
  19 integrating mudela and LaTeX().  mudela-book runs LilyPond on
  20 fragments of mudela in your source file, and includes the results into
  21 document that can be processed with LaTeX().  The result is a text
  22 document with formatted music integrated.
  23
  24
  25 If the file contains the ``block''
  26
  27 verb(
  28         \begin{mudela}
  29         CONTENTS
  30         \end{mudela}
  31 )
  32
  33 then LilyPond is run on CONTENTS.  mudela-book puts the result back,
  34 surrounded by code(\preMudelaExample) and code(\postMudelaExample)
  35 commands. The code(\begin) takes the following options:
  36
  37 description(
  38 dit(floating)
  39     the created graphics can be inserted in the middle of a text line,
  40     not only as a separate paragraph
  41 dit(fragment)
  42     mudela-book adds some redtape. You
  43     can substitute voice-contents for CONTENTS in this case.
  44 dit(verbatim)
  45     CONTENTS is copied into the TeX source enclosed in a verbatim block.
  46 dit(11pt, 13pt, 16pt, 20pt, 26pt)
  47     set the fontsize to use for the music
  48 )
  49
  50 manpageoptions()
  51
  52 startdit()
  53
  54 dit(--mudela-fontsize)
  55     Set the fontsize to use for mudela if no fontsize is given
  56     as option.
  57 dit(--force-mudela-fontsize)
  58     Force all mudela to use this fontsize, overriding options
  59     given to \begin{mudela}
  60 dit(--outname)
  61     The name of LaTeX() file to output. If this option  is not given,
  62 the output name derived from the input name.
  63 dit(--outdir)
  64     The directory to output lilypond output and input to.
  65 dit(--help)
  66         print a short help message
  67 dit(--dependencies)
  68         write dependencies to outdir/filname.dep
  69 enddit()
  70
  71 manpagefiles()
  72   You have to install LaTeX. file(mudela-book) is not tested on LaTeX 2.09
  73   and will probably fail on something else than LaTeX2e.
  74
  75   file(mudela-book) is written in  python 1.5, so you have to install
  76   url(python)(http://www.python.org).
  77
  78 manpagebugs()
  79
  80 The LaTeX \includeonly{...} command is ignored.
  81
  82 You get trouble if you use the --force-verbatim option and have some
  83 music in \footnote{...} or \marginpar{...}.
  84
  85 Ignores almost all LaTeX commands that changes margins and linewidths.
  86
  87 manpageauthor()
  88
  89 nemail(Han-Wen Nienhuys)(hanwen@cs.uu.nl), lurl(http://www.cs.uu.nl/people/hanwen)
  90
  91 nemail(Tom Cato Amundsen)(tomato@xoommail.com)