X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Ftopdocs%2FNEWS.tely;h=da63646e8738ef1209fee82293561e9c483d25f0;hb=e0e7ae9d391b2e393419182f8adb359b01cbe838;hp=3881fdbe9fb8a47493b7fd68656046342e021c59;hpb=586ea345c041a123e038996bb998d46e75c2530a;p=lilypond.git diff --git a/Documentation/topdocs/NEWS.tely b/Documentation/topdocs/NEWS.tely index 3881fdbe9f..da63646e87 100644 --- a/Documentation/topdocs/NEWS.tely +++ b/Documentation/topdocs/NEWS.tely @@ -4,10 +4,10 @@ @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} -@inforef{\NAME\,,../../user/out-www/lilypond/lilypond}@c +@inforef{\NAME\,,../user/lilypond/lilypond}@c @end macro @end ifhtml @@ -31,431 +31,169 @@ See user manual, \NAME\ @documentencoding utf-8 @documentlanguage en +@finalout + @ifnottex @node Top @top @end ifnottex -@unnumbered New features in 2.7 since 2.6 +@unnumbered New features in 2.9 since 2.8 @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 -@item -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] -<< -\relative { c4 c c c } -\figures { - \set useBassFigureExtenders = ##t - <6+ 4 3> <6 4 3> <4 3+> <5/ 7/\+> -} >> -@end lilypond - -This rewrite was sponsored by Trent Johnston and John Mandereau. - -@item -For each grob, a subproperty in @code{callbacks} property defines the -procedure which computes it. This is major internal cleanup, which -also provides advanced tweakability for power users. For example, - -@verbatim -\override Beam #'callbacks #'direction - = #(lambda (grob) - (if (> 4 (ly:grob-array-length (ly:grob-object grob 'stems))) - DOWN - UP)) -@end verbatim - -@noindent -With this code fragment, the direction of a beam is decided to be up -or down, depending on the number of stems in the beam. -@item -Subproperties, like the @code{details} field of @code{Slur} and -@code{Tie} may now be tuned with @code{\override}. For example, - -@verbatim -\override Stem #'details #'beamed-lengths = #'(4 4 3) -@end verbatim - -@noindent -shortens the stems in beams. +@ignore -@item -The default paper size may now be set from the command line using -@code{-dpaper-size}. - -@item -Beamlets may stick out of the side of beams. +HINTS +* only show verbatim input for syntax/input changes -@lilypond[fragment,raggedright,relative=2] -{ - \override Beam #'break-overshoot = #'(-0.5 . 0.5) - \set stemLeftBeamCount = #2 - c8[ - c16 - \set stemRightBeamCount = #3 - c ] -} -@end lilypond +* try to be as brief possible in those cases -This feature was sponsored by Trevor Bača. - - - -@item -Vertical alignments of staves can now be tuned easily for individual -systems. - -@lilypond[raggedright] -#(set-global-staff-size 13) -\relative c'' << - \new PianoStaff << - \new Voice { - c1 - - \overrideProperty - #"Score.NonMusicalPaperColumn" - #'line-break-system-details - #'((fixed-alignment-extra-space . 15)) - c - - } - { - c1\break - c\break - } - >> ->> -@end lilypond +* don't try to provide real-world examples, they often get too big, +which scares away people. -This feature was sponsored by Nicolas Sceaux. +* Write complete sentences. -@item -Vertical spacing for page layout can now be tuned for each system -individually. The dimensions that can be tuned can be visualized. - -@lilypond[verbatim] -#(set-default-paper-size "a7" 'landscape) -\book { - \score { { c4 } } - \paper { annotatespacing = ##t } -} -@end lilypond +* only show user-visible changes. -These features were sponsored by Trevor Bača and Nicolas Sceaux. +@end ignore @item -The slope of a stem-tremolo may be set manually - -@lilypond[fragment,relative=1,raggedright] -c8:16[ -\once \override StemTremolo #'slope = #0.45 -c:16 c:16 c:16 ] -@end lilypond - -This feature was sponsored by Sven Axelsson. +Beams may be put on isolated stems, and beamlets may be paired by +setting the @code{max-beam-connect} property, -@item -Laissez vibrer ties can be created with @code{\laissezVibrer}, - -@lilypond[fragment,raggedright,relative=1] - \laissezVibrer r \laissezVibrer +@lilypond[ragged-right,relative=2,fragment] + \override Stem #'max-beam-connect = #1 + c16[ c16] c32[] @end lilypond -This feature was sponsored by Henrik Frisk. - -@item -The order of words in @code{\markup} commands may now be reversed by -setting the @code{text-direction} property. This is useful for -Right-to-Left languages like Hebrew. - -This feature was sponsored by Aaron Mehl. +This feature was sponsored by Trevor Bača. @item -Texts over multi measure rests can stretch the corresponding measure, -if the appropriate @code{spring-and-rods} callback is set. +Beaming patterns obey the @code{beatGrouping} property. -@lilypond[relative=2,fragment,raggedright] -\override MultiMeasureRestText #'callbacks #'springs-and-rods - = #Multi_measure_rest::set_text_rods -c1 R1 R1^"Very long long long text" +@lilypond[ragged-right,relative=2,fragment] + \time 5/16 + \set beatGrouping = #'(2 3) + c8[^"(2+3)" c16 c8] + \set beatGrouping = #'(3 2) + c8[^"(3+2)" c16 c8] @end lilypond -This feature was sponsored by Kris Shaffer. - - -@item @textanchor{tie-chords} -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 +This feature was sponsored by Trevor Bača. -@lilypond[relative=2, fragment,raggedright] - ~ - - \override TieColumn #'tie-configuration = - #'((0 . -1) (2 . -1) (5.5 . 1) (7 . 1)) - ~ -@end lilypond +@item +A new command @code{\transposedCueDuring} has been added which overrides +the cue's transposition locally. Its intended use is to octavate cues +up or down to avoid an excessive number of ledger lines. The syntax form +is -This improvement has been sponsored by Bertalan Fodor, Jay Hamilton, -Kieren MacMillan, Steve Doonan, Trevor Bača, and Vicente Solsona -Dell¡. +@example +\transposedCueDuring #NAME #UPDOWN PITCH MUSIC +@end example @item -Formatting of isolated, single ties has been improved. Now, ties avoid -staff lines, flags and dots, without compromising their shape. +By setting @code{hairpinToBarline}, hairpins will stop at +the barline preceding the ending note. -@lilypond[fragment,raggedright] -\relative c'' { - \stemUp - c16 c2...~ c16 ~ c2... | - c4~c8 c8~c16 c16~c32 c16.~[ c64]~ c64[ c8..] | -} +@lilypond[relative=2,fragment,ragged-right] +\set hairpinToBarline = ##t +\override Hairpin #'bound-padding = #1.0 +c4\< c2. c4\! @end lilypond -This improvement has been sponsored by Bertalan Fodor, Jay Hamilton, -Kieren MacMillan, Steve Doonan, Trevor Bača, and Vicente Solsona -Dell¡. - +This feature was sponsored by Andrew Sidwell and Trevor Bača. -@item @textanchor{repeat-counter} -With the @code{countPercentRepeats} property, -percent repeats get incremental numbers to indicate the accumulated repeat count. - -@lilypond[relative=2,fragment,raggedright] -\set countPercentRepeats = ##t -\repeat percent 4 { c1 } -\time 2/4 -\repeat percent 4 { c2 c2 } -@end lilypond - -This feature was sponsored by Yoshinobu Ishizaki - @item -Text scripts such as fingering instructions and dynamics avoid -collisions with slurs - -@lilypond[fragment,relative=1] +Objects may be rotated using the @code{rotation} property. +@lilypond[ragged-right,fragment,relative=1] { - b_1( f'_1_2_3 c_3_4_5 a) - b( f'\p b,) - c-2_\markup { \italic {"cresc."}} ( f_\markup {x} c) + \override Hairpin #'rotation = #'(20 -1 0) + g4\<^\markup { \rotate #180 "test" } b d f'\! } @end lilypond -@item -Tuplets can be made to reach the next non-tuplet note by setting the -@code{tupletFullLength} property, +This feature was contributed by Erlend Aasland. -@lilypond[fragment,relative=2] -\new Voice \with { - \remove Forbid_line_break_engraver - allowBeamBreak = ##t -} +@item +Hairpins now support circled tips (al niente notation). +@lilypond[ragged-right,fragment,relative=2] { - \set Score.proportionalNotationDuration = #(ly:make-moment 1 32) - \set tupletFullLength = ##t - \times 2/3 { c8[ c c] } - c4 + \override Hairpin #'circled-tip = ##t + c2\< c\! + c4\> c\< c2\! } -@end lilypond - -This feature was sponsored by Trevor Bača. - -@item -When @code{strict-note-spacing} is set, notes are spaced without regard -for clefs, bar lines, and grace notes. For example, - -@lilypond[fragment,relative=2] -\override Score.SpacingSpanner #'strict-note-spacing = ##t -\new Staff { c8[ c \clef alto c \grace { c16[ c] } c8 c c] c32[ c32] } @end lilypond -This feature was sponsored by Trevor Bača. - -@item -Beams support the @code{break-overshoot} property, for example - -@lilypond[relative=2,fragment] -\set allowBeamBreak = ##t -\override Beam #'break-overshoot = #'(1.0 . 2.0) -c2.. c8[ \break c] -@end lilypond - -This feature was sponsored by Trevor Bača. - -@item -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] -<< - \set Score.proportionalNotationDuration = #(ly:make-moment 1 16) - \new Staff { c8[ c c c c c] c4 c2 r2 } - \new Staff { c2 \times 2/3 { c8 c c } c4 c1 } ->> -@end lilypond - -This feature was sponsored by Trevor Bača. +This feature was contributed by Erlend Aasland. @item -Symbol sizes (e.g. accidentals) are disregarded for spacing if -@code{uniform-stretching} of the @code{SpacingSpanner} grob is set, - - -@lilypond[relative=2,fragment] -<< - \override Score.SpacingSpanner #'uniform-stretching = ##t - \new Staff { c16[ c c c c c c c c c16] } - \new Staff { - \times 6/7 { c16 c c cis c c c } - c8[ c32 c32 c16] - } ->> -@end lilypond +The MusicXML convertor has been sped up, and has rudimentary support +for percussion notation. It will also condense multi-bar rests to +enable part extraction. -This feature was sponsored by Trevor Bača. - @item -Endings of broken tuplet brackets can be tuned. For example, you can -add arrows to the brackets, - -@lilypond[fragment,raggedright,relative=2] -\override TupletBracket - #'edge-text = #(cons - (markup #:arrow-head X LEFT #f) - (markup #:arrow-head X RIGHT #f)) -\times 4/5 { - c c c \bar "empty" \break c c -} -@end lilypond - -This feature was sponsored by Trevor Bača. +The beam printing code has been completely rewritten, and now includes +support for feathered beaming, - -@item @textanchor{arrow-glyph} -Arrow heads were added to the Feta font. - -@lilypond[] -\lyrics { - \markup { - filled, to the right: \hspace #2.0 \fontsize #6 \arrow-head #0 #1 ##t - open, down: \hspace #2.0 \fontsize #6 \arrow-head #1 #-1 ##f - } +@lilypond[ragged-right,fragment,relative=2] +\featherDurations #(ly:make-moment 5 4) +{ + \override Beam #'grow-direction = #LEFT + c16[ + c c c + c c c c ] } -@end lilypond - -These glyphs have been sponsored by Trevor Bača. +@end lilypond +This feature was sponsored by Jamie Bullock. @item -Nested tuplets are automatically positioned, +The @code{\note} markup command now also accepts note head styles. -@lilypond[fragment,raggedright,relative=2] -\set tupletNumberFormatFunction = #fraction-tuplet-formatter -\times 4/6 { - a4 a - \times 3/5 { a a a a a } +@lilypond[ragged-right,fragment,relative=2] +c4^\markup { + \override #'(style . triangle) \note-by-number #2 #1 #1 = 100 } @end lilypond -This feature was sponsored by Trevor Bača. - -@item -Music expressions can be displayed, in LilyPond notation, using the -new @code{\displayLilyMusic} function. For instance: -@verbatim -\displayLilyMusic \transpose c a, { c d e f } -@end verbatim -will print: -@verbatim -{ a, b, cis d } -@end verbatim - -This feature was contributed by Nicolas Sceaux. +This feature was sponsored by Jamie Bullock. @item -The current bar number may be checked with @code{\barNumberCheck}, eg. +Tie chord formatting also works with arpegiated +ties. -@verbatim -\barNumberCheck #22 -@end verbatim - -@noindent -will print a warning if it doesn't happen in measure 22. - -@item -If @code{showLastLength} is set, only the last few measures of a piece -are rendered, which speeds up correcting scores. For example, setting - -@verbatim -showLastLength = R1*5 -\score { ... } -@end verbatim - -@noindent -will render only the last five measures (assuming 4/4 time signature) -of a piece. - -@item @textanchor{simple-melismata} -Melismata can be specified simply in the lyrics now, eg. - -@lilypond[relative=1,verbatim,fragment] -{ - c d( e) f e d -} \addlyrics { - Ky -- _ _ ri e +@lilypond[ragged-right] +\relative c'' { + 2~ | + \set tieWaitForNote = ##t + e8~ c~ a~ f~ 2 | + f,8~ a~ c~ e~ 2 | } -@end lilypond - -This feature was sponsored by Nancho Alvarez - -@item -Suggested accidentals (for notating musica ficta) may be switched on -with @code{suggestAccidentals} - -@lilypond[verbatim,fragment,relative=2] -\set suggestAccidentals = ##t -ais bis -@end lilypond - -This feature was sponsored by Nancho Alvarez. +@end lilypond -@item -The setting @code{whichBar} and time-bookkeeping is now split into a -@code{Default_bar_line_engraver} and @code{Timing_translator} -respectively. -@item @textanchor{pitched-trill} -Explicit pitches may be added to trills, +This feature was sponsored by Steve Doonan. -@lilypond[relative,verbatim,fragment] - \pitchedTrill c4\startTrillSpan fis f\stopTrillSpan -@end lilypond -This feature was sponsored by D. Josiah Boothby and Jamie Bullock +@end itemize -@item -Markup now supports formatting of text paragraphs, using -@code{\wordwrap} and @code{\justify}. -This feature was sponsored by Sven Axelsson. -@end itemize @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.8/Documentation/topdocs/NEWS.html}, +or @uref{../,go back} to the Documentation index. + + @end ifhtml @bye