]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/topdocs/NEWS.tely
patch by Joe Neeman: "I have
[lilypond.git] / Documentation / topdocs / NEWS.tely
index 89ccdb9556f598e0beee9a4d2deb442f0203f23a..1ecc6c72f0196a38aa8df8dc08c72542cdd9d006 100644 (file)
@@ -57,15 +57,67 @@ HINTS
 
 * 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 A score may now be specified to take a fixed number of
+systems, by setting the @code{system-count} variable in the
+@code{\layout} block.
+
+This feature was contributed by Joe Neeman.
+
+@item Ties may now be attached to the left side of a note with
+@code{\repeatTie}, for use with volta repeats.
+
+@lilypond[relative=2,fragment,ragged-right]
+r4 <c e g>\repeatTie
+@end lilypond
+
+This feature was sponsored by Steve Doonan.
+
+@item Newly created contexts may also be named with the following
+syntax,
+
+@verbatim
+\new Voice = "alto" ... 
+@end verbatim
+
+@item Thicknesses of tie and slurs may be  tuned separately for the
+endings and the middle part.
+
+@item Items directly connected with a music input element may be
+parenthesized, for example,
+
+@lilypond[verbatim,ragged-right,fragment,relative=2]
+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 may for multiple parts can be interleaved, similar to MUP input.
+Music for multiple parts can be interleaved, similar to MUP input.
 This is done with the @code{\parallelMusic} function,
   
-@lilypond[verbatim,raggedright]
+@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                                |
@@ -115,8 +167,8 @@ This feature was sponsored by Trevor Bača.
 
 #(set-default-paper-size "a7" 'landscape)
 \paper {
-  headsep = 0.0
-  footsep = 0.0
+  head-separation = 0.0
+  foot-separation = 0.0
   }
 \book {
  \score {
@@ -156,7 +208,7 @@ This refinement was sponsored by Steve Doonan.
 @item Positions of staff lines may now be set individually, for
 example
 
-@lilypond[raggedright]
+@lilypond[ragged-right]
 \new Staff  \relative c' {
   \override Staff.StaffSymbol #'line-positions = #'(-7 -2 0 7)
   g c f b e a
@@ -176,7 +228,7 @@ 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[raggedright]
+@lilypond[ragged-right]
 \relative c'' {
   c4 b c b
   c c c r
@@ -190,7 +242,7 @@ This feature was sponsored by Mike Rolish and Basil Crow.
 Slurs now avoid @code{TupletNumber}s, and tuplet numbers may enter the
 staff.
 
-@lilypond[raggedright]
+@lilypond[ragged-right]
 \relative {
   \slurUp
   \override TupletBracket #'bracket-visibility = ##f
@@ -213,13 +265,12 @@ This feature was sponsored by Trent Johnston.
 This rewrite was sponsored by Trent Johnston.
 
 @item String arguments for music functions may be specified without
-@code{#} marks. This allows syntactical constructs (like \clef and
-\bar) to be expressed in generic music functions.
+@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[raggedright,fragment,relative=2]
+@lilypond[ragged-right,fragment,relative=2]
   <b  d f g> ~  <b  d f g> 
 @end lilypond
 
@@ -231,7 +282,7 @@ 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,raggedright]
+@lilypond[relative=2,fragment,verbatim,ragged-right]
 <
   \tweak #'font-size #3  c
   \tweak #'color #red d
@@ -262,7 +313,7 @@ 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,raggedright]
+@lilypond[relative=2,fragment,ragged-right]
   c4^"VAVAVAffififl"
 @end lilypond
 
@@ -276,7 +327,7 @@ 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[raggedright]
+@lilypond[ragged-right]
 \relative {
   c1
   \key cis \major
@@ -300,7 +351,7 @@ This feature was sponsored by Trevor Bača.
 It's now possible to easily create deeply nested system start
 delimiters,
 
-@lilypond[raggedright]
+@lilypond[ragged-right]
 \new StaffGroup 
 \relative <<
   \set StaffGroup.systemStartDelimiterHierarchy
@@ -335,9 +386,9 @@ a @code{InstrumentName} grob is defined to be
 ,(ly:make-simple-closure
   `(,+
     ,(ly:make-simple-closure
-      (,Self_alignment_interface::y_aligned_on_self))
+      (,ly:self-alignment-interface::y-aligned-on-self))
     ,(ly:make-simple-closure
-      (,Side_position_interface::y_aligned_on_support_refpoints)))
+      (,ly:side-position-interface::y-aligned-on-support-refpoints)))
 @end verbatim
 
 @noindent
@@ -345,8 +396,8 @@ During execution, the @code{Y-offset} of an @code{InstrumentName} is computed
 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
 
 
@@ -387,7 +438,7 @@ Support for figured bass has been rewritten. Now it supports
 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 {
@@ -417,7 +468,7 @@ The default paper size may now be set from the command line using
 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
@@ -436,7 +487,7 @@ This feature was sponsored by Trevor Bača.
 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 <<
@@ -477,7 +528,7 @@ These features were sponsored by Trevor Bača and Nicolas Sceaux.
 @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 ]
@@ -488,7 +539,7 @@ This feature was sponsored by Sven Axelsson.
 @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
 
@@ -505,9 +556,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.
 
-@lilypond[relative=2,fragment,raggedright]
+@lilypond[relative=2,fragment,ragged-right]
 \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
 
@@ -519,7 +570,7 @@ 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
 
-@lilypond[relative=2, fragment,raggedright]
+@lilypond[relative=2, fragment,ragged-right]
   <a c d f> ~ <a c d f>
   
   \override TieColumn #'tie-configuration =
@@ -535,7 +586,7 @@ Dell¡.
 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... |
@@ -552,7 +603,7 @@ Dell¡.
 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
@@ -619,7 +670,7 @@ Proportional notation is supported.  Notes can be spaced proportional
 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 }
@@ -651,7 +702,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,
 
-@lilypond[fragment,raggedright,relative=2]
+@lilypond[fragment,ragged-right,relative=2]
 \override TupletBracket
  #'edge-text = #(cons
              (markup #:arrow-head X LEFT #f)
@@ -682,7 +733,7 @@ These glyphs have been sponsored by Trevor Bača.
 @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