]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/topdocs/NEWS.tely
Merge branch 'lilypond/translation' of ssh://trettig@git.sv.gnu.org/srv/git/lilypond...
[lilypond.git] / Documentation / topdocs / NEWS.tely
index 1fef780d486586484d9eb1693d11b5c858edf783..f4c832cb2a6ed0e7ddcf6ed89fcf04e9c041cbb4 100644 (file)
@@ -1,13 +1,13 @@
-\input texinfo @c -*-texinfo-*-
+\input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
 @setfilename NEWS.info
 @settitle NEWS
 
 @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
 
@@ -20,7 +20,6 @@ See user manual, \NAME\
 @end macro
 @end ifnothtml
 
-
 @macro textanchor{NAME}
 @html
 <a name="\NAME\"></a>
@@ -31,14 +30,17 @@ 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.11 since 2.10
 
 @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
 
 
@@ -46,282 +48,224 @@ This document is also available in @uref{NEWS.pdf,PDF}.
 
 @itemize @bullet
 
+@ignore
 
-@item
-Texts over multi measure rests can stretch corresponding measure, if
-the appropriate @code{spacing-procedure} property is set.
+HINTS
 
-@lilypond[relative=2,fragment,raggedright]
-\override MultiMeasureRestText #'spacing-procedure
-  = #Multi_measure_rest::set_text_rods
-c1 R1 R1^"Very long long long text" 
-@end lilypond
+* only show verbatim input for syntax/input changes
 
-This feature was sponsored by Kris Shaffer.
+* 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.
 
-@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
+* Write complete sentences.
 
-@lilypond[relative=2, fragment,raggedright]
-  <a c d f> ~ <a c d f>
-  
-  \override TieColumn #'tie-configuration =
-  #'((0 . -1)  (2 . -1) (5.5 . 1) (7 . 1))
-  <b d f g> ~ <b d f g>
-@end lilypond
+* only show user-visible changes. 
 
-This improvement has been sponsored by Bertalan Fodor, Jay Hamilton,
-Kieren MacMillan, Steve Doonan, Trevor Baca, and Vicente Solsona
-Dellá.
+@end ignore
 
 @item
-Formatting of isolated, single ties has been improved. Now, ties avoid
-staff lines, flags and dots, without compromising their shape.
+Arpeggios may now use ``parenthesis'' style brackets:
 
-@lilypond[fragment,raggedright]
-\relative c'' {
-  \stemUp
-  c16 c2...~ c16 ~ c2... |
-  c4~c8 c8~c16 c16~c32 c16.~[ c64]~ c64[ c8..] |
-}
-@end lilypond
+@lilypond[relative,ragged-right]
+  \override Arpeggio #'stencil = #ly:arpeggio::brew-chord-slur
 
-This improvement has been sponsored by Bertalan Fodor, Jay Hamilton,
-Kieren MacMillan, Steve Doonan, Trevor Baca, and Vicente Solsona
-Dellá.
-
-@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 }
+  % Note: does not work for cross staff arpeggios.
+  \override Arpeggio #'X-extent = #ly:grob::stencil-width
+  <c g' c>2\arpeggio ~ c
 @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]
