Release: update news.

PO: update template.

Update essay to correct display of articulations

Issue 3151: NR 3.4.1: \layout block wrongly placed in a \book block causes error

Issue 3305: footnote-footer-padding is not considered correctly

Sign error because of self-defeatingly clever use of ?: operator.
This patch does not cure the obfuscation, merely fixes the resulting
error.

Fixes images on examples page (Issue 3298)

web: fix engraving errors in Bach BVW610

1) tempo should be written using \tempo, not as a text
attached to notes (because TextScript has wrong font
and alignment for a tempo mark)

2) upper and lower voices should use \voiceXXX commands,
to make sure that all elements havee their directions set
properly (here, dots in lower voice were incorrectly up)

Add an explanatory comment regarding session-handling to scm/lily.scm

Use call-after-session to clear out hashes per session at an obvious place.

Issue 3283: Stop table of contents bleedover

Issue 3294: Define call-after-session for cleanup called after every file

Issue 3291: Carry any exports from session initialization over to subsequent sessions

When a .ly file in the session initialization loaded a module, this
module's exports were only available in the first session on the
command line.  This patch causes any modules available after first
session initialization to be available in subsequent sessions.

Issue 3296: Move Tweak_engraver to Score level

This makes it possible to tweak items announced at Score level, like
MetronomeMark and RehearsalMark.

The advantage is that tweaks will be applied once regardless of the
context structure (the Score context should exist only once).

Due to the hierarchical nature of acknowledgers, acknowledgers in
lower contexts will now get to see the grobs before tweaks have been
applied.  However, grobs are still unfinished (except for type,
properties initialized via context properties and cause) at the time
they are announced, with other details only getting filled in by the
engraver after announcement, so the potential for trouble seems low.
Acknowledgers should usually just register a grob (or write grob data)
with any actual reading of grob data occurring at the end of the
timestep instead.

Titling:  first/last page of book; issue 2794

First page format only on first page of a book,
and tagline only on last page of a book.

Doc: typo (3302)

Revert "Avoid excessive number of dots in chords (#3179)."

This reverts commit f0fbdb3f07ef9028c6a256b9e1fd1db217ef8799.

Conflicts:

input/regression/chord-dots.ly

Run scripts/auxiliar/makelsr.py

Fix snippet engravers-one-by-one in the wake of issue 3225

Hairpin minimum-length has not effect at end of line; issue 2785.

Fixes the springs and rods callback so that broken left items and
center items are used as potential bounds of spanners, which allows
both cases to be considered in the simple spacer when scoring line breaking
configurations.

Updates version numbers in new regtests

Make dynamics "inside-staff" grobs in the dynamics context; issue 3241.

Even though dynamics contexts have no staffs, we treat them as "in staff"
material because they are in the core of the vertical axis group.

This classification prevents potential problems of having nothing considered
on the inside of these vertical axis groups.

Break slurs between alternative endings in repeats; issue 1698.

Create new event-types BreakPhrasingSlurEvent BreakSlurEvent,
and a music-function \free so that users can create them.
Create these event-types in the volta-repeat-iterator to break
slurs between alternatives in a \repeat volta structure.

Issue 3117: Markup/string identifiers in lyrics cause an error

This fix just addresses markup/string identifiers within music lists.
The syntax did already cater for function arguments previously.

Add Changes entries for \absolute and \relative { ... }

Document \relative { ... } and \absolute { ... } behavior

Issue 3245: Make \relative { ... } interpret the first pitch as an absolute one

The previous default of \relative { ... } being \relative c' { ... }
made c' more special than warranted.  Having to write
\relative f { ... } for this functionality seems awkward since f
serves no musical function but just happens to be the middle of the
scale.  Iff the scale is the standard scale.  The new definition of
\relative takes care to determine the "middle of the scale" reference
point properly even in the case of non-standard scales.

Issue 3274: Restructure parsing of reverts to avoid ambiguities in relation to BACKUP

