Documentation/misc/announce-v2.0.html

   1 <!--
   2     Translation of GIT committish: <FILL-IN-HEAD-COMMITTISH>
   3
   4     When revising a translation, copy the HEAD committish of the
   5     version that you are working on.  Refer to `UPDATE A TRANSLATION'
   6     in README for details.
   7 !-->
   8
   9
  10 <pre>
  11 Subject: LilyPond 2.0  - make beautiful music prints
  12
  13
  14 Dear music enthousiasts,
  15
  16
  17 LilyPond version 2.0 was released today. LilyPond is an automated
  18 music notation system: it is used to make gorgeous sheet music.  It is
  19 libre software ("open source"), and available for most Unix flavors,
  20 including Linux and MacOS X, and MS Windows.
  21
  22 Use it for your music too!
  23
  24 For this version, we have dramatically simplified many parts of the
  25 syntax, making it easier to use than ever before.  Other improvements
  26 include quarter-tone accidentals, and conditional inclusion of music
  27 fragments. With version 2.0, we have a solid platform for working on
  28 notation and typography features for coming versions.
  29
  30 Downloads, examples and documentation are available from the website,
  31
  32         http://lilypond.org
  33
  34 A big thank-you goes out to our hackers and bughunters: Mats
  35 Bengtsson, Heikki Junes, Juergen Reuter, Antonio Palama, Benjamin
  36 Milde, Daniel Berjon Diez, David Bobroff, David Rayleigh Arnold, Erik
  37 Ronstroem, Fabio dos Santos, Fodor Bertalan, Frederic Bron, Graham
  38 Percival, Ian Bailey-Mortimer, John Williams, Josza Marton, Marco
  39 Caliari, Matthieu Amiguet, Michael Welsh Duggan, Patrick Atamaniuk,
  40 Paul Scott, Pedro Kroeger, Peter Lutek, Richard Schoeller, Thorkil
  41 Wolvendans, and Werner Trobin
  42
  43
  44 Happy music printing,
  45
  46
  47
  48 Han-Wen Nienhuys & Jan Nieuwenhuizen
  49 (core development team)
  50 </pre>
  51
  52
  53 <h2>New features in 2.0 since 1.8</h2>
  54
  55      <ul>
  56
  57      <li>Crescendos can now be drawn dotted or dashed.
  58
  59      <li>Quarter tones are now supported. They are entered by suffixing
  60 <code>ih</code> for a half-sharp and <code>eh</code> for a half-flat. Hence, the
  61 following is an ascending list of pitches:
  62
  63      <pre class="example">            ceses ceseh ces ceh c cih cis cisih cisis
  64           </pre>
  65
  66      <li>The following constructs have been removed from the syntax:
  67
  68      <pre class="example">            \duration #SCHEME-DURATION
  69             \pitch #SCHEME-PITCH
  70             \outputproperty <var>func</var> <var>symbol</var> = <var>value</var>
  71           </pre>
  72
  73      <p>For <code>\outputproperty</code>, the following may be substituted:
  74
  75      <pre class="example">             \applyoutput #(outputproperty-compatibility <var>func</var>
  76                             <var>symbol</var> <var>value</var>)
  77           </pre>
  78
  79      </p><li>Clefs may now be transposed arbitrarily, for example
  80
  81      <pre class="example">            \clef "G_8"
  82             \clef "G_15"
  83             \clef "G_9"
  84           </pre>
  85
  86      <li>The syntax for chords and simultaneous music have changed.
  87 Chords are entered as
  88
  89      <pre class="example">             &lt;<var>pitches</var>&gt;
  90           </pre>
  91
  92      <p>while simultaneous music is entered as
  93
  94      <pre class="example">             &lt;&lt;<var>..music list..</var>&gt;&gt;
  95           </pre>
  96
  97      <p>In effect, the meanings of both have been swapped relative to their 1.8
  98 definition.  The syntax for lists in <code>\markup</code> has changed
  99 alongside, but figured bass mode was not  changed, i.e.:
 100
 101      <pre class="example">            \markup { \center &lt;<var>..list of markups..</var>&gt; }
 102             \figure { &lt;<var>figures</var>&gt; }
 103           </pre>
 104
 105      <p>As chords the more often used than simultaneous music, this change will
 106 save keystrokes.
 107
 108      </p><li>Each music expression can now be tagged, to make different printed
 109 versions from the same music expression.  In the following example,
 110 we see two versions of a piece of music, one for the full score, and
 111 one with cue notes for the instrumental part:
 112
 113      <pre class="example">          &lt;&lt; \tag #'part &lt;&lt;
 114             { c4 f2 g4 }      % in the part, we have cue-notes
 115             \\ R1 &gt;&gt;
 116             \tag #'score R1  % in the score: only a rest
 117           &gt;&gt;
 118           </pre>
 119
 120      <p>The same can be applied to articulations, texts, etc.: they are
 121 made by prepending
 122
 123      <pre class="example">                  -\tag #<var>your-tags</var>
 124           </pre>
 125
 126      <p>to an articulation, for example,
 127
 128      <pre class="example">                  c4-\tag #'with-fingerings -4 -\tag #'with-strings \6
 129           </pre>
 130
 131      <p>This defines a note, which has a conditional fingering and a
 132 string-number indication.
 133
 134      </p><li>The settings for chord-fingering are more flexible. You can specify a
 135 list where fingerings may be placed, eg.
 136
 137      <pre class="example">            \property Voice.fingeringOrientations = #'(left down)
 138           </pre>
 139
 140      <p>This will put the fingering for the lowest note below the chord, and the
 141 rest to the left.
 142
 143      </p><li>The script previously known as <code>ly2dvi</code> has been renamed to
 144 <code>lilypond</code>. The binary itself is now installed as
 145 <code>lilypond-bin</code>.
 146
 147      <li>Markup text (ie. general text formatting) may now be used for lyrics too.
 148
 149      <li>Two new commands for grace notes have been added, <code>\acciaccatura</code>
 150 and <code>\appoggiatura</code>,
 151
 152      <pre class="example">            \appoggiatura f8 e4
 153             \acciaccatura g8 f4
 154           </pre>
 155
 156      <p>Both reflect the traditional meanings of acciaccatura and appoggiatura,
 157 and both insert insert a slur from the first grace note to the main
 158 note.
 159
 160      </p><li>Layout options for grace notes are now stored in a context property,
 161 and may now be set separately from musical content.
 162
 163      <li>The <code>\new</code> command will create a context with a unique
 164 name automatically. Hence, for multi-staff scores, it is no longer
 165 necessary to invent arbitrary context names. For example, a two-staff
 166 score may be created by
 167
 168      <pre class="example">            \simultaneous {
 169               \new Staff { <var>notes for 1st staff</var> }
 170               \new Staff { <var>notes for 2nd staff</var> }
 171             }
 172           </pre>
 173
 174      <li>Octave checks make octave errors easier to correct.
 175 The syntax is
 176
 177      <pre class="example">            \octave <var>pitch</var>
 178           </pre>
 179
 180      <p>This checks that <var>pitch</var> (without octave) yields <var>pitch</var> (with
 181 octave) in \relative mode. If not, a warning is printed, and the
 182 octave is corrected.
 183
 184      </p><li>All articulations must now be entered postfix. For example,
 185
 186      <pre class="example">            c8[( d8])
 187           </pre>
 188
 189      <p>is a pair of beamed slurred eighth notes.
 190
 191      </p><li>The definition of <code>\relative</code> has been simplified.  Octaves are
 192 now always propagated in the order that music is entered. In the
 193 following example,
 194
 195      <pre class="example">            PRE
 196             \repeat "unfold" 3  BODY \alternative { ALT1 ALT2 }
 197             POST
 198           </pre>
 199
 200      <p>the octave of BODY is based on PRE, the starting octave of ALT1 on
 201 BODY, the starting octave of ALT2 on ALT1, and the starting octave of
 202 POST on ALT2.
 203
 204      <p>The same mechanism is used for all other music expressions, except the
 205 chord. Backwards compatibility is retained through a special program option,
 206 which is set through
 207
 208      <pre class="example">            #(ly:set-option 'old-relative)
 209           </pre>
 210
 211      </p><li>Windows users can double click a <code>.ly</code> file to process and view
 212 it automagically through the new <code>lily-wins</code> frontend.
 213
 214 </ul>