]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/topdocs/NEWS.tely
* lily/relocate.cc (prefix_relocation): allow "current"
[lilypond.git] / Documentation / topdocs / NEWS.tely
index b9ee991d56f92fab20c3b64ae981a032a84fe167..ac12b49d3e777ff60d4f111f09f05d24f6c66781 100644 (file)
@@ -4,10 +4,10 @@
 
 @ifhtml
 @macro inputfileref{DIR,NAME}
 
 @ifhtml
 @macro inputfileref{DIR,NAME}
-@uref{../../../\DIR\/out-www/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}@c
+@uref{../../\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}@c
 @end macro
 @macro usermanref{NAME}
 @end macro
 @macro usermanref{NAME}
-@inforef{\NAME\,,../../user/out-www/lilypond/lilypond}@c
+@inforef{\NAME\,,../user/lilypond/lilypond}@c
 @end macro
 @end ifhtml
 
 @end macro
 @end ifhtml
 
@@ -38,13 +38,313 @@ See user manual, \NAME\
 @unnumbered New features in 2.7 since 2.6
 
 @ifhtml
 @unnumbered New features in 2.7 since 2.6
 
 @ifhtml
-This document is also available in @uref{NEWS.pdf,PDF}.
+This document is also available in @uref{NEWS.pdf,PDF}. It's part of
+the @uref{../,LilyPond Documentation} 
 @end ifhtml
 
 
 
 
 @itemize @bullet
 @end ifhtml
 
 
 
 
 @itemize @bullet
