\input texinfo @c -*-texinfo-*-
-@setfilename reference-manual.info
-@settitle Reference Manual
+@setfilename mudela-book.info
+@settitle mudela-book Manual
+
+
+@titlepage
+@title mudela-book Manual
+@subtitle Integrating mudela with La@TeX{} and TeXinfo
+@author Tom Cato Amundsen and Han-Wen Nienhuys
+
+ Copyright @copyright{} 1999 by the authors
+
+@vskip 0pt plus 1filll
+
+Permission is granted to make and distribute verbatim
+copies of this manual provided the copyright notice and
+this permission notice are preserved on all copies.
+
+Permission is granted to copy and distribute modified
+versions of this manual under the conditions for
+verbatim copying, provided also that the sections
+entitled ``Copying'' and ``GNU General Public License''
+are included exactly as in the original, and provided
+that the entire resulting derived work is distributed
+under the terms of a permission notice identical to this
+one.
+
+Permission is granted to copy and distribute
+translations of this manual into another language,
+under the above conditions for modified versions,
+except that this permission notice may be stated in a
+translation approved by the Free Software Foundation.
+
+@end titlepage
+
+@ifinfo
+This file documents GNU LilyPond.
+
+Copyright 1999 Tom Cato Amundsen and Han-Wen Nienhuys
+
+
+Permission is granted to make and distribute verbatim
+copies of this manual provided the copyright notice and
+this permission notice are preserved on all copies.
+
+@ignore
+Permission is granted to process this file through TeX
+and print the results, provided the printed document
+carries a copying permission notice identical to this
+one except for the removal of this paragraph (this
+paragraph not being relevant to the printed manual).
+
+@end ignore
+
+Permission is granted to copy and distribute modified
+versions of this manual under the conditions for
+verbatim copying, provided also that the sections
+entitled ``Copying'' and ``GNU General Public License''
+are included exactly as in the original, and provided
+that the entire resulting derived work is distributed
+under the terms of a permission notice identical to this
+one.
+
+Permission is granted to copy and distribute
+translations of this manual into another language,
+under the above conditions for modified versions,
+except that this permission notice may be stated in a
+translation approved by the Free Software Foundation.
+
+@end ifinfo
+
@node Top, , , (dir)
@top
[TODO: THIS MANUAL IS OUTDATED. FIXME.]
-Mudela-book is a script that process your \LaTeX file and with great
+Mudela-book is a script that process your La@TeX{} file and with great
help from GNU LilyPond it translates blocks of mudela code it finds
inside @code{mudela} environments to tex or eps graphics. It then
-creates a new file that can be sent through \LaTeX to create a
+creates a new file that can be sent through La@TeX{} to create a
@file{.dvi} file with lines of music integrated with text.
Mudela-book will do its best to try to align the music to the left and
right margins. Currently the most used papersizes and one- and
twocolumn mode is supported, but if you use the geometry-package from
-LaTeX or change the margins things will break.
+La@TeX{} or change the margins things will break.
This document assumes you have basic knowledge of GNU LilyPond and
-LaTeX.
+La@TeX{}.
So what does this look like? Well, here is an example:
@mudela[veryverbatim, intertext="produces this music:"]
}
@end mudela
If you are lucky, the above example show a nice feature of LilyPond
-and LaTeX. Since LilyPond can output the music as \TeX graphics,
-LaTeX can insert pagebreaks between the lines of music.
+and La@TeX{}. Since LilyPond can output the music as @TeX{} graphics,
+La@TeX{} can insert pagebreaks between the lines of music.
Notice that there is no @code{\paper} statement in the example
above. Mudela-book will insert some code for you that defines the
will make the music as short as possible but without breaking the
line. Here is a well know harmonic progression:
@mudela[veryverbatim, intertext="produce a well known harmonic progression:"]
- <c' e g> <b d g> <c2 e g>
+ \context Voice { <c' e g> <b d g> <c2 e g> }
@end mudela
If you want to place music examples in the text,
@mudela[eps]
- <c' e g> <b d g> <c2 e g>
+\context Voice { <c' e g> <b d g> <c2 e g>}
@end mudela
, you can use the @code{eps} option. This will create the music as
eps graphics and include it into the document with the
The code used look like this:
@example
-@mudela[eps]
- <c' e g> <b d g> <c2 e g>
-@end mudela
+@@mudela[eps]
+ \context Voice { <c' e g> <b d g> <c2 e g> }
+@@end mudela
@end example
You can also use the @code{eps} option if the block is a complete
@end mudela
was created with this code:
@example
-@mudela[eps]
-\score{
- \notes{s}
- \paper{ linewidth = 5.\cm;}
-}
-@end mudela
+@@mudela[eps]
+\score@{
+ \notes@{s@}
+ \paper@{ linewidth = 5.\cm;@}
+@}
+@@end mudela
@end example
-To avoid that LaTeX places the music on a line of its one, there should
+To avoid that La@TeX{} places the music on a line of its one, there should
be no empty lines between the normal text and the mudela
environment.
You can also use @code{mudelafile} (on a separate line, FIXME), to
-include another file. Files with name ending with @code{.sly}
+include another file.
@section Fontsize options You can use all lilypond fontsizes in
mudela-book. The default 16pt fontsize is probably to big to be
The code can look like this:
@example
-@mudela[13pt, eps]
+@@mudela[13pt, eps]
<c' e g>
-@end mudela
+@@end mudela
@end example
The following options set the fontsize:
This was all options to @code{\begin}. The rest of the mudela
document will show some ways you can use mudela in
-LaTeX documents. It will also act as a simple test-suite for
+La@TeX{} documents. It will also act as a simple test-suite for
mudela-book. You can place @code{eps} mudela in and marginspars just
as any other included eps graphics.
So the music will be adjusted to the new linewith:
Verbatim environments will also ignore the page margins. That is
-a feature of LaTeX. (But you usually put things inside a verbatim
-environment when you don't want LaTeX to do any linebreaking)
+a feature of La@TeX{}. (But you usually put things inside a verbatim
+environment when you don't want La@TeX{} to do any linebreaking)
@section Texinfo behavior
@section Invocation
@file{mudela-book} is a script that helps integrating mudela and
-LaTeX. mudela-book runs LilyPond on fragments of mudela in your
+La@TeX{}. 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
+processed with La@TeX{}. The result is a text document with formatted
music integrated.
Lilypond will by default create all output files in directory @file{out}.
Force all mudela to use this fontsize, overriding options
given to \begin@{mudela@}
@item --outname=FILE
- The name of LaTeX file to output. If this option is not given,
+ The name of La@TeX{} file to output. If this option is not given,
the output name derived from the input name.
@item --out-www=DIRECTORY
The name of the directory to output lilypond output and input to.
@section Bugs
-The LaTeX \includeonly@{...@} command is ignored.
+The La@TeX{} \includeonly@{...@} command is ignored.
-Ignores almost all LaTeX commands that changes margins and linewidths.
+Ignores almost all La@TeX{} commands that changes margins and linewidths.
@section Authors
@bye
-
-
-
-
-
projects / lilypond.git / blobdiff