Merge branch 'translation'

Include `freetype.hh' where appropriate.

This ensures that we aren't dependent on indirect header inclusion chains of
third-party packages.

Include `freetype.hh' where appropriate.

This ensures that we aren't dependent on indirect header inclusion chains of
third-party packages.

Web: Iintroduction.itexi - Minor typos

LilyPond not lilypond

font: parametrize and cleanup sharp code

Changes:
* as much as possible is controlled by global parameters,
* variables have more consistent names,
* the functions are more consistently structured,
* stem ends are placed in one line using explicit beam direction.

The glyphs remain identical.

It would be good to extract one global procedure that would draw
all needed sharps (instead of having 6 similar ones), but i didn't
have enough time to do this.

font: rewrite and parametrize natural code

The logic remains virtually the same. List of changes:
* more descriptive variable names,
* removed surplus points (1', 3', 11', 21'),
* stem brushing is controlled in a simpler way,
* beam slant does no longer depend on stem thickness,
* all dimensions are explicitely and straightforwardly
  derived from global parameters.  This makes it trivial
  to get a differently-looking natural by just changing
  clearly defined values.

At size 20, the natural remains identical.  At signifincantly
different sizes there are a few microscopic changes, but they
are too small to be noticeable:

* stem end thickness is defined in terms of stem thickness,
  so regardless of design size the ratio between them is constant.
* beam slant is slightly more consistent.  But you wouldn't notice
  the change if i haven't told you ;-)

Web: Add 3 published productions by Joe Smeets

Issue 3657

Introduction.itexi

unify formatting and indentation

include subfonts unconditionally

remove spurious else

make comments more uniform

factor out common inclusions and initializations

factor out autometric_parameter declarations

move brace-drawing procedure to separate file (and rename files)

rename feta-alphabet to feta-alphabet-generic

to conform to the convention

rename feta-generic to feta-other-generic; similarly parmesan-generic

these files are not for the whole font,
but just some glyphs that aren't in their own subfonts

remove feta-test-generic.mf and other testing files

they were just polluting the code

font: clean up staffline-display in testing mode

Previous testing code was a mix of hideous copy&paste with
non-obvious passing glyph outlines around, which attempted
to produce additional glyphs in testing mode, so that there
would be both on-staffline and on-staffspace variations.

That code was completely unreadable and unmaintainable.

Instead i've introduced a global variable that determines
how the stafflines will be printed relative to the glyphs.
To see alternative configuration, just change that value.

font: rename draw_staff to draw_staff_if_debugging

Previous name was confusing: the stafflines are actually
not drawn unless 'test' is set to non-zero value.

feta accidentals: split into several files

omit filename extension as in the rest of the file

Merge branch 'issue3723' into staging

Adapt documentation for optional arguments now that lookahead is permissible

Parser: properly disambiguate pitches from music in function arguments

In many instances, function arguments were parsed greedily without
looking at the function argument predicates first.  This did not allow
using subsequent function arguments of type pitch and duration since
they were combined into one music expression.

Parser: remove command_element and command_event synonyms of tempo_event

Parser: remove pitch_arg and PITCH_ARG

Parser: inline a few "common" expressions occuring only once now

Remove all closed music expressions

Permit event functions to use a non-closed argument list.

Add location data to extra_tokens_ stack in lexer.

Parser: let MYREPARSE and MYBACKUP back up even in presence of lookahead

This implies that the lookahead token must not yet have made an impact
on the state stack other than causing the reduction of the current
rule, or switching the lookahead token while Bison is mulling it over
will cause trouble.

Since an LALR(1) works on the top of the stack, this can usually be
guaranteed.  The "Too much lookahead" message is not produced.  If
these constructs are misused, the parser should typically complain
about the replacement token being unexpected.

The advantage is the ability to vastly simplify syntax rules that up
to now have to avoid lookahead tokens with a lot of drudgework.

Move the extra_token mechanism out of the lexer proper

Calling lex->pop_extra_token explicitly in the parser's yylex function
makes things considerably more robust.  It also allows pushing and
popping the EOF condition, necessary for backing up right at the end
of a file, like with ##{ \relative { c d e f } #} where the music
expression is checked against being a pitch, and then is backed up.

Issue 3726: toplevel-music-functions should be a session variable

We don't want changes in a .ly file to bleed into subsequent files.

Issue 3728: Allow score and book identifiers at top level, and score identifiers in book(part)s

Instead of