A music expression could start with BACKUP (an artificially inserted
token never present in the source code itself) due to the previous
rules.  If the BACKUP mechanism is needed in different unrelated rules
applicable in similar contexts, this can lead to shift/reduce
conflicts.

While the actual (separate) code prompting this issue was rewritten in
a manner reining its BACKUP tokens in on its own and thus avoiding the
conflict triggering this issue, it still makes sense to confine the
range where BACKUP tokens are recognized to the actual limited
contexts where they are being produced, in order to keep such
conflicts down, and to stop the parser from creative reinterpretation
of situations that can only arise by programmer error.

Issue 3282: Add Changes entries for \temporary, \omit, \hide, \single, multiple tags

Issue 3270: Allow unbraced forms of composed markup lists

Since composing markup lists may now work at run time, there is no
particular need for the associated syntactic restrictions.

Allow markup lists to be composed at run-time

Using a markup command on a markup list generated by a markup list
command was not previously possible.  Now things like

  \with-color #red { \column-lines { x y z } }

work as well.

Move map-markup-command-list into parser internals

Simplify interpret-markup-list

Use fold in map-markup-command-list

Text_interface::is_markup should reject markup-list-command calls

Issue 3290/2: \context -> \new in fretted-strings.itely

The combination

   \context FretBoards ...
   \context Staff

ends up in the same context due to FretBoards being an alias for
Staff.  To avoid inconsistencies, not just those occurences of
\context which are really necessary are replaced.

Issue 3290: Appendix 4, Predefined fretboard diagram: wrong chords are displayed

Add Anders Pilegaard to contributors

Corrects version number of input/regression/fingering-column-snap-radius.ly

Aligns horizontally-offset fingerings in a column if X distance is small (issue 3269)

Uses a new property snap-radius to "snap" fingerings into alignment if they
look like they naturally belong in a column.

Issue 1100: \line inside \concat should keep its 'word-space

Fixes relative updates to ancient music - Issue 3228

Remove spurious empty TextScripts from regtests

Release: bump version.

Add version to NoTagline.ly to fix GUB build

Release: update news.

PO: update template.

CG updates describing master of picture files

Adds better comment for side-position-interface

Revert "Uses special X alignment for instrument names."

This reverts commit 6e4e69f2735a764eab2e6f70f83546461da0203b.

CG changes for pixel regtest script

Uses special X alignment for instrument names.

Previously, instrument names used the side-position-interface for
calculations in its alignment function.  This made no sense, as it never
had any side-support elements, requiring a kludge to get them to
align properly.

Here, we remove that kludge and align them by aligning them to their
right end and adding padding.  We also change the name of the grob array
in which vertical axis groups are stored to
system-start-text-align-elements so that the grob is not accidentally
treated as an axis-group implementing an elements array.

Uses correct markup column commands to align text.

Issue 2922: \keepWithTag - update the existing docs in the manual to reflect new changes

Issue 3271: Provide \absolute music function to complement \relative

From its documentation string:

Make @var{music} absolute.  This does not actually change the
music itself but rather hides it from surrounding @code{\\relative}
commands.

Adds hairpins from Ferneyhough scores to LilyPond.

The two new commands are:

  * flared-hairpin. Creates a hairpin that is skinny for the bulk
    of its duration and has a flare at the end.
  * constante-hairpin. Creates a hairpin maintaining a dynamic over
    a duration.

Don't report a programming error when aligned grob has empty extent.

(Issue 3259)

If a grob's extent is empty (undefined), alignment procedures from
Self_alignment_interface don't have any information about grob's
dimensions, so they cannot calculate the offset required to achieve
specified alignment of such grob.

However, this isn't actually a problem: if a grob's extent is empty,
this usually means that the grob itself is empty, and in that case
there is nothing to align at all.  Therefore, no programming error
should be reported.

For example, a user may remove some grob from output by overriding
its stencil to #f.  This will result in an empty extent, and Lily
shouldn't complain about being unable to align such grob, because
there is nothing to align.

