release: 1.1.43

[lilypond.git] / Documentation / tex / mudela-book-doc.doc

diff --git a/Documentation/tex/mudela-book-doc.doc b/Documentation/tex/mudela-book-doc.doc
index 22f9d8f3b69014953e571d29ad23bda8d6ee06c3..b905979a1b98f331d37f458a0d5c9bf51f6789d2 100644 (file)
--- a/Documentation/tex/mudela-book-doc.doc
+++ b/Documentation/tex/mudela-book-doc.doc
@@ -7,7 +7,7 @@
 \usepackage[rflt]{floatflt}
 %\usepackage{showframe}
 %\sloppy
 \usepackage[rflt]{floatflt}
 %\usepackage{showframe}
 %\sloppy

-\def\postMudelaExample{\setlength{\parindent}{1em}}
+\def\postMudelaExample{\setlength{\parindent}{3.25ex}}

 \title{Mudela-book tutorial}
 \begin{document}
 \maketitle
 \title{Mudela-book tutorial}
 \begin{document}
 \maketitle


@@ -88,12 +88,12 @@ will set the \verb|linewidth| variable to -1, so Lilypond
 will make the music as short as possible but without breaking the
 line. Here is a well know harmonic progression:
 \begin{mudela}[veryverbatim, intertext="produce a well known harmonic progression:"]
 will make the music as short as possible but without breaking the
 line. Here is a well know harmonic progression:
 \begin{mudela}[veryverbatim, intertext="produce a well known harmonic progression:"]

-\context Voice {  <c' e' g'> <b d' g'> <c'2 e' g'>}
+  <c' e g> <b d g> <c2 e g>

 \end{mudela}
 
 If you want to place music examples in the text,
 \begin{mudela}[eps]
 \end{mudela}
 
 If you want to place music examples in the text,
 \begin{mudela}[eps]

-\context Voice {  <c' e' g'> <b d' g'> <c'2 e' g'>}
+  <c' e g> <b d g> <c2 e g>

 \end{mudela}
 , you can use the \verb|eps| option. This will create the music as
 eps graphics and include it into the document with the 
 \end{mudela}
 , you can use the \verb|eps| option. This will create the music as
 eps graphics and include it into the document with the 


@@ -102,7 +102,7 @@ eps graphics and include it into the document with the
 The code used look like this:
 \begin{verbatim}
 \begin{mudela}[eps]
 The code used look like this:
 \begin{verbatim}
 \begin{mudela}[eps]

-\context Voice {  <c' e' g'> <b d' g'> <c'2 e' g'>}
+  <c' e g> <b d g> <c2 e g>

 \end{mudela}
 \end{verbatim}
 
 \end{mudela}
 \end{verbatim}
 


@@ -129,18 +129,18 @@ be no empty lines between the normal text and the mudela
 environment. 
 
 You can also use \verb|mudelafile| (on a separate line, FIXME), to
 environment. 
 
 You can also use \verb|mudelafile| (on a separate line, FIXME), to

-include another file.
+include another file. Files with name ending with \verb|.sly|

 
 \mudelafile{testje.fly}
 
 \section{Fontsize options}
 You can use all lilypond fontsizes in mudela-book. 
 % LONG line just to test multiple \mudela on one line
 
 \mudelafile{testje.fly}
 
 \section{Fontsize options}
 You can use all lilypond fontsizes in mudela-book. 
 % LONG line just to test multiple \mudela on one line

