X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fsnippets%2Fshowing-the-same-articulation-above-and-below-a-note-or-chord.ly;h=2277eb5f361a5af3c85fdd68b6b59716bea6a034;hb=28778d37c945ff2b6818714edfbda8192550eee4;hp=b92baa87775368356b931d4ade868ee10306a270;hpb=6844bdc15fe3592ad5316154c1a6d0252be21e4f;p=lilypond.git

diff --git a/Documentation/snippets/showing-the-same-articulation-above-and-below-a-note-or-chord.ly b/Documentation/snippets/showing-the-same-articulation-above-and-below-a-note-or-chord.ly
index b92baa8777..2277eb5f36 100644
--- a/Documentation/snippets/showing-the-same-articulation-above-and-below-a-note-or-chord.ly
+++ b/Documentation/snippets/showing-the-same-articulation-above-and-below-a-note-or-chord.ly
@@ -1,25 +1,33 @@
-% Do not edit this file; it is automatically
-% generated from Documentation/snippets/new
-% This file is in the public domain.
-%% Note: this file works from version 2.13.27
-\version "2.13.31"
+%% DO NOT EDIT this file manually; it is automatically
+%% generated from LSR http://lsr.di.unimi.it
+%% Make any changes in LSR itself, or in Documentation/snippets/new/ ,
+%% and then run scripts/auxiliar/makelsr.py
+%%
+%% This file is in the public domain.
+\version "2.18.0"
 
 \header {
-  lsrtags = "expressive-marks, tweaks-and-overrides"
+  lsrtags = "expressive-marks, tweaks-and-overrides, version-specific"
 
   texidoc = "
 By default, LilyPond does not allow the same articulation (e.g., an
 accent, a fermata, a flageolet, etc.) to be displayed above and below a
-note.  For example, @code{c4_\\fermata^\\fermata} will only show a fermata
-below, ignoring the fermata above.  However, one can stick
+note. For example, c4_\\fermata^\\fermata will only show a fermata
+below. The fermata above will simply be ignored. However, one can stick
 scripts (just like fingerings) inside a chord, which means it is
-possible to have as many articulations as desired.  So, the solution is to
-write the note as a chord and add the articulations inside the @code{<@dots{}>}.
+possible to have as many articulations as desired. This approach has
+the advantage that it ignores the stem and positions the articulation
+relative to the note head. This can be seen in the case of the
+flageolets in the snippet. To mimic the behaviour of scripts outside a
+chord, 'add-stem-support would be required. So, the solution is to
+write the note as a chord and add the articulations inside the <...>.
+The direction will always be above, but one can tweak this via a
+\\tweak: @code{<c-\\tweak direction #DOWN-\\fermata^\\fermata>}
+
 "
   doctitle = "Showing the same articulation above and below a note or chord"
 } % begin verbatim
 
-
 % The same as \flageolet, just a little smaller
 smallFlageolet =
 #(let ((m (make-articulation "flageolet")))