-{
-  b_1( f'_1_2_3 c_3_4_5 a)
-  b( f'\p b,)
-  c-2_\markup { \italic {"cresc."}} ( f_\markup {x} c)
-}
-@end lilypond
+Enclosing text within boxes with rounded corners is now possible,
+using the @code{rounded-box} command.
 
 @item
-Tuplets can be made to reach the next non-tuplet note by setting the
-@code{tupletFullLength}  property,
-
-@lilypond[fragment,relative=2]
-\new Voice \with {
-  \remove Forbid_line_break_engraver
-  allowBeamBreak = ##t
-}
-{
-  \set Score.proportionalNotationDuration = #(ly:make-moment 1 32)
-  \set tupletFullLength = ##t
-  \times 2/3 { c8[ c c] }
-  c4
-}
-@end lilypond  
-
-This feature was sponsored by Trevor Baca. 
+@command{lilypond-book} can run any program instead of @command{latex}
+to guess the line width, thanks to @code{--latex-program} command line
+option.
 
 @item
-When @code{strict-note-spacing} is set, notes are spaced without regard
-for clefs, bar lines, and grace notes. For example,
+@code{\setEasyHeads} has been renamed to @code{\easyHeadsOn}, and a new
+command @code{\easyHeadsOff} reverts note heads to normal heads.
 
-@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
+@item
+@code{\fatText}, @code{\emptyText} and @code{\compressMusic} have been
+renamed to @code{\textLengthOn}, @code{\textLengthOff} and
+@code{\scaleDurations}, respectively.
 
-This feature was sponsored by Trevor Baca. 
+@item
+Underlining is now possible with the @code{\underline} markup command.
 
 @item
-Beams support the @code{break-overshoot} property, for example
+It is now possible to specify, using the @code{page-count} variable in
+the paper block, the number of pages that will be used.
 
-@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 Baca. 
+@item
+A new page breaking function, @code{ly:minimal-breaking}, is dedicated
+to books with many pages or a lot of texts.
 
 @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
+A table of contents is included using @code{\markuplines \table-of-contents}.
+Elements are added to it using the @code{\tocItem} command.
 
-This feature was sponsored by Trevor Baca.
+@item
+Text spreading over several pages is entered using the
+@code{\markuplines} keyword. Builtin markup list commands, such as
+@code{\justified-lines} or @code{\wordwrap-lines} may be used, and new
+ones created using the @code{define-markup-list-command} Scheme macro.
 
-@item 
-Symbol sizes (e.g. accidentals) are disregarded for spacing if
-@code{uniform-stretching} of the @code{SpacingSpanner} grob is set,
+@item
+Particular points of a book may be marked with the @code{\label}
+command. Then, the page where these points are placed can be refered to
+using the @code{\page-ref} markup command.
 
+@item
+Page breaking and page turning commands (@code{\pageBreak},
+@code{\noPageBreak}, etc) can be used at top-level, between scores and
+top-level markups.
 
-@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
+@item
+The following options are now changed as a @code{-d} sub-option:
+@code{--backend}, @code{--safe}, @code{--preview} and
+@code{--no-pages} (which became @code{-dno-print-pages}).  The @code{-b}
+option does not exist any more.
 
-This feature was sponsored by Trevor Baca.
 @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
+Improved testing procedure now catch changes in CPU and memory
+performance, page layout, MIDI results and warnings.  This helps to
+reduce the number of regression errors during development, resulting
+in more stable releases.
 
-This feature was sponsored by Trevor Baca.
+See @uref{INSTALL.html#testing} for more information.
+@item
+Nested properties, such as @code{details} in @code{Slur}, can be
+reverted as well.  The syntax for this is
 
+@example
+\revert Slur #'(details closeness-factor)
+@end example
 
-@item @textanchor{arrow-glyph}
-Arrow heads were added to the Feta font.
+@item
+All line spanners are more flexible now in the configuration of
+their end points.  This includes glissando, voice followers, text
+crescendos and other text spanners.  The old syntax for setting
+text on line spanners is no longer valid.
 
+@c  with ragged-right we can't see the gliss.
 @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
-  }
+\relative c'' {
+  \override Glissando #'bound-details #'right #'text = \markup { \hcenter \bold down }
+  \override Glissando #'bound-details #'right #'Y = #-4
+  \override Glissando #'bound-details #'right #'padding = #0.0
+  \override Glissando #'bound-details #'left #'arrow = ##t
+  \override Glissando #'bound-details #'left #'padding = #3.0
+  \override Glissando #'style = #'trill
+  
+  c1 \glissando c'
 }
 @end lilypond
 
-These glyphs have been sponsored by Trevor Baca.
-
+This feature was sponsored by Trevor Bača.
 
 @item
-Nested tuplets are automatically positioned,
+The environment variable LILYPONDPREFIX has been renamed to
+LILYPOND_DATADIR.
 
-@lilypond[fragment,raggedright,relative=2]
-\set tupletNumberFormatFunction = #fraction-tuplet-formatter
-\times 4/6 {
-  a4 a 
-  \times 3/5 { a a a a a }
+@item
+Notes or rests, such as a typical end note, that fill an entire
+measure are preceded by some more space.
+
+@lilypond[ragged-right]
+\relative c' {
+  \time 4/4
+  s1
+  c2. c4
+  \time 3/4
+  c2.
 }
 @end lilypond
 
-This feature was sponsored by Trevor Baca.
-
-@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.
+@item All @code{\score}s in a lilypond-book fragment are now inserted
+into the document. Also, toplevel markups don't result in an entire
+page.
 
-@item
-The current bar number may be checked with @code{\barNumberCheck}, eg.
+@item Alterations (such as a sharp and flat) may now be arbitrary
+fractions. This allows some forms of microtonal music.  For example,
+Turkish makam music uses 1/9th tone alterations.
 
-@verbatim
-\barNumberCheck #22
-@end verbatim
+@lilypondfile{makam.ly}
 
-@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 Tie directions may be set with @code{^~} and @code{_~}
 
-@item @textanchor{simple-melismata}
-Melismata can be specified simply in the lyrics now, eg.
+@item Tablature now supports harmonics and slides,
 
-@lilypond[relative=1,verbatim,fragment]
+@lilypond[fragment,ragged-right,relative=1]
+\new TabVoice
 {
-  c d( e) f e d
-} \addlyrics {
-  Ky -- _ _ ri e
+    <c g'\harmonic> d\2\glissando e\2
 }
-@end lilypond 
+@end lilypond
 
-This feature was sponsored by Nancho Alvarez 
+This feature was sponsored by Mike Amundsen
 
-@item
-Suggested accidentals (for notating musica ficta) may be switched on
-with @code{suggestAccidentals}
+@item Horizontal spacing now follows object outlines more
+accurately. This allows tighter horizontal spacing.
 
-@lilypond[verbatim,fragment,relative=2]
-\set suggestAccidentals = ##t
-ais bis
-@end lilypond 
+@lilypond[fragment,ragged-right]
+{
+  \stemUp c''4...*1/2
+  ceses'!
+}
+@end lilypond
 
-This feature was sponsored by Nancho Alvarez.
 
-@item
-The setting @code{whichBar} and time-bookkeeping is now split into a
-@code{Default_bar_line_engraver} and @code{Timing_translator}
-respectively.
+@item Objects that belong outside of the staff are
+now positioned automatically to avoid collisions.
 
-@item @textanchor{pitched-trill}
-Explicit pitches may be added to trills,
+@lilypond[fragment,ragged-right,relative=1]
+  c''
+  \once \override TextScript #'self-alignment-X = #CENTER
+  a,^"this doesn't collide with the c"
+  b^"this goes above the previous markup"
+  a8_"this goes below the dynamic"
+  a\f
+@end lilypond
 
-@lilypond[relative,verbatim,fragment]
-  \pitchedTrill c4\startTrillSpan fis f\stopTrillSpan
-@end lilypond 
+@item Staves are spaced vertically using a skyline algorithm. This helps to avoid
+uneven vertical spacing.
 
-This feature was sponsored by D. Josiah Boothby and Jamie Bullock
+@lilypond[ragged-right]
 
-@item
-Markup now supports formatting of text paragraphs, using
-@code{\wordwrap} and @code{\justify}.
+%% todo: fix 'landscape PDF.
+#(set-default-paper-size "a6" )
+\header {
+  tagline = ##f
+}
+
+\book {
+  \score {
+    {
+      a,,1 | a'4 b' c'' d'' \break
+      \repeat unfold 2 {a' b' c'' d''} | b''''1
+    }
+  }
+}
+@end lilypond
 
-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.10/Documentation/topdocs/NEWS.html},
+or @uref{../,go back} to the Documentation index.
+
+
 @end ifhtml
 
 @bye