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.

Issue 3225: Decouple \defaultchild from \accepts list in contexts

The definition of a Bottom context previously was a context not
accepting any subcontexts.  Now it is a context without a
\defaultchild.  The defaultchild of a context previously was the first
found in the \accepts list (if necessary, moving it there).  While
\defaultchild was tracked in context definitions, it was not explicit
in instantiated contexts.

Decoupling those makes for more flexible arrangements of contexts.
For example, one might let Voice accept a SubVoice context without
forcing SubVoice to be created when a Bottom context is called for
when in Voice, simply by not giving Voice a \defaultchild.

Issue 3212: Make test-output-distance regtest contain span bars

Since span bars don't turn up in the metrics, the regtests don't show
them.  To make catastrophic span bar failures show up at least
somewhere, the ever-changing test-output-distance test is made to
include them.

Issue 1334: A \score-lines markup list command for multi-lines embedded scores

Like the \score markup, this is not usually called by users directly
as it would require something awkward along the lines of

\score-lines ##{ \score { ... } #}

to get this through.  Instead, using \score in contexts where only
markup lists are allowed will pass the action to the \score-lines
markup list command.

Note that there are as of yet no user-level commands spacing a markup
list in a way similar to the spacing inside of a \score markup.

Issue 3187: Ugly alignment of text and score within a markup

For \score within \markup, the reference point (usually the middle
staff line) of the lowest staff in the top system is placed on the
baseline.

This is an incompatible change, but the previous behavior (placing the
_highest_ y coordinate of the score on the baseline, disregarding the
staves) was not useful.

Doc-es: update Web/introduction, NEWS.

Complete Spanish translation of web and manuals, except snippets.

Doc-es: update Usage/lilypond-book.

Doc-es: update Notation/Rhythms, Simultaneous, Spacing, Text, Vocal.

Doc-es: update Changing Defaults, Cheatsheet, Editorial, Fretted, Repeats.

Doc-es: update Learning/Common notation, Fundamental, Tweaks, Notation/Ancient.

Doc-es: update CHANGES, essay/Engraving, extending/Programing, Scheme tutorial.

Issue 3205: opening bar check causes crash if \score contains the \midi block

This derives Bar_check_iterator from Music_iterator rather than from
Simple_music_iterator.

In
\score {
  { | d }
  \midi { }
}

the bar check iterator is being called while only the \Global context
exists.  That causes Score_performer::one_time_step to be called
without getting Score_performer::prepare to be called previously,
probably because the Score context is created at the wrong time.  The
Score_performer is not prepared for this situation.

I have no idea how to fix Simple_music_iterator, why it exists in the
first place and is written like it is, and why this appears to work.

Issue 3211: Let ly_deep_copy and ly_music_deep_copy iterate rather than recurse for lists

Also improves DOC string of ly:music-deep-copy.

ly_deep_copy did not actually copy vectors

Or actually, it copied them, threw the copy away and returned the original.

Uses only unpure-pure containers to articulate unpure-pure relationships (issue 3199)

Previously, LilyPond used several different lists in define-grobs.scm
to define relationships between unpure and pure functions.  This patch
eliminates these lists, using unpure-pure containers to articulate
these relationships.

The modifications required to implement this change are described below:

-) axis-group-interface.cc
A Scheme function is no longer needed to determine pure relevant grobs.
All grobs can have their Y-extents meaningfully pure-evaluated now. The
worst-case scenario is that they evaluate to false. Dead grobs, on the
other hand, are never pure relevant. The calls to is_live are the only
holdovers from the old pure-relevant? scheme function.

-) grob-closure.cc
We allow unpure-pure containers in simple closures.

-) grob-property.cc
call_pure_function no longer looks up a Scheme module. Because there are
no hard-coded lists in Scheme any more, the function is smaller and
writing it in C++ gets slight efficiency gains.

-) grob.cc
pure_stencil_height used to be a Scheme function in define-grobs.scm.
Because it is much simpler (it no longer makes references to lists defined
in Scheme), it can be implemented in C++.

-) pure-from-neighbor-engraver.cc
Similar to axis-group-interface.cc, the pure-relevant distinction is
no longer important.

-) side-position-interface.cc
In order to avoid issues with alterBroken, we only check pure properties
before line breaking.

-) simple-closure.cc
Simple closures were incorrectly evaluated when containing unpure-pure
containers. This rectifies that.

-) stencil-integral.cc
Several pure equivalent functions needed to be written for skylines.

-) define-grobs.scm
Multiple overrides must be changed to unpure-pure containers. Previous
hard-coded lists are all deleted and several functions moved to C++ (see
above).

-) output-lib.scm
Several common unpure-pure containers used in define-grobs.scm are
defined here. Several functions from define-grobs.scm pertaining to
grob offsets are moved to this file.

Prevents chord names from being pushed into the staff (issue 3160)

This is done by not removing empty skylines unless they are suicidable.
Proper space is thus reserved for these skylines in align-interface.cc.

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

This corrects the bad code from issue 3192

Adds subsection about Kievan ligatures to ancient notation section of notation manual.

Author: Aleksandr Andreev <aleksandr.andreev@gmail.com>

Emergency repair work for issue 3200

This went boom in the garbage mark phase when
ly:make-unpure-pure-container had been called with a single procedure
argument.

Doc-ja: fix building of LM

 ** closing @-command code

Doc-ja: update NR and others

Doc-ja: update NR and others.

Fixes annotate spacing (issue 3169)
Avoids measuring distances between empty and non-empty skylines.

Issue 3210: Outdated German download page says MacOS X < 10.7

Issue 3201: Don't initialize dim_cache_ array via constructor syntax

This is not valid C++ and not even a documented GCC extension.  It is
probabably an oversight that GCC appears to be able to interpret this
in some manner.

Also creates a custom copy constructor for Dimension_cache for the
sole purpose of being able to initialize a Dimension_cache array
element-wise from a Dimension_cache array in the copy constructor of
Grob.  C++ clearly is lacking in some departments.

Issue 2985: lilypond: Umlauts and other special characters incorrectly exported to PDF meta data

Since recent versions of GhostScript are more likely to get along with
UTF-16BE rather than ISO-8859-1 for PDF meta strings, we just escalate
straight from ASCII to UTF16-BE.

Issue 3202: changes.tely: deal with \transposition and instrumentTransposition changes

Those were introduced by issue 754 and issue 3168, respectively.