+
+@ignore
+
+HINTS
+
+* only show verbatim input for syntax/input changes
+
+* try to be as brief possible in those cases
+
+* don't try to provide real-world examples, they often get too big,
+which scares away people.
+
+* Write complete sentences.
+
+* only show user-visible changes. 
+
+@end ignore
+@item Items  directly connected with a music input element may be
+parenthesized, for example,
+
+
+@lilypond[verbatim,ragged-right,fragment]
+c4 -\parenthesize -.
+<d \parenthesize fis a> 
+@end lilypond
+
+This feature was sponsored by Ramana Kumar.
+
+@item Multi-word
+ variables in the @code{\paper} and @code{\layout} block are now
+ separated with dashes, i.e.
+
+@verbatim
+\paper {
+  ragged-right = ##t
+  top-margin = 5 \cm
+}
+@end verbatim
+
+@noindent
+The same holds for analogous options in lilypond-book.
+
+@item
+Music for multiple parts can be interleaved, similar to MUP input.
+This is done with the @code{\parallelMusic} function,
+  
+@lilypond[verbatim,ragged-right]
+\parallelMusic #'(voiceA voiceB) {
+  r8     g'16[ c''] e''[ g' c'' e''] r8     g'16[ c''] e''[ g' c'' e''] |
+  c'2                                c'2                                |
+  r8     a'16[ d''] f''[ a' d'' f''] r8     a'16[ d''] f''[ a' d'' f''] |
+  c'2                                c'2                                |
+}
+\new StaffGroup <<
+  \new Staff
+    \new Voice \voiceA 
+  \new Staff
+    \new Voice \voiceB
+>> 
+@end lilypond
+
+This feature was contributed by Nicolas Sceaux.
+
+@item Alignments of staves may be tuned per system.   
+@lilypond[]
+#(set-global-staff-size 13)
+
+\relative c'' \new StaffGroup <<
+  \new Staff { c1 c }
+  \new Staff { c c  }
+  \new Staff { 
+       \overrideProperty
+       #"Score.NonMusicalPaperColumn"
+       #'line-break-system-details
+       #'((alignment-offsets . (0 -5 -20)))
+       c1 \break
+       \overrideProperty
+       #"Score.NonMusicalPaperColumn"
+       #'line-break-system-details
+       #'((alignment-offsets . (0 -15 -20)))
+       c1 
+  }
+>>
+@end lilypond
+
+This feature was sponsored by Trevor Bača.
+
+@item Individual systems may be positioned manually,
+
+@lilypond[]
+\header{
+  tagline = "lily was here"
+}
+
+#(set-default-paper-size "a7" 'landscape)
+\paper {
+  headsep = 0.0
+  footsep = 0.0
+  }
+\book {
+ \score {
+   \relative c'' {
+     c1\break
+      \overrideProperty 
+      #"Score.NonMusicalPaperColumn"
+      #'line-break-system-details
+      #'((Y-offset . 24.5)
+         (X-offset . -7.5))
+      c1 
+   }
+   }
+ \paper {
+   annotatepage = ##t
+   annotateheaders = ##t
+ }
+}
+@end lilypond
+
+This feature was sponsored by Trevor Bača and Nicolas Sceaux.
+
+@item A linebreaking configuration can now be saved as a @file{.ly}
+file automatically. This allows vertical alignments to be stretched to
+fit pages in a second formatting run. See
+@inputfileref{input/regression,page-layout-twopass.ly} for an
+example.
+
+This feature was sponsored by Trevor Bača and Nicolas Sceaux.
+
+@item The tie formatting for chords has been further polished. More
+cases are handled gracefully, and all scoring parameters may now be
+changed through the @code{details} property of the @code{Tie} grob.
+
+This refinement was sponsored by Steve Doonan.
+
+@item Positions of staff lines may now be set individually, for
+example
+
+@lilypond[ragged-right]
+\new Staff  \relative c' {
+  \override Staff.StaffSymbol #'line-positions = #'(-7 -2 0 7)
+  g c f b e a
+}
+@end lilypond
+
+This feature  was sponsored by Andrea Valle.
+
+
+@item A MusicXML importer is included now.
+
+It was sponsored by among others, Mark van den Borre, 
+and Muziekacademie Lede.
+
+@item
+Stem direction on the center staff line are now interpolated between
+neighbors. This results in less stem direction changes, leading to a
+more even appearance. For example,
+
+@lilypond[ragged-right]
+\relative c'' {
+  c4 b c b
+  c c c r
+  b a b a
+}
+@end lilypond 
+
+This feature was sponsored by Mike Rolish and Basil Crow.
+
+@item
+Slurs now avoid @code{TupletNumber}s, and tuplet numbers may enter the
+staff.
+
+@lilypond[ragged-right]
+\relative {
+  \slurUp
+  \override TupletBracket #'bracket-visibility = ##f
+  \override TupletBracket #'staff-padding = ##f
+  \override Slur #'details #'region-size  = #6
+  
+  \times 2/3
+  {
+    c(  \stemDown g' \stemNeutral  c,)
+  }
+}
+@end lilypond
+
+This feature was sponsored by Trent Johnston.
+
+
+@item Tuplet brackets and numbers  are implemented as separate grobs,
+@code{TupletBracket} and @code{TupletNumber}.
+
+This rewrite was sponsored by Trent Johnston.
+
+@item String arguments for music functions may be specified without
+@code{#} marks. Now, \clef and \bar are also music functions.
+
+@item Ties in chords are also formatted using a scoring based
+formatting. This reduces the number of collisions for ties in chords,
+
+@lilypond[ragged-right,fragment,relative=2]
+  <b  d f g> ~  <b  d f g> 
+@end lilypond
+
+Here, the tie for the D is flipped, in spite the default rule for
+tie directions.
+
+This rewrite was sponsored by Steve Doonan.
+
+@item With the @code{\tweak} music function, layout objects that are directly
+connected to input may be tuned easily,
+
+@lilypond[relative=2,fragment,verbatim,ragged-right]
+<
+  \tweak #'font-size #3  c
+  \tweak #'color #red d
+  \tweak #'style #'cross  g
+  \tweak #'duration-log #1  a
+>4
+@end lilypond
+
+This feature was sponsored by Sean Reed and Bertalan Fodor.
+
+@item Generic music functions may now also be used on articulations
+and chord elements, eg.
+
+@verbatim
+  < \displayMusic c
+    e-\keepWithTag #'bla -\tag #'bla ^2 >
+@end verbatim
+
+This feature was sponsored by Sean Reed and Bertalan Fodor.
+
+
+@item Spaces between lyrics and distance between syllables with
+hyphens may now be separately tuned through the
+@code{LyricSpace} grob.
+
+This feature has been sponsored by Bertalan Fodor.
+
+@item Texts set in a TrueType font are now kerned. This requires CVS
+Pango or Pango 1.12.
+
+@lilypond[relative=2,fragment,ragged-right]
+  c4^"VAVAVAffififl"
+@end lilypond
+
+
+@item Using the @TeX{}  no longer requires linking or dynamically
+opening the kpathsea library, making the backend more easily usable on
+various systems.
+
+This fix was sponsored by Black Trash Productions.
+
+@item The horizontal location of rehearsal marks can be adjusted by
+setting the @code{rehearsalMarkAlignSymbol} property,
+
+@lilypond[ragged-right]
+\relative {
+  c1
+  \key cis \major
+  \clef alto
+  \set Score.rehearsalMarkAlignSymbol = #'key-signature
+  \mark "on-key"
+  cis
+ \key ces \major
+  \set Score.rehearsalMarkAlignSymbol = #'clef
+  \clef treble
+  \mark "on clef"
+  ces
+}
+@end lilypond 
+
+
+This feature was sponsored by Trevor Bača.
+
+
+@item
+It's now possible to easily create deeply nested system start
+delimiters,
+
+@lilypond[ragged-right]
+\new StaffGroup 
+\relative <<
+  \set StaffGroup.systemStartDelimiterHierarchy
+    = #'(SystemStartSquare (SystemStartBracket a (SystemStartSquare b)) d)
+  \new Staff { c1 }
+  \new Staff { c1 }
+  \new Staff { c1 }
+  \new Staff { c1 }
+  \new Staff { c1 }
+>>
+@end lilypond
+
+
+In addition, there is now also support for ``square'' system start
+brackets.
+
+This feature was sponsored by Trevor Bača.
+
 @item
 Tie formatting now uses scoring. This opens the road to formatting
 which handles complex situations require tradeoffs between different
 @item
 Tie formatting now uses scoring. This opens the road to formatting
 which handles complex situations require tradeoffs between different
@@ -60,8 +360,10 @@ a @code{InstrumentName} grob is defined to be
 @verbatim
 ,(ly:make-simple-closure
   `(,+
 @verbatim
 ,(ly:make-simple-closure
   `(,+
-    ,(ly:make-simple-closure (list Self_alignment_interface::y_aligned_on_self))
-    ,(ly:make-simple-closure (list Side_position_interface::y_aligned_on_support_refpoints)))
+    ,(ly:make-simple-closure
+      (,ly:self-alignment-interface::y-aligned-on-self))
+    ,(ly:make-simple-closure
+      (,ly:side-position-interface::y-aligned-on-support-refpoints)))
 @end verbatim
 
 @noindent
 @end verbatim
 
 @noindent
@@ -69,8 +371,8 @@ During execution, the @code{Y-offset} of an @code{InstrumentName} is computed
 as
 
 @example
 as
 
 @example
-(+ (Self_alignment_interface::y_aligned_on_self @var{grob})
-   (Self_alignment_interface::y_aligned_on_support_refpoints @var{grob}))
+(+ (ly:self-alignment-interface::y-aligned-on-self @var{grob})
+   (ly:self-alignment-interface::y-aligned-on-support-refpoints @var{grob}))
 @end example
 
 
 @end example
 
 
@@ -108,15 +410,15 @@ or down, depending on the number of stems in the beam.
 
 @item
 Support for figured bass has been rewritten. Now it supports
 
 @item
 Support for figured bass has been rewritten. Now it supports
-continuation lines, slashed figures, and its figures, brackets, and alignments may
-tuned separately.
+continuation lines, slashed figures, and its figures, brackets, and
+alignments may tuned separately.
 
 
-@lilypond[raggedright,fragment]
+@lilypond[ragged-right,fragment]
 <<
 <<
-\relative { c4 c c c }
-\figures {
-  \set useBassFigureExtenders = ##t
-  <6+ 4 3> <6 4 3> <4 3+> <5/ 7/\+>
+  \relative { c4 c c c }
+  \figures {
+    \set useBassFigureExtenders = ##t
+    <6+ 4 3> <6 4 3> <4 3+> <5/ 7/\+>
 } >>
 @end lilypond
 
 } >>
 @end lilypond
 
@@ -141,7 +443,7 @@ The default paper size may now be set from the command line using
 Beamlets may stick out of the side of beams.
 
 
 Beamlets may stick out of the side of beams.
 
 
-@lilypond[fragment,raggedright,relative=2]
+@lilypond[fragment,ragged-right,relative=2]
 {
   \override Beam #'break-overshoot = #'(-0.5 . 0.5) 
   \set stemLeftBeamCount = #2
 {
   \override Beam #'break-overshoot = #'(-0.5 . 0.5) 
   \set stemLeftBeamCount = #2
@@ -160,7 +462,7 @@ This feature was sponsored by Trevor Bača.
 Vertical alignments of staves can now be tuned easily for individual
 systems.
 
 Vertical alignments of staves can now be tuned easily for individual
 systems.
 
-@lilypond[raggedright]
+@lilypond[ragged-right]
 #(set-global-staff-size 13)
 \relative c'' <<
   \new PianoStaff <<
 #(set-global-staff-size 13)
 \relative c'' <<
   \new PianoStaff <<
@@ -201,7 +503,7 @@ These features were sponsored by Trevor Bača and Nicolas Sceaux.
 @item
 The slope of a stem-tremolo may be set manually
 
 @item
 The slope of a stem-tremolo may be set manually
 
-@lilypond[fragment,relative=1,raggedright]
+@lilypond[fragment,relative=1,ragged-right]
 c8:16[ 
 \once \override StemTremolo #'slope = #0.45
 c:16 c:16 c:16 ]
 c8:16[ 
 \once \override StemTremolo #'slope = #0.45
 c:16 c:16 c:16 ]
@@ -212,7 +514,7 @@ This feature was sponsored by Sven Axelsson.
 @item
 Laissez vibrer ties can be created with @code{\laissezVibrer},
 
 @item
 Laissez vibrer ties can be created with @code{\laissezVibrer},
 
-@lilypond[fragment,raggedright,relative=1]
+@lilypond[fragment,ragged-right,relative=1]
   <c e g>\laissezVibrer r  <d f>\laissezVibrer
 @end lilypond
 
   <c e g>\laissezVibrer r  <d f>\laissezVibrer
 @end lilypond
 
@@ -229,9 +531,9 @@ This feature was sponsored by Aaron Mehl.
 Texts over multi measure rests can stretch the corresponding measure,
 if the appropriate @code{spring-and-rods} callback is set.
 
 Texts over multi measure rests can stretch the corresponding measure,
 if the appropriate @code{spring-and-rods} callback is set.
 
-@lilypond[relative=2,fragment,raggedright]
+@lilypond[relative=2,fragment,ragged-right]
 \override MultiMeasureRestText #'springs-and-rods
 \override MultiMeasureRestText #'springs-and-rods
-  = #Multi_measure_rest::set_text_rods
+  = #ly:multi-measure-rest::set-text-rods
 c1 R1 R1^"Very long long long text" 
 @end lilypond
 
 c1 R1 R1^"Very long long long text" 
 @end lilypond
 
@@ -243,11 +545,11 @@ Formatting of ties in chords has been improved. Ties no longer collide
 with note heads and stems. In addition, it is possible to manually
 specify tie formatting
 
 with note heads and stems. In addition, it is possible to manually
 specify tie formatting
 
-@lilypond[relative=2, fragment,raggedright]
+@lilypond[relative=2, fragment,ragged-right]
   <a c d f> ~ <a c d f>
   
   \override TieColumn #'tie-configuration =
   <a c d f> ~ <a c d f>
   
   \override TieColumn #'tie-configuration =
-  #'((0 . -1)  (2 . -1) (5.5 . 1) (7 . 1))
+  #'((0 . -1) '() (5.5 . 1) (7 . 1))
   <b d f g> ~ <b d f g>
 @end lilypond
 
   <b d f g> ~ <b d f g>
 @end lilypond
 
@@ -259,7 +561,7 @@ Dell¡.
 Formatting of isolated, single ties has been improved. Now, ties avoid
 staff lines, flags and dots, without compromising their shape.
 
 Formatting of isolated, single ties has been improved. Now, ties avoid
 staff lines, flags and dots, without compromising their shape.
 
-@lilypond[fragment,raggedright]
+@lilypond[fragment,ragged-right]
 \relative c'' {
   \stemUp
   c16 c2...~ c16 ~ c2... |
 \relative c'' {
   \stemUp
   c16 c2...~ c16 ~ c2... |
@@ -276,7 +578,7 @@ Dell¡.
 With the @code{countPercentRepeats} property,
 percent repeats get incremental numbers to indicate the accumulated repeat count.
 
 With the @code{countPercentRepeats} property,
 percent repeats get incremental numbers to indicate the accumulated repeat count.
 
-@lilypond[relative=2,fragment,raggedright]
+@lilypond[relative=2,fragment,ragged-right]
 \set countPercentRepeats = ##t
 \repeat percent 4 { c1 }
 \time 2/4
 \set countPercentRepeats = ##t
 \repeat percent 4 { c1 }
 \time 2/4
@@ -343,7 +645,7 @@ Proportional notation is supported.  Notes can be spaced proportional
 to their time-difference by assigning a duration to
 @code{proportionalNotationDuration}. For example,
 
 to their time-difference by assigning a duration to
 @code{proportionalNotationDuration}. For example,
 
-@lilypond[relative=2,fragment,raggedright]
+@lilypond[relative=2,fragment,ragged-right]
 <<
   \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
   \new Staff { c8[ c c c c c]  c4 c2 r2 }
 <<
   \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
   \new Staff { c8[ c c c c c]  c4 c2 r2 }
@@ -375,7 +677,7 @@ This feature was sponsored by Trevor Bača.
 Endings of broken tuplet brackets can be tuned.  For example, you can
 add arrows to the brackets,
 
 Endings of broken tuplet brackets can be tuned.  For example, you can
 add arrows to the brackets,
 
-@lilypond[fragment,raggedright,relative=2]
+@lilypond[fragment,ragged-right,relative=2]
 \override TupletBracket
  #'edge-text = #(cons
              (markup #:arrow-head X LEFT #f)
 \override TupletBracket
  #'edge-text = #(cons
              (markup #:arrow-head X LEFT #f)
@@ -406,7 +708,7 @@ These glyphs have been sponsored by Trevor Bača.
 @item
 Nested tuplets are automatically positioned,
 
 @item
 Nested tuplets are automatically positioned,
 
-@lilypond[fragment,raggedright,relative=2]
+@lilypond[fragment,ragged-right,relative=2]
 \set tupletNumberFormatFunction = #fraction-tuplet-formatter
 \times 4/6 {
   a4 a 
 \set tupletNumberFormatFunction = #fraction-tuplet-formatter
 \times 4/6 {
   a4 a 
@@ -499,7 +801,10 @@ This feature was sponsored by Sven Axelsson.
 
 @ifhtml
 For older news, go to
 
 @ifhtml
 For older news, go to
-@uref{http://lilypond.org/doc/v2.6/Documentation/topdocs/out-www/NEWS.html}.
+@uref{http://lilypond.org/doc/v2.6/Documentation/topdocs/NEWS.html},
+or @uref{../,go back} to the Documentation index.
+
+
 @end ifhtml
 
 @bye
 @end ifhtml
 
 @bye