-The default 16pt fontsize, \mudela{<c' e' g'>}, is probably to big to be included in the middle of the text. 11pt, \mudela[11pt]{<c' e' g'>} or 13pt, \mudela[13pt]{<c' e' g'>} is probably better.
+The default 16pt fontsize, \mudela{<c' e g>}, is probably to big to be included in the middle of the text. 11pt, \mudela[11pt]{<c' e g>} or 13pt, \mudela[13pt]{<c' e g>} is probably better.

 The code can look like this:
 \begin{verbatim}
 \begin{mudela}[13pt, eps]
 The code can look like this:
 \begin{verbatim}
 \begin{mudela}[13pt, eps]

-<c' e' g'>
+<c' e g>

 \end{mudela}
 \end{verbatim}
 
 \end{mudela}
 \end{verbatim}
 


@@ -185,8 +185,8 @@ The following options set the fontsize:
 
 \section{User defined commands}
 There is an even shorter way to write small musical fragments. This
 
 \section{User defined commands}
 There is an even shorter way to write small musical fragments. This

-triad, \mudela{<c' e' g'>}, was created with this code:
-\verb|\mudela{<c' e' g'>}|
+triad, \mudela{<c' e g>}, was created with this code:
+\verb|\mudela{<c' e g>}|

 
 Mudela-book defines the \verb|\mudela| command, and let you define
 your own commands in a file specified by 
 
 Mudela-book defines the \verb|\mudela| command, and let you define
 your own commands in a file specified by 


@@ -224,9 +224,17 @@ send fontsize options to the defined commands.
 }
 \end{mudela}
 
 }
 \end{mudela}
 

+\section{More options}
+\begin{itemize}
+\item The \verb|singleline| option set \verb|linewidth| to -1.0.
+\item The \verb|multiline| option set \verb|linewidth| to a value letting
+the music be aligned to the right margin. The music can span several
+lines. 
+\end{itemize}
+

 \section{Just in case...}
 The options \verb|fragment| and \verb|nonfragment| will override
 \section{Just in case...}
 The options \verb|fragment| and \verb|nonfragment| will override

-mudela-book when it scans the mudela code to see if it is staff
+mudela-book when it scans the mudela code to see if it is voice

 contents or complete code. This might be useful if mudela-book choose
 wrong. 
 
 contents or complete code. This might be useful if mudela-book choose
 wrong. 
 


@@ -238,7 +246,8 @@ if you need this one of these options.
 This was all options to \verb|\begin{mudela}|. The rest of the
 document will show some ways you can use mudela in
 \LaTeX~documents. It will also act as a simple test-suite for
 This was all options to \verb|\begin{mudela}|. The rest of the
 document will show some ways you can use mudela in
 \LaTeX~documents. It will also act as a simple test-suite for

-mudela-book. You \marginpar{
+mudela-book. You 
+\marginpar{

 marginpar!
 \begin{mudela}[eps, 11pt]
  \relative c'' {\key c \minor; r4 [g8 g g] es2}
 marginpar!
 \begin{mudela}[eps, 11pt]
  \relative c'' {\key c \minor; r4 [g8 g g] es2}


@@ -300,23 +309,23 @@ names of some triads:
 \hline
 
 dur &
 \hline
 
 dur &

-\begin{mudela}[eps]
-\context Voice {<c' e' g'>}
+\begin{mudela}[eps, fragment]
+<c' e g>

 \end{mudela} 
 \\
 \hline moll &
 \begin{mudela}[eps]
 \end{mudela} 
 \\
 \hline moll &
 \begin{mudela}[eps]

-\context Voice {<c' ees' g'>}
+<c' es g>

 \end{mudela}
 \\
 \hline forminsket &
 \begin{mudela}[eps]
 \end{mudela}
 \\
 \hline forminsket &
 \begin{mudela}[eps]

-\context Voice {<c' es' ges'>}
+<c' es ges>

 \end{mudela}
 \\
 \hline forstørret &
 \begin{mudela}[eps]
 \end{mudela}
 \\
 \hline forstørret &
 \begin{mudela}[eps]

-\context Voice {<c' e' gis'>}
+<c' e gis>

 \end{mudela}
 \\
 \hline 
 \end{mudela}
 \\
 \hline 


@@ -330,7 +339,7 @@ into the preamble of your document. Then the line spacing will not be
 increased between the lines where you have music printed with the
 smallest font size.
 
 increased between the lines where you have music printed with the
 smallest font size.
 

-Since the version number is  low, you should be careful not to
+Since the version number is quite low, you should be careful not to

 mix braces that belongs to mudela-book and \LaTeX~on the same
 line. The following code will probably break:
 
 mix braces that belongs to mudela-book and \LaTeX~on the same
 line. The following code will probably break:
 


@@ -353,6 +362,10 @@ a feature of \LaTeX. (But you usually put things inside a verbatim
 environment when you don't want \LaTeX~to do any linebreaking)
 
 
 environment when you don't want \LaTeX~to do any linebreaking)
 
 

+\end{document}
+
+
+
+

 
 
 
 

-\end{document}