xxx = \score { ... }
yyy = \book { ... }
\score { \xxx }
\book { \yyy }

you can now just write

xxx = \score { ... }
yyy = \book { ... }
\xxx
\yyy

Book and bookparts at top level are distinguished by virtue of only
books having a \paper block.

Regularize score handling (origin and copying)

Scores get their origin set when score_body is called, and when encountered
in \xxx and  constructs, are properly copied.

Issue 3727: Allow header blocks and output definitions in \score to precede music

This addresses a frequent complaint of users.

Simplifies pure documentation in the CG.
Removes old information about lists and articulates everything in terms
of unpure-pure-containers.

Make parsing of articulation shorthands more robust. (issue 3664)

Allow articulation shorthands to be any post-event. Commit 6baa453 tried
to restrict them to ArticulationEvents, but actually allowed anything.

As opposed to previously, return a dummy PostEvents on error as
fallback rather than an incomplete ArticulationEvent causing followup
errors and a crash.

Signed-off-by: David Kastrup <dak@gnu.org>

Web: update Translation status.

Doc-es: version markers for snippets.

Doc-es: translate remaining snippets, phase two.

Issue 3713: default for baseline-skip not available in the lists for repeatCommands

Doc: Add mention of LibreOffice

Issue 3686

OooLilyPond works for LibreOffice as well as OpenOffice.

Doc: Add links to LP user blog for Video Tutorials

Issue 3540

Added referfences and links to Video Tutorials
for beginners via LilyPond user Ben Lemon's blog

Doc-fr: get rid of @c LocalWords left by Aspell

Doc-it: update old node name and delete wrong translation

Doc-it: add Changes page

Doc-it: spell-check all the files translated so far

Add also minor updates and missing translations.

Doc-es: nits in Spanish snippets.

Doc-es: translate remaining snippets, phase one.

Doc-es: add translations of new snippets.

Remove outdated dependencies on .pfa files, replace with .pfb where feasible.

This may be related to issue 3674: Multiprocessor builds fail on some platforms.

Issue 3712: Ponding about Turkish Ebook by Server Acim

See
<URL:http://lists.gnu.org/archive/html/bug-lilypond/2013-12/msg00051.html>
for the announcement.

Doc-es: small reword in translation of Keyboards.

Web-es: update Download.

documentation: staff-spacing, resolve collisions

slurs avoid stafflines: move far enough; issue 3628

markup: scale the shift of super/sub-scripts by font-size

Doc-es: fix some node names.

Web-es: update NEWS.

Doc-es: update Usage/External, Running, Updating.

Doc-es: update Rhythms, Simultaneous, Spacing, Staff, Vocal.

Doc-es: update Fretted, Input, Keyboards, Percussion.

Doc-es: update Programming interface, Changing defaults, Editorial.

Doc-es: update Tweaks, Chords, Ancient.

Fix node names and translationof statements.

Doc-es: update Changes, Engraving, Common, Fundamental, Tutorial.

Issue 3694: Use standard inclusion scheme for FreeType headers.

The most recent FreeType release (2.5.1) has changed locations for header
files.  Using the standard way, this is not visible to applications.

Simplify extract-beam-exceptions

Issue 3679: Rewrite the autobeam logic to use GUILE fractions rather than moments

This makes the arithmetic considerably clearer.

CG: remove information about frogs and frog meister

