Issue 3012: Flag an error for isolated post-events occuring in music lists

These can happen when writing things like

c \tweak #'color #red -3

since at the current point of time a tweaked post-event is not
syntactically recognized as a post-event without leading -, like

c -\tweak #'color #red -3

While this restriction will at some time be removed, in the mean time
we want to have this problem flagged.

Fix overlooked old code in French tweaking documentation

Replace some faulty code examples in the "Czech" learning/tweaks

Since those are contained in as-yet untranslated German passages,
I copied the respective code examples from the current German
documentation.  No attempt at updating the corresponding texts
has been made.

Fix music/event confusions in tweak documentation examples

Issue 3019: Let ly:event-property take an optional default argument

This is analogous to the respective functionality for
ly:music-property and ly:prob-property.

Issue 3013: Amend \overrideProperty example

It has been overlooked by convert-ly due to interspersed comments, and
it could make use of a subproperty override (which is supported by
\overrideProperty by now).

Snippets: correct some strings

texidocs or comments not converted when " #'" -> "."

Release: bump version.

Release: update news.

PO: update template.

LSR updates

Issue 3008: articulate can't deal with <>

Issue 2981: Let \set ... = *undefined* unset values rather than overwriting.

Also makes \once\set deal properly with a value that is not previously
defined in the current context.

markup.scm: use stencil extents when stacking; issue 723

stencil.cc: Backspacing stencils are not empty

markup-commands rest-by-number and rest

Introduces two new markup-commands:
rest-by-number and rest
similiar to the existing note-by-number and note.
Two regression-tests for them are added.

Merge branch 'translation' into staging

Issue 3005: A bit of rectification for learning/tweaks regarding Scheme values

Doc: cautionary accidentals after a key change (3000)

  Add text and examples to NR 5.4.6 "Using break-visibility"
  to cover the printing of cautionary accidentals following
  an explicit key change.

  (Thanks to Paul Morris for the suggestion)

Doc: improve example of using positions property (2993)

  The current example is positioned properly even
  without the override.  This changes the example
  to one in which the slur and phrasing slur collide
  by default.

Doc-fr: Notation first part

 - ancient
 - changing default
 - cheatsheet
 - chords
 - editorial
 - expressive
 - fretted-string
 - input
 - keyboards
 - appendices
 - percussion
 - pitches

Doc-fr: Learning

 - fundamental
 - templates
 - tweaks

Doc-fr: Extending

 - programming-interface
 - scheme-tuto

Web-fr: engraving

Issue 3009: Make \revert work again as context modification

parser/lexer: eliminate LYRIC_MARKUP as a token separate from MARKUP (2996/2)

parser/lexer: don't require separate LYRICS_STRING different from STRING (2996/1)

Doc: All level 3 and 4 headings need nodes (2991)

  Without them the sections cannot be referenced,
  and links in the left panel in html and entries in
  the index do not link to the correct section.

  Also correct more level 5 headings.

  This continues Issue 2967, the fix to which missed
  quite a few changes.

Merge remote-tracking branch 'origin/master' into translation

Conflicts:
Documentation/changes.tely

has been resolved by taking the version in master

Documentation/fr/notation/input.itely
Documentation/fr/notation/spacing.itely

Code conflicts (possibly from use of convert-ly) have been resolved by
taking the code corresponding to the current English translation.

Issue 2984: Use define-void-function rather than define-music-function in several places

Issue 2972: Adding StringNumber 0 in TabStaff crashes

This does not check against string numbers that are too large, however.

Issue 2916: Document \hide and \omit

Also fixes a few other inaccuracies.

Remove "selective" contextmods.

This reverts those parts of commit
70365334614c31a82e9a3860c9eb9334cdc2879a that have been responsible
for allowing context-mods to contain modifications restricted to
certain context types.  It also removes use of this feature from
context-mod-from-music which is used for harvesting music into context
modifications.

As a result, any overrides in music used inside of context mods are
interpreted without looking at their actually targeted contexts.  It
turned out that this "feature" offered more confusion than benefits.

Issue 2997: parser.yy: avoid premature work in make_music_from_simple

Release: bump version.

Release: update news.

PO: update template.

Issue 2978: Simplify calculation of pitch-alist in determine-frets-and-strings

The old code was contorted and undefined (it used map rather than
map-in-order but depended on sequential execution).

Issue 2997/3: Let \single deal with nested property overrides

Issue 2997/2: Let \tweak deal with nested properties

Issue 2997/1: Let Tweak_engraver deal with nested properties

Issue 2976: Allow ly:grob-set-nested-property! to set a single (unnested) property

