LSR updates

Tempo and Rehearsal marks horizontal positioning; issue 3279

Space tempo/rehearsal marks so they do not overlap each other.
Do not use side-position interface for their initial vertical position,
because they are moved to the top-most staff after line-breaking.

Better break-align settings for marks

Issues 1150 712 and 1263

Doc: elaborate the placement of \paper blocks (2902)

Doc: elaborate explanation of accidentals within cadenzas (3078)

  Text based on suggestion by Federico Bruni

Doc: Augment section about titles (3103)

 - add Book Titles and explain why they might not be printed

Doc: Remove space before the tie symbol (3133)

  This patch changes only the main tie section in the NR.

  It also tightens the description and corrects a couple of
  minor errors.

Doc: extend description of LilyPond code blocks (3098)

  Also correct Lilypond -> LilyPond throughout

Doc: Change \on-the-fly #procedure to \on-the-fly \procedure (3098)

  This avoids problems when \on-the-fly is used within #{ .. #}

Doc: expand explanation of negative measurePosition (3080)

  based on text provided by Federico Bruni

Doc: Replace transposition example (3159)

  New example courtesy of Keith O'Hara

Doc: Augment description of how to customise staff line positions (3175)

  Thanks to Paul Morris for the suggested text

Doc: rename section in LM (3280)

  In the LM, the word "tweaks" is used both generically, meaning
  "modifying LilyPond's action", and specifically to refer to the
  \tweak command.  The old section heading used the word in the former
  sense, but this was confusing as the section dealt exclusively
  with \override commands.

Sets default of 0.2 for MetronomeMark skyline-horizontal-padding (issue 3207)

Eliminate grob::x-parent-width

Remove unused and misleading spanbar-begin-of-line-invisible

Eliminate inherit-[xy]-parent-visibility

Remove non-working unused grob::calc-property-by-non-event-cause

Issue 3322: Add callback factory grob::inherit-parent-property

"@var{grob} callback generator for inheriting a @var{property} from
an @var{axis} parent, defaulting to @var{default} if there is no
parent or the parent has no setting."

lilypond-book: File search fallback when kpsewhich fails.

lilypond-book: Use 550.0 as textwidth when autodetection fails.

lilypond-book: Textwidth detection with included file (issue 3136).

Fix the automatic textwidth detection performed by lilypond-book.
This failed for lytex files that include an external file in the
preamble, when such file was compiled in an --output directory
different from the working directory, because then the included
file was missing. We use TEXINPUTS to let the latex process know
where to look for input files.

Doc: Add @funindex for \newSpacingSection (3185)

  also expand the cryptic comment which says how overrides to
  SpacingSpanner should be made, and add an example

Doc: add missing engraver to example of a user-defined context (3195)

  also generally tidy up this subsection and make some minimal
  changes to move towards current documentation standards.

Merge branch 'master' into translation

Add additional options grdp to scripts/auxiliar/make-regtest-pngs.sh

This is for checking bitmap production at different resolution, the
output from using poppler and libcairo on LilyPond's PDF, and the
output for typical print bitmaps generated from LilyPond's PDF.

skyline.cc: No zero-width empty buildings between buildings; issue 3311

Time signature before repeat bars at beginning of line; issue 828

Adds arpeggio to conditional item grob array.

The actual function of conditional elements was not correctly reflected
in the comment above Separation_item::boxes.  This comment led one to believe
that conditional elements were only used when notes with accidentals
had ties coming to them.  This is not true.  Conditional elements are always
used for right columns when there is something to the left (see
Spacing_interface::skylines).  They are omitted _only_ when they are
accidentals with ties coming to them.

So why do we want an arpeggio to be a conditional element?  There is
nothing conditional about it (it will always be printed, unlike accidentals
with ties going to them).  It is because conditional elements have the
double duty of being conditional (i.e. accidentals) AND being factored
into springs in note spacing (see the long comment in
Note_spacing::get_spacing) in the calculation of a spring's ideal distance.
Other elements to the left of a note column, like scripts and fingerings,
are only factored into the minimum distance. We want arpeggios to factor
into the ideal distance because otherwise they will be too close to
left note-columns in tight spacing situations.

Lastly, there was no reason in the code base to keep a pointer to the
arpeggio in the note column, so it is removed here.

Doc: Error message: unexpected \new (3285)

  Explain reason for the message and what should be
  done to avoid it.

Revert "Break slurs between alternative endings in repeats; issue 1698."

This reverts commit 88d306d9c5666b5ade4a136df29cca19c5ff5ed7.

Conflicts:

input/regression/repeat-slur.ly

Add warning about using \relative with tagged music (3253)

 - add warning as a known issue
 - remove earlier ignored known issue

Doc: use @dots{} rather than "..."

doc: explain how to add lyrics to polyphonic sections (issue 3236)

Issue 3303: Add some more documentation for \defaultchild

Doc: add some missing italian translations in Music Glossary

Release: bump version.

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

Doc-de: Typo

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-it: update

Doc: typo (3302)

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

This reverts commit f0fbdb3f07ef9028c6a256b9e1fd1db217ef8799.

Conflicts:

input/regression/chord-dots.ly

Doc-it: add Notation Reference 1.2

Still waiting for proofreading, I'll add changes later.

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.

Doc-fr: updates rhythms, running and texidocs

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.