frogs list is dead, and the frog meister was a good idea
but it gets out of touch from reality (since a few months
previous Frog Meister didn't actually participate in development).

Release: update news.

Release: bump VERSION.

Merge branch 'translation' into 'master'

PO: updates from FTP

Issue 3706: Allow computed identifiers for \change

This makes it possible to write

\change #'Staff = #"high"

(or other computed expressions) just like it is possible with

\new #'Staff = #"high" { ... }

Issue 3695: Fix LILF table in emmentaler

From <URL:http://lists.gnu.org/archive/html/bug-lilypond/2013-11/msg00113.html>:

Now, for recent versions of emmentaler (same font file), LILC contains:
  (subfont . "feta20")
  (subfont . "feta-alphabet20")
  (subfont . "feta-flags20")
  (subfont . "feta-noteheads20")
  (subfont . "parmesan20")
  (subfont . "parmesan-noteheads20")

[...]

but the subfonts array has not been updated in
these commits.

XY-extent: more accurate docstring

Add Changes entry for -dstrokeadjust and "Usage" entry.

Implement option -dstrokeadjust in order to get stroked stems and strokeadjustment

This makes the stroke drawing primitives for long rounded rectangles
dependent on the setting of currentstrokeadjust.  As a result,
low-resolution bitmap devices (up to 150 dpi or so) will get stroke
adjustment applied automatically.  The option needs to get invoked
explicitly to get stroke adjustment for PDF, giving a large file size
increase and markedly better previews on a number of PDF previewers.

Issue 2658: Be serious about setstrokeadjust in PostScript primitives

This particularly concerns draw_round_box which is used for drawing
lines with a rounded ending.  If the width/height ratio or its inverse
exceeds 2, the box is considered to be a "line".  In this case, first
a clipping path is established representing the whole shape and
extended widely in the area of the "main stroke".  The reason for this
extension is to avoid both clip area and stroke competing for the
outline.  While this is not a problem for the PostScript or PDF
rendering model, the Cairo bitmap rendering library employs
Porter-Duff compositing for antialiasing amounting to "cheap man's
antialiasing" not requiring a higher rendering resolution but relying
on edges affecting a single pixel to be independent.

Porter-Duff requires us not to have multiple parallel strokes or clip
areas if we want to avoid wrong sub-pixel grayness levels (and
consequently lines appearing too thick or thin) in Cairo-based
previewers like Evince.

After establishing the clip area, a stroke is drawn through.  This
stroke may (at the PostScript device's discretion) employ
strokeadjustment further correcting the apparent thickness.
Ghostscript employs stroke adjustment when rendering at a resolution
below 150dpi.  Stroke adjustment does not pass into PDF, however, when
ps2pdf runs.

Ghostscript performs sub-pixel rendering for antialiasing which
reduces the amount of discontinuities possibly caused by joining
stroke-adjusted shapes with full shapes.

It turns out that sharper contours can be achieved by using strokepath
and fill instead of a plain stroke.  However, the resulting crisper
stems tend to combine worse with beams, so this approach has not been
pursued.

Don't meddle with Ghostscript's choice of currentstrokeadjust

It should be appropriate for device and resolution by default.

Make stroke_and_fill? PostScript operator that fills conditionally

Make music-drawing-routines.ps require PostScript 2.0

There is no point having conditional code around setstrokeadjust and
its ilk any more.

Completion_*_engraver: add means to preserve scale factor; issue 3650

Reduce offsets of \super and \sub

This brings chordNames and text superscripts into better agreement
with the shifts in user-provided scans.

script-column: earlier scripts support later scripts; issue 3683

small padding adjustment; issue 3630

hairpin: start at left edge of a rest

web: remove old news

In particular, remove the entry about the LilyPond Report,
which is no longer reachable.

Support articulations and breaths in MIDI. (issue 3664)

Articulations and breaths can alter the length and volume of the note.
(Breaths affect the previous chord.) This is controlled by their
midi-length and midi-extra-velocity properties. The standard articulations
now have these properties where appropriate.

(seconds->moment s context) is a convenience function for making
absolute durations.

Support properties on articulations.

Shorthand articulations like -. can now be ArticulationEvents, not just
articulation names. Previously a shorthand created a new ArticulationEvent
with its name, so there was no way to give it properties. Now it can be (and
is, by default) an ArticulationEvent.

Note that redefining a shorthand to a string (e.g. dashDot = "staccatissimo")
still creates propertyless articulations, regardless of \staccatissimo.

Issue 3694: Use standard inclusion scheme for FreeType headers.

The most recent FreeType release (2.5.1) has changed locations for header
files.  Using the standard way, this is not visible to applications.

let RhythmicStaff use default barline extent

There is no reason to make barlines in RhythmicStaff special.
The purpose of the deleted code was probably to ensure that
the barlines were visible at all (despite the fact that there
is just one staffline in a RhythmicStaff).  However, currently
barline code takes care of this by default.

This makes barlines in DrumStaff and RhythmicStaff similar.

A comment by Keith:
The book by Kurt Stone happens to have some bar-lines in single-line percussion
staves that are as tall as a 4/4 time-signature.  Other examples in the same
book have short bar-lines like these here, and looking at some scores the short
bar-lines are more common.

Issue 3682/2: Change documentation and regtests for \beamExceptions

Issue 3682/1: Implement \beamExceptions function fishing exceptions from beamed music.

Implement event-chord-reduce for reducing chords to single notes

Add unfold-repeats-fully function which will expand repeats in the data

Add regtest for copy/modify semantics of make-relative macro

Add regtest for music argument semantics of make-relative macro