Nevertheless, if the extent is empty but the stencil itself isn't
empty, the situation looks suspicious, so we issue a warning.

Remove unused include in break-alignment-interface (issue 3262)

Nothing from self-alingnment-interface was used in break alignment,
so no need to include its header.  This patch shouldn't change
anything in Lily behaviour.

Run scripts/auxiliar/makelsr.py

Issue 3261: regtest 'incipit.ly' compressed

After dimensions in \score markup have been fixed in issue 677,
several example of incipits in the LilyPond codebase were
overcompensating for the previous bug.  This fixes them.

Issue 3264: Let lilymidi display key signatures in a readable manner

Before this patch, key signatures were just displayed as a binary
string reflecting the Midi message.

Merge branch 'master' into translation

CG: note that CPU threads affect cell count in regtests (issue 3257)

Issue 3249: Make a PostEvents container class for packaging several postevents

Previously it was not possible to assign multiple postevents to a
single variable or pass them as the result of an event function.  This
patch wraps multiple events in such situations inside of a PostEvents
post-event and unwraps them when used again in the parser.

Defuse some open parens starting lines in strings in define-music-types.scm

Those confuse Emacs' heuristics and make it harder to edit subsequent
Scheme.

Remove obscure GNOME-backend related commands from Emacs LilyPond-mode

Those backends don't exist in current LilyPond.  Providing commands
for them is just confusing.

Issue 3251: set-default-paper-size bleeds over to subsequent file compilations

This patch lets set-default-paper-size copy $defaultpaper before
modifying it.  That way, restoring the original $defaultpaper at the
end of each processed file should also restore the paper dimensions.

Issue 2924: Doc: \startMeasureCount and \stopMeasureCount needs documenting

The following patch is a preliminary step towards documenting the
Measure_counter_engraver added in version 2.17.7.  The patch consists of
two snippets, the first illustrating basic usage, and the second demonstrating
a workaround for creating centered bar numbers.

Documents make-partial-ellipse-stencil (issue 3252)

Fixes manual beaming over rests and vertical spacing problem (issue 3242)

Script for running pixel-based regtest comparisons

Articulate.ly Perform single epression substitutio

Issue 3204

Perform single expression substitution

Adds an explanatory comment to skyline.cc.
 Author:    Janek Warchoł <lemniskata.bernoullego@gmail.com>

Changes Patch Handler to Patch Meister in the CG.

Permits all positive and zero-length buildings in skylines (issue 3161)

This allows point stencils to figure into vertical spacing, as shown
in the new regtest input/regression/skyline-point-extent.ly.

Some issues regarding floating point errors were raised while reviewing
this patch, but it was concluded that the math in this patch likely does
not risk triggering those errors with the way GCC compiles the code.

Run scripts/auxiliar/update-with-convert-ly.sh

Issue 3231: Make reference pitch for \relative non-optional

Using \relative without reference pitch has been deprecated for a long
time, so this change brings LilyPond's codebase (and files converted
using convert-ly) into conformance with recommended practices.

Issue 3244: Remove -d old-relative compatibility option

This removes the lily_1_8_relative variable and the code surrounding
it.  lily_1_8_relative_used apparently was unused; Scheme code for
interpreting its setting was not connected to the actual variable.

The callback for repeat-music was not actually being used and has been
removed.  While the command line option was still documented, it was
ineffective: only reenabling it in the file itself lead to any effect.

ly:relative-music::relative-callback and
ly:relative-music::no-relative-callback are now functionally
equivalent.

Issue 3247: Prohibit non-postevents returned by music functions to be used as post-events

For example,

{ c-\mark \default }

produced an invalid music expression more or less indistinguishable from

{ \mark \default c }

Worse is that things like

