Doc: Appendix - Articulations and Ornamentation - part 3

Issue 1189

Create Texifo @multitable entries for the
List of Articulations appendix.

As there are a lot of separate scripts being
documented this Issue is going to be split
into multiple, smaller, parts to aid in the
review process. Part 2 was commit 4d6f2a27cc

This is part 3 and while not strictly
'Articulations and ornamentations' covers
the percussion scripts.

I have also set the @code{} script examples into
the same column as the @lilypond examples; saving
a significant amount of wasted page space. I have
removed unnecessary lilypond-book variables making
the texinfo code less noisy.

Issue 4063: Interpret < > and << >> in \chordmode

There is no compelling reason not to do so, and having < > available
allows stuff like

\chordmode { \clef bass <c> c/e <g,> c/e }

or other ways of explicitly spelling out some not-really chord material.

Issue 4066: Clean lily/include/lily-proto.hh from unused/undefined classes

This is the result of running

sed -i -e "$(sed -n s'/^class\s\+\([^;]*\);.*$/\1/p' lily/include/lily-proto.hh |while read i;do git grep -l "\(class\|struct\)\s\+$i" lily|grep -q -v lily/include/lily-proto || echo "/^class $i/d";done)" lily/include/lily-proto.hh

Release: bump VERSION.

Release: bump Welcome versions.

Release: update news.

PO: update template.

Release: bump VERSION_DEVEL.

Correct \version statement in clef modifier regtest

Fix issue 3826

Commit 2d3a5d87166caa13feb036e23086b0d4f23283f4 let
scripts/auxiliar/update-with-convert-ly.sh call the non-existent
Makefile target "make pythonmodules" instead of "make python-modules".

Update version in Editorial to avoid \relative -> \relative c' conversion

Remove stray BOM from chords.itely

Introduced with commit f739a44f91a0b7ef5f634b6c4ca5b45c988798c1

Issue 3186: fix clef transposition alignment

Until now, numbers indicating clef transposition (for example
in \clef "G_8") were simply centered against the clef glyph.
This was not optimal, because clef glyphs aren't symmetrical
- for example the hook of the treble clef isn't exactly at its
horizontal center, and thus the octavation number shouldn't
be exactly centered.

This commit allows to specify alignment separately for each
clef, taking into account their individual characteristics.
Alignments are stored in clef-alignments property.

Doc-fr: updates committishes for full sync

Merge branch 'master' of /home/jcharles/GIT/Lily/. into translation

Issue 4051: Improve make-countdown-announcement.sh.

* Check for tracker issues missing OWNER or SUMMARY fields.
* Convert tabs to spaces in tracker issue summaries.
* Add lilypond-issues.csv to .gitignore.
* Add Heikki to mailmap.
* Update documentation.
* Fix typos.

Regtest for \partial in mid-piece

Issue 4056: Let \partial in mid-piece work via a finalization hook

That allows all other processing to complete before measurePosition is
adjusted.  In particular, this avoids problems when multiple parallel
contexts invoke \partial and/or bar checks.

Use Context::here_defined to speed up some operations

Issue 4057: Create Context::here_defined as faster variant of Context::where_defined

Issue 4055: Factor out typecheck_grob routine.

Issue 4065: Don't rescale \layout in \score markup when already scaled

This change modifies the fix for issue 677 to avoid scaling problems
when employing $(ly:grob-layout grob) in the \layout of a score markup.

More sensible fermata doc-string

Grob alignment: get back 2.19.9 behaviour

A series of commits

*   0bc7f77 Issue 3978: Merge alignment cleanup
|\
| * d6604b0 define-grobs.scm: reorder properties alphabetically
| * 6f3f8f0 TextScript, CombineTextScript: use aligned_on_parent
| * 1d76502 Replace XY-offset closures with aligned_on_parent where possible
| * 09412c2 Clean up DynamicText horizontal alignment.
|/