This makes things more orthogonal.

Issue 2975: beam.cc: let a loop run backwards for better Scheme-fu.

Issue 2974: music-functions-init.ly: Avoid unnecessary use of $ instead of #

$ creates unnecessary copies, unnecessary reinterpretation, and
reassigns the music origin of some expressions to the current parser
location, which in #{ ... #} turns out to be music-functions-init.ly
itself, hardly helpful.

parser.yy: use extended version of check_scheme_arg

parser.yy: give check_scheme_arg optional argument for error display

Sometimes a variation of the argument is being checked, and in that case
the error message, if any, should refer to the unchanged argument.

Doc: ensure all level 3 and 4 headings have nodes (2967)

  Without them the sections cannot be referenced,
  and links in the left panel in html and entries in
  the index do not link to the correct section.

  Correct more level 5 headings.

  Usage manual is not included.

  Complete the set of files in Documentation/nl/learning
  and Documentation/hu/learning with the English versions.
  This is needed to avoid errors in make doc following
  the change in node names.  Fixes Issue 2980.

Doc: include aliases for note name languages.

Doc: fix incorrect chording for fret diagram (2963)

Doc: new syntax for \tweak, \override (2936)

  Also remove text saying spaces are required
  around the . in Lyric overrides

Doc: add example left-aligning dynamic text (2943)

Fix and document usage of `convert-ly - < test.ly'.

Update bug squad rota

Issue 2951: Allow music of nominally zero duration to be typeset.

This is important for things like incipits without notes or other
material that produces output without spending time.  In particular,
this is interesting for \score in markup which more often than not
only contains few notational elements and where attempts to just get
basic key/clef/timesignature drawings are sometimes failing in
frustrating manners.

Release: bump version.

Release: update news.

PO: update template.

LSR updates

LSR local updates

Moves stem-length to C++.
Makes Kievan notation more modular.

Doc: Add index entry to MIDI, instrument

  to avoid confusion with Instrument names in 1.6.3

Doc: Add example of extending glissandi over repeats (2591)

Add native utf8-coded aliases for note names language

  español in Spanish for espanol,
  français in French for italiano.

Issue 2958: Web: Add LilyPond Report #28 to news

Fix erroneous comment signs in scm/clip-region.scm

Issue 2954: Context_mod should not have virtual copy constructor

Without a virtual destructor, this is asking for trouble.  It does not
appear that a virtual copy constructor is actually needed for anything
here.

Adds documentation for optional octavation clef syntax

This documents the new feature made available with commit
74b4c9351b01381f0dc1d6d4688dcd845fc59720

(see Issue 2933)

Issue 2946: let Lyric_combine_music_iterator only listen to rhythmic events

Listening to articulations makes the rhythmic_music_iterator assume it
can just broadcast things like string numbers and right fingerings and
somebody will pick them up and deal with them which is, unfortunately,
not the case.

Listening only to rhythmic events should cure that problem.

Release: bump version.

Release: update news.

Issue 2949: Allow (closed) scheme function calls as text scripts.

One motivation of recent grammar changes was to make scheme variables
identical to markup variables.  The obvious parallel idea of letting
scheme function calls be available for calculating markups has not
received similar attention.

The purpose of this patch is to allow for using scheme function calls
producing markup within text scripts.

fix divisioMaior; add more explanatory comments

do what the (original) comment dictate: find staff spaces at the
required height, and draw a line between the centres of these spaces
(or perhaps a bit wider for extreme staves)

test breathing signs in nonstandard staves

Gobble empty strings passed as arguments to python scripts.

This is needed on windows in combination with the fix to issue
1455. Either we go this way, or we revert the fix to issue 1455.

Should also be considered a candidate for the 2.16 stable branch.

Issue 2953: Teach \displayLilyMusic the recommended override/revert syntax

This is a followup to the large issue 2934 change.

Issue 2945: Document symbol list changes.

Allows optional octavation for clefs

Clef specifications like \clef "G_(8)" or
\clef "bass^[15]" are supported.

A new property clefOctavationStyle (and its cue
clef couterpart cueClefOctavationStyle) is introduced.
When set to 'default, the octavation number is displayed
as before; 'parenthesized calls for parenthesized numbers
and 'bracketed used brackets around the number.

Furthermore, a scheme formatter function is used for
displaying the ocatavation number, so can be customized
more easily.

Issue 2939: Fix relations between \maininput, EOF and safe mode

In lexer.ll, assumptions about the depth of include_stack_ were hardwired
that only were valid for parsers started from the normal chain of input.

One consequence was that something like

    #{ \book { \include "line-arrows.ly" } #}

worked even in safe mode (where \include should be prohibited) but
might complain about unexpected EOF.  This commit adds a member
variable main_input_level to Lily_lexer for keeping track of when to
drop restrictions and deliver EOF in each parser separately.

Add support for measures split across lines.

- All pieces are numbered.  The number before the break has its
default appearance, and any following numbers are parenthesized.
- A regtest for this feature is provided.

Issue 2445: Add measure counter to LilyPond

These changes implement a new grob, `MeasureCounter,' a spanner used to
number groups of successive measures.