{ c-\tweak color #red { g } }

also got accepted.  While \tweak (and other music functions) may
indeed return either post-events or straight music expressions, there
should be checks in place that the usage corresponds to its type.

Make \balloonText into post-event, \balloonGrobText into proper event

This is a stopgap measure for getting some consistency into music
function use.  The real fix would be to convert \ballonText and
\balloonGrobText to the same kind of interface that \footnote uses.
Indeed, it might be saner to retire the whole AnnotateOutputEvent
folderol and instead just use footnotes without footnote-text.

configure: Fixup default --prefix replacement (issue 3238).

Fixup the default prefix replacement in aclocal.m4 while
handling all possible combinations of --exec-prefix and
--prefix being specified or not.

The following is a diff of the resulting config.status
before/after this patch:

$ diff config.status.backup config.status
806c806
< D["DATADIR"]=" \"NONE/share\""
---
> D["DATADIR"]=" \"/usr/local/share\""
808c808
< D["LIBDIR"]=" \"NONE/lib\""
---
> D["LIBDIR"]=" \"/usr/local/lib\""

configure: Check for mfplain.mp (issue 3233).

./configure is now checking if required metapost files are
installed on the system. Metapost is a required dependency.
Also, kpsewhich isn't optional anymore, since we rely on it
to check for metapost required files.

LSR updates

Issue 3237: Harmonize point-and-click information for #xxx and $xxx

Both #xxx and $xxx now retain any preexisting origin information when
producing a music expression.  In contrast, \xxx continues receiving
the origin information pertaining to the current location even if
previous point-and-click information exists.  This is consistent with
the point-and-click information for music functions as a whole
corresponding to the point of call, while the individual arguments, if
separate music expressions, retain any preexisting origin.

Make midiMaximumVolume take effect without initial dynamic

Issue 3234

My idea is to ensure that the volume is *always* initialised in
Dynamic_performer::process_music.  The code to do that is mostly
copied from what happens if there is an actual script event.

The constant 0.71 was obtained by calculating backwards from the
default velocity value (0x5a) in the Midi_note constructor,
midi-item.cc line 179.

I found that I had to create and announce an Audio_element_info for
the change to take effect.

Backward compatibility notes
----------------------------

As far as the music itself goes there are a few cases:

 - Music that doesn't set midiMaximumVolume or midiMinimumVolume will
   be unchanged, as the default dynamic setting is chosen so the
   calculated midi velocity is the same as the current default when no
   volume is set.

 - Music that sets midiMaximumVolume or midiMinimumVolume and has
   initial dynamic expressions will be unchanged - the explicit
   dynamic takes effect before the first midi note is created.

 - Music that sets midiMaximumVolume or midiMinimumVolume but doesn't
   have an initial dynamic expression will change.  In the current
   version such would be an error, so I don't expect many of those.

Change \transpose c c' syntax to \relative c' syntax in examples in the ancient notation chapter of notation manu
Author:    Aleksandr Andreev <aleksandr.andreev@gmail.com>

Doc-es: version markers for texidoc strings.

Revert "Issue 3203: Clean up bar-line.scm some more"

This reverts commit ebd9ee599bed31f19785c1b215ad1c716d071a46.

Release: bump version.

Doc-es: update CHANGES, Notation/Ancient, Changing Defaults, Texidoc strings.

Web-es: update NEWS.

Simplify a function pointer cast that GUB chokes on

It is conceivable that the C++ compiler has problems converting a
pointer to a C function (declared in a C language header) to a C++
function pointer.  Or that it has a compiler bug making it choke on
too complex casts.  This commit changes the cast

(SCM (*)()) apply_unpure_pure

to

(scm_t_subr) apply_unpure_pure

which hopefully addresses both of these potential candidates for GUB
compilation failure.

Release: update news.

PO: update template.

Web-fr: typos

Doc-fr: updates NR
 - changing default
 - ancient

Doc-fr: fix NR compile

Doc-es: fix another node name in Notation manual.

Doc-es: fix bad menu and node name.

Merge branch 'master' into translation

Adds Slur_proto_engraver as a base class for Slur_engraver and Phrasing_slur_engraver.