changed how some grobs (notably DynamicTexts) reacted to overriding
self-alignment-X property.  The new behaviour was confusing for some
users, so this commit gets back the old behaviour.  The possibility
of using separate alignment factors for grob and its parent, introduced
by previous commit (see Issue 4022), makes it possible to get pre-0bc7f77
behaviour just by changing default values of parent-alignment-*; leaving
up the possibility to easily change them in the future.

See http://lists.gnu.org/archive/html/lilypond-user/2014-07/msg00691.html
and https://code.google.com/p/lilypond/issues/detail?id=4036
for details.

Issue 4022: Allow specifying different alignment for grob and its parent

This gives users more possibilities for grob positioning - for example,
they can align left edge of a grob on center of its parent, etc.

Also fix Issue 4054.

Doc-fr: update texidocs

Doc-fr: updates with latest merge

 - EM programming-interface
 - NR keyboards
      notation-appendices
      spacing
 - web-intro

Doc-fr: reflects Issue 4034: Fix some broken commit references.

Doc-fr: reflects renaming in snippets

Merge branch 'master' of /home/jcharles/GIT/Lily/. into translation

Issue 4050: Don't let incipit regtest tamper with interfaces or alignments

LSR updates: delete beam grouping snippet

Allow changing of notation fonts

This commit changes the behaviour of make-pango-font-tree in the
following ways:

- Make all arguments optional key/value pairs
  keeping the current default values (emmentaler/Century Schoolbook)
- Allow changing of music fonts too.

Currently alternative music fonts have to be present in the font
directory besides Emmentaler fonts, and they have to be manually installed.
But now there are a number of alternative and compatible fonts available.

Doc: CG - update Bugsquad rota

Issue 4049

Updated the list of Bugsquadders

Federico and Ralph are going to be absent as of at least
until the middle/end of August.

Support for controlling MIDI expression

Doc: NR Fixes mis-ordered menu section for 4.3

Issue 4053

This fixes a mistake introduced in

aec840a735b33a4be38b10baeb40f8e660e3d55c

Where @nodes were moved around but the corresponding
@menu section wasn't altered accordingly.

Doc-fr: update texidocs

Issue 4039: Improvements to magnifyMusic and magnifyStaff

Remove redundant scaling when mag factor = 1.
Scale tablature half-note double-stems.
Scale baseline-skip and word-space props.
Add regtests.

Issue 4038: Add text-interface to InstrumentName.

Issue 4034: Fix some broken commit references.

Issue 4024: Clarify break-align symbols and space-alist args in IR.

Updates CG with new script to test LSR files

Release: bump VERSION.

Release: bump Welcome versions.

Release: update news.

PO: update template.

Correct release instructions

Release: bump VERSION_DEVEL.

Doc-fr: updates AU

Doc-fr: updates NR

Doc: add missing French translation of tuplet

Doc-fr: updates LM
 - common-notation
 - fundamental
 - tweaks

Doc-fr: updates EM

Web-fr: updates essay, community and manuals

DOC: Easier Editing - Frescobaldi

Changed description of Frescobaldi

Undocument the Scheme interface to make-simple closure

in favor of lambdas; issue 3993

Merge branch 'issue4032'

Manual cleanup after unsmob_xxx -> Xxx:unsmob conversion

Replace remaining uses of unsmob_xxx with Xxx::unsmob

This runs
sed -i 's/unsmob_\(engraver\|global_context\|input\|item\|music\|paper_score\|performance\|performer\|spanner\|stream_event\)\b/\u\1::unsmob/g' $(git grep -l unsmob_ lily)

as the mechanical part of the conversion.  A separate commit provides
the required definitions.

Remove definition of DECLARE_UNSMOB

unsmob_pitch -> Pitch::unsmob and related

This is part of moving away from implementing LilyPond infrastructure
via the C preprocessor rather than C++ features since C++ features tend
to be more transparent to IDEs, debuggers, editors, and newcomers.

