@ifhtml
@macro inputfileref{DIR,NAME}
-@uref{../../../\DIR\/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/lilypond/lilypond}@c
+@inforef{\NAME\,,../user/lilypond/lilypond}@c
@end macro
@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[raggedright]
+@lilypond[ragged-right]
\new Staff \relative c' {
\override Staff.StaffSymbol #'line-positions = #'(-7 -2 0 7)
g c f b e a
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
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
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
@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
@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.
@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
It's now possible to easily create deeply nested system start
delimiters,
-@lilypond[raggedright]
+@lilypond[ragged-right]
\new StaffGroup
\relative <<
\set StaffGroup.systemStartDelimiterHierarchy
,(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
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
@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
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
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 <<
@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 ]
@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
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
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 =
- #'((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
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... |
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
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 }
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)
@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
projects / lilypond.git / blobdiff