Documentation/introduction.doc

   1 % -*-latex-*-
   2
   3 % this document should be run through the mudela-book script after lilypond
   4 % has been installed.  The rules have been precooked into the
   5 % Documentation/Rules.make file; do
   6 %
   7 %   make out/introduction.dvi
   8 %
   9 % or
  10 %
  11 %   mudela-book --outdir=out/ --outname=introduction.mudtex introduction.doc
  12 %   latex '\nonstopmode \input out/introduction.mudtex'
  13
  14
  15 \documentclass{article}
  16 \usepackage{a4wide}
  17 \title{Introduction to GNU LilyPond}
  18 \author{Jan Nieuwenhuizen}
  19 \date{March 2, 1998}
  20
  21 % ugh: trick to get examples not generate par
  22 % these are for 16pt
  23 \def\mudelapaperlinewidth{-28.452756}%
  24 \def\mudelapaperindent{28.452756}%
  25 \def\mudelapaperrulethickness{0.400000}%
  26 \def\mudelapaperbarsize{16.000000}%
  27 \def\mudelapaperinterline{4.000000}%
  28 \def\mudelapapernotewidth{5.930000}%
  29 \def\mudelapaperwholewidth{8.640000}%
  30 \def\mudelapaperunitspace{22.000000}%
  31 \def\mudelapaperbasicspace{4.000000}%
  32 \def\mudelapapergeometric{0.000000}%
  33 \def\mudelapaperarithmetic_basicspace{2.000000}%
  34 \def\mudelapaperarithmetic_multiplier{4.800000}%
  35 \def\mudelapaperinterbeam{3.140000}%
  36 \def\mudelapapergourlay_energybound{100000.000000}%
  37 \def\mudelapapergourlay_maxmeasures{14.000000}%
  38
  39 % ful of pars, needs the above
  40 \input lilyponddefs
  41 % generates par
  42 \musixsixteendefs
  43 \def\musixsixteendefs{}
  44 % generates par
  45 \turnOnPostScript%
  46 \def\turnOnPostScript{}
  47 %
  48
  49 \begin{document}
  50 \maketitle
  51
  52 \def\interexample{\hskip15mm$\Longrightarrow$\hskip15mm}
  53 \def\preexample{}
  54 \def\postexample{\par\medskip}
  55
  56 % ugh, howto?
  57 % \def\frag{\vbox to 2\mudelapaperbarsize pt{\vss}
  58 % \def\interexample{\vss}\hskip15mm$\Longrightarrow$\hskip15mm}
  59 % \def\preexample{\vbox to 2\mudelabarsize pt{\vss}
  60 % \def\postexample{\vss}\par\medskip}
  61
  62 \def\file#1{{\texttt{#1}}}
  63 \setcounter{secnumdepth}{-1}
  64
  65 \emph{\Large ***Under construction***}
  66
  67 \section{Introduction}
  68 This document should provide a gentle introduction to
  69 LilyPond's input language, Mudela.
  70 For completeness and nifty features see
  71 \verb+input/*.ly+
  72 and
  73 \verb+lily/parser.y, lily/lexer.l+.
  74
  75
  76 \section{Notes: pitches and durations}
  77
  78 \begin[fragment,verbatim]{mudela}
  79 c
  80 \end{mudela}
  81
  82 \begin[fragment,verbatim]{mudela}
  83 c d e f g a b
  84 \end{mudela}
  85
  86 Durations are entered as reciproce values
  87 \begin[fragment,verbatim]{mudela}
  88 a1 | a2 a | a4 a a a
  89 \end{mudela}
  90 and default to the last previously used duration.
  91
  92 Now we can write a little tune
  93 \begin[fragment,verbatim]{mudela}
  94 c d e c | c d e c | e f g2 | e4 f g2
  95 \end{mudela}
  96 note the explicit duration change for
  97 the quarter e in the last measure.
  98
  99 Same for notes with flags
 100 \begin[fragment,verbatim]{mudela}
 101 a8 a16 a32 a64 a128
 102 \end{mudela}
 103
 104 \begin[fragment,verbatim]{mudela}
 105 c c' c''
 106 \end{mudela}
 107
 108 \begin[fragment,verbatim]{mudela}
 109 a 'a ''a
 110 \end{mudela}
 111
 112 \section{Slurs and Ties}
 113
 114 A tie connects two adjacent noteheads
 115
 116 \begin[fragment,verbatim]{mudela}
 117 c' ~ c
 118 \end{mudela}
 119
 120 Whereas a slur rather connects `chords',
 121 and tries to avoid crossing stems.
 122
 123 \begin[fragment,verbatim]{mudela}
 124 c'( )c
 125 \end{mudela}
 126
 127 A (legato) slur can span several notes
 128 \begin[fragment,verbatim]{mudela}
 129 c'( d e )c
 130 \end{mudela}
 131
 132 \section{Beams and plets}
 133
 134 \begin[fragment,verbatim]{mudela}
 135 [a8 a] [a16 a a a]
 136 \end{mudela}
 137
 138 % [2/3 a8 a a]1/1
 139 \begin[fragment,verbatim]{mudela}
 140 [/3 a8 a a]/1
 141 \end{mudela}
 142
 143 \begin[fragment,verbatim]{mudela}
 144 \[/3 a4 a8\]
 145 \end{mudela}
 146
 147 \section{Commands}
 148
 149 \begin[fragment,verbatim]{mudela}
 150 \clef "bass"; 'c
 151 \end{mudela}
 152
 153 \begin[fragment,verbatim]{mudela}
 154 \meter 3/4; c g g |
 155 \end{mudela}
 156
 157 \begin[fragment,verbatim]{mudela}
 158 \key fis cis;
 159 'g 'a 'b cis d e fis g'
 160 \end{mudela}
 161
 162 \section{Example}
 163
 164 A Mudela file needs some red tape
 165
 166 \begin[verbatim]{mudela}
 167 \score{
 168         \melodic{
 169                 \octave c';
 170                 c d e c
 171         }
 172 }
 173 \end{mudela}
 174
 175 \section{Lyrics}
 176
 177 % this nesting syntax sucks
 178 \begin[verbatim]{mudela}
 179 \score{
 180         <
 181                 \melodic \type Staff = bla < \melodic{\octave c'; c d e c} >
 182 % huh?
 183 %               \lyric \type Lyrics = bli < \lyric{Fre- re Ja- que} >
 184         >
 185 }
 186 \end{mudela}
 187
 188 \section{Variables}
 189
 190 \end{document}
 191