This commit:
- defines a new event class, `MeasureCounterEvent.'
- defines a new interface, `measure-counter-interface.' This
interface contains `count-from,' the number which begins the count, and
`columns,' which contains the NonMusicalPaperColumn grobs forming
the bounds of the new spanner.
- defines the stencil with a function in scm/music-functions.scm.
- defines an engraver, `Measure_counter_engraver.'  This engraver
is written in Scheme and placed in a new file, scm/scheme-engravers.scm,
which is added to the load list in scm/lily.scm.
- sets various grob properties to default values.
- provides two commands to frame the measures to be counted:
\startMeasureCount and \stopMeasureCount.
- provides a regression test.

Updates pondings

Release: bump version.

Release: update news.

PO: update template.

MakeLSR updates

Doc: NR-1.2.5 remove empty @snippets in "bar lines"

Doc-fr: update for 2.16.1 (second part)

 - input
 - rhythms
 - spacing

Merge remote-tracking branch 'origin/stable/2.16' into translation

Issue 2930: Allow \tag to accept multiple tags, like \keepWithTag and \removeWithTag do.

Let \footnote and \shape rely on \tweak for overrides

Issue 2929: Allow \tweak to act as a stand-in for \once\override

Making tweak optionally accept a grob specification instead of music
to tweak makes it compatible with the behavior of functions such as
\footnote and \shape, and actually serves to simplify their
implementation.

One slight complication occurs in lyrics mode, as demonstrated by the
change necessary to input/regression/lyric-tweak.ly: with

    \tweak color #red reddish fish,

LilyPond tries an override for a grob named "reddish" and fails.
Tweaks in lyrics mode are highly unusual, have not been supported for
long, and their effect can usually better be accomplished in markup
mode instead.  The fix here is to write

    \tweak color #red \markup reddish fish,

since LilyPond does not consider explicit markup a candidate for
conversion into symbols.  The same problem is inherent with other
commands using the same kind of symbol-list-or-music? interface, like
\footnote, \hide, \omit.

Issue 2928: parser.yy: get rid of SCORE_IDENTIFIER token

This allows Scheme functions returning a score to be used as a score body
inside of \score { ... }.

Change input/regression/alter-broken.ly to include tweak-like usage

Also change override-like usage for ties to \once\alterBroken as the
control point manipulations are unlikely to be desirable for more than
a single occurence.

Merge symbol_list into master

This merge commit comprises the commits

13da8b2 Rerun scripts/auxiliar/update-with-convert-ly.sh
516cae5 Add more extensive rules for \tweak, \override, \revert, \overrideProperty
7b2cfcb Change \overrideProperty to take a single symbol-list as path
ec6b407 Change \alterBroken interface to match that of other tweak/overrides

that don't have a compilable work tree and should therefore not be
separate commits in the mainline.

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

Implement function check-grob-path for checking/extending grob path specs

From the function documentation string:

Check a grob path specification @var{path}, a symbol list (or a
single symbol), for validity and possibly complete it.  Returns the
completed specification, or @code{#f} if invalid.  If optional
@var{parser} is given, a syntax error is raised in that case,
optionally using @var{location}.  If an optional keyword argument
@code{#:start @var{start}} is given, the parsing starts at the given
index in the sequence @samp{Context.Grob.property.sub-property...},
with the default of @samp{0} implying the full path.

If there is no valid first element of @var{path} fitting at the given
path location, an optionally given @code{#:default @var{default}} is
used as the respective element instead without checking it for
validity at this position.

The resulting path after possibly prepending @var{default} can be
constrained in length by optional arguments @code{#:min @var{min}} and
@code{#:max @var{max}}, defaulting to @samp{1} and unlimited,
respectively.

Add more extensive rules for \tweak, \override, \revert, \overrideProperty

Change \overrideProperty to take a single symbol-list as path

Change \alterBroken interface to match that of other tweak/overrides

lexer.ll: duplicate a few quotes in character sets to help syntax highlighting

This uses regular expressions like [^''] rather than [^'] in order to keep
the confusion of editors like Emacs tolerable.