sed -i "$(git grep -h DECLARE_UNSMOB|sed 's/.*(\(.*\), \(.*\)).*/s\/unsmob_\2\\b\/\1::unsmob\/g/')" $(git grep -l unsmob_)
sed -i '/^DECLARE_UNSMOB/d' `git grep -l DECLARE_UNSMOB`
git checkout Documentation/misc/CHANGES-1.3

(the changes to the CHANGES file are not useful).

The definition of DECLARE_UNSMOB is removed in a separate commit.

Remove unused macros ADD_TYPE_PREDICATE and DECLARE_TYPE_P

Issue 4033: All subsequent clef transpositions are marked as optional

This removes a bug cover-up in scm/parser-clef.scm, implements the
necessary functionality in display-lily-music and adds some regtests
for that functionality.

Issue 4035: Some refactoring and cleanup in lily/paper-book.cc

makelsr run on snippets from LSR

Phase two of pruning snippets/new

Doc: Appendix - Articulations and Ornamentation - part 2

Issue 1189

Create Texifo @multitable entries for the
List of Articulations appendix.

As there are a lot of separate scripts being
documented this Issue is going to be split
into multiple, smaller, parts to aid in the
review process. Part 1 was commit 8553021

This is part 2 and covers 'Fermata', 'Instrument
specific', 'Repeat signs' and 'Ancient' scripts.

Also, after more consideration, a third example
of each script has been added to show the
explicit differences between the up/down/neutral
positions. Not every script has a different
up/down glyph nor is positioned up/down when
placed on a note that is either top or bottom of
the Staff without explicit positioning. So this,
I hope just clarifies things (regardless whether
the position is musically 'correct' notation).

I have also sey the @code{} script examples into
the same column as the @lilypond examples; saving
a significant of wasted page space. Also I have
removed unnecessary lilypond-book variables making
the texinfo code less noisy.

Merge branch 'translation'

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

Make list of `non-staff lines' easier to find in IR.

Linking from the NR to the Axis_group_engraver IR entry
directs the reader to the list of staff contexts and
`non-staff line' contexts.

Remove warning when there are no noteheads to attach lyrics to.

The warning was added to address issue 248, but it is now moot after
issue 3254 (c73b41b3e7be6d7): attaching lyrics to a note-less context
(like Devnull) is perfectly legal now.

Issue 4021: Remove obsolete restrictions from define-*-function docstrings

Issue 4019: binding-offset not properly scaled along with paper size

This will unfortunately affect all previous uses of binding-offset which
likely were employed using trial-and-error.

Doc: NR - Pitches.itely - dodecaphonic-no-repeat text alt

Issue 4023

Came out of issue 3992

Corrected wording for dodecaphonic-no-repeat
accidental style.

CG: Update of Patchy instructions

Issue 4013

Added fuller explanatory information regarding Patchy.

Issue 4005: Set X-parent of TextScript to NoteColumn instead of PaperColumn

This makes TextScripts consistent with DynamicTexts and LyricTexts.
This is a follow-up to commit 59a842eba0f7ad78289a58a (Issue 2245).

Setting TextScript.cross-staff property to #f is required to ensure
that there are no collisions between TextScripts and cross-staff notes:

\context PianoStaff <<
  \new Staff = "up" {
    b8[
    \change Staff="down"
    d'] ^"text"
  }
  \new Staff = "down" {
    \clef bass
    s4
  }
>>

(see also beam-cross-staff-auto-knee.ly)

As far as I can see, we don't want TextScript.cross-staff to be true
in any situation, because it would result in unwanted collisions.

Why it worked before: cross-staff property in this example evaluated to #f,
but only because of a bug in Script_interface::calc_cross_staff.  That
function should have marked the TextScript as cross-staff if the stem
of the note to which TextScript was attached was cross-staff, but it
didn't work correctly because it expected the parent of the TextScript
to be a NoteColumn, while it actually was a PaperColumn.  When I changed
the parent to be a NoteColumn, the function started working correctly
and marked the TextScript as cross-staff, so I had to change the default
value of the property.

Import snippets from LSR and delete initial batch in snippets/new

Fix ly:make-stream-event to receive a symbol list rather than a symbol as event class

Issue 4007: Fix parts of apparently dead code make-stream-event

It is not clear whether the code will be operative for its intended purpose
afterwards, but leaving it in broken state is not going to help.

typo/oversight in align-interface.cc and page-layout-problem.cc

issue 4008

fix oversight in doc-string of align-interface.cc
fix typo in comment of page-layout-problem.cc

Issue 4017: Define spacing from KeyCancellation to custos

Adds a space-alist rule from KeyCancellation to custos
to prevent "No spacing entry" programming error.

Issue 4015: Add \magnifyStaff.

* Add \magnifyStaff.
* Rewrite parts of the \magnifyMusic function so that it can share
  some scheme code with the new \magnifyStaff function.
* Add regtests.
* Update documentation.

Don't call Pitch::Pitch with more arguments than necessary.

Pitch::Pitch (int, int) is declared but not defined

This caters for the definition by making the last argument of
Pitch::Pitch (int, int, Rational) a default argument.

Merge branch 'dev/dodecaphonic_no_repeat' into staging

Issue 3992: Fix dodecaphonic-no-repeat

Incorporate renaming of localKeySignature to localAlterations.

The function dodecaphonic-no-repeat-rule now considers alterations.

A pitch which overlaps the same pitch begun earlier should not
receive an accidental.

Improvement to code comments.

Improve code formatting.

Issue 3999: Make tablature half-note stem-spacing adjustable.

This adds a new property to the Stem grob called
'double-stem-separation (default=0.5), that allows users to adjust
the space between the double-stemmed half-notes in tablature:

\new TabStaff {
  \tabFullNotation
  c4 c2 c4
  \override Stem.double-stem-separation = 0.3
  c4 c2 c4
}

It also centers the stems on the fret number and adjusts the
X-extent accordingly.

Issue 3995: Rename 'thin-kern to 'segno-kern.

Issue 3994: Fix typo `dash-details' => `dash-definition'.

Fix typo in the docs and translated .po files.
Also fix some whitespace errors.

Issue 3952: Automatically sort props within each grob-interface.

Ensures that "User settable properties" and "Internal properties"
are listed in sorted order in the "Graphical Object Interfaces"
section of the IR.

This was originally pushed with commit 84f0776,
but was accidentally reverted with commit 0ea80a5.

Run scripts/auxilar/makelsr.py

Issue 3998: Let "Mars" example in pitch snippets use isolated durations

This is one example quite benefitting from issue 3648.  One somewhat
incidental boon is that it would now work in relative mode without
requiring the make-relative macro.

Revert "Change dsi to di in LSR address; update version"

This reverts commit 4ee99b07605942b02e82c6526df98b68cbc03981.

NR: Adapt docs for inversions in chordmode

Issue 2617: simple chord inversions take 2 octaves

With this change, chord inversions transpose all notes following the
inversion from the original chord down along with the inversion, as long
as the result ends up below the root note of the uninverted chord.

So with \chordmode { c:11 } => < c' e' g' bes' d'' f'' >
we get \chordmode { c:11/e } => < e g bes c' d'' f'' >

In order to have the Chord_name_engraver reconstruct the correct
uninverted chord, all the additionally octavated note events are given
an octavation property like the inversion event itself.

An "inversion" on the chord root just transposes the chord root one
octave down, leaving the rest in place.

Issue 4001: Fix doc string of ly:pitch-diff

The documentation of ly:pitch-diff has got the sign wrong like forever.

Issue 4003: NR: warning for { \chordmode { c } c } obsoleted by issue 3797

Issue 4009: \retrograde fails on slurs

The section "Retrograde" in the Notation Reference is affected.
This became likely exposed with issue 2240; the corresponding
regtest does not cover it.  The problem was existent previously
for slurs and other spans inside of chords.

Add slur to modal-transform regtest motif

Change dsi to di in LSR address; update version