Snippets: correct some strings

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

diff --git a/Documentation/snippets/new/adding-a-figured-bass-above-or-below-the-notes.ly b/Documentation/snippets/new/adding-a-figured-bass-above-or-below-the-notes.ly
new file mode 100644 (file)
index 0000000..71dcf28
--- /dev/null
+++ b/Documentation/snippets/new/adding-a-figured-bass-above-or-below-the-notes.ly
@@ -0,0 +1,48 @@
+%% DO NOT EDIT this file manually; it is automatically
+%% generated from LSR http://lsr.dsi.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.17.6"
+
+\header {
+  lsrtags = "ancient-notation, chords, contexts-and-engravers"
+
+  texidoc = "
+When writing a figured bass, you can place the figures above or below
+the bass notes, by defining the
+@code{BassFigureAlignmentPositioning.direction} property (exclusively
+in a @code{Staff} context).  Choices are @code{#UP} (or @code{#1}),
+@code{#CENTER} (or @code{#0}) and @code{#DOWN} (or @code{#-1}).
+
+This property can be changed as many times as you wish.  Use
+@code{\\once \\override} if you don't want the override to apply to the
+whole score.
+
+"
+  doctitle = "Adding a figured bass above or below the notes"
+} % begin verbatim
+
+
+bass = {
+  \clef bass
+  g4 b, c d
+  e d8 c d2
+}
+continuo = \figuremode {
+  <_>4 <6>4 <5/>4
+  \override Staff.BassFigureAlignmentPositioning.direction = #UP
+  %\bassFigureStaffAlignmentUp
+  < _+ >4 <6>
+  \set Staff.useBassFigureExtenders = ##t
+  \override Staff.BassFigureAlignmentPositioning.direction = #DOWN
+  %\bassFigureStaffAlignmentDown
+  <4>4. <4>8 <_+>4
+}
+\score {
+  <<
+    \new Staff = bassStaff \bass
+    \context Staff = bassStaff \continuo
+  >>
+}

diff --git a/Documentation/snippets/new/horizontally-aligning-custom-dynamics-e.g.-sempre-pp,-piu-f,-subito-p.ly b/Documentation/snippets/new/horizontally-aligning-custom-dynamics-e.g.-sempre-pp,-piu-f,-subito-p.ly
new file mode 100644 (file)
index 0000000..0ff1ee5
--- /dev/null
+++ b/Documentation/snippets/new/horizontally-aligning-custom-dynamics-e.g.-sempre-pp,-piu-f,-subito-p.ly
@@ -0,0 +1,179 @@
+%% DO NOT EDIT this file manually; it is automatically
+%% generated from LSR http://lsr.dsi.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.17.6"
+
+\header {
+  lsrtags = "correction-wanted, expressive-marks, tweaks-and-overrides, version-specific"
+
+  texidoc = "
+Some dynamic expressions involve additional text, like @qq{sempre pp}.
+Since dynamics are usually centered under the note, the \\pp would be
+displayed way after the note it applies to.
+
+To correctly align the @qq{sempre pp} horizontally, so that it is
+aligned as if it were only the \\pp, there are several approaches:
+
+* Simply use @code{\\once\\override DynamicText.X-offset = #-9.2}
+before the note with the dynamics to manually shift it to the correct
+position. Drawback: This has to be done manually each time you use that
+dynamic markup...
+
+* Add some padding (@code{#:hspace 7.1}) into the
+definition of your custom dynamic mark, so that after lilypond
+center-aligns it, it is already correctly aligned. Drawback: The
+padding really takes up that space and does not allow any other markup
+or dynamics to be shown in that position.
+
+* Shift the dynamic script @code{\\once\\override ...X-offset = ..}.
+Drawback: @code{\\once\\override} is needed for every invocation!
+
+* Set the dimensions of the additional text to 0 (using
+@code{#:with-dimensions '(0 . 0) '(0 . 0)}). Drawback: To LilyPond
+@qq{sempre} has no extent, so it might put other stuff there and create
+collisions (which are not detected by the collision detection!). Also,
+there seems to be some spacing, so it's not exactly the same alignment
+as without the additional text
+
+* Add an explicit shifting directly inside the scheme function for the
+dynamic-script.
+
+* Set an explicit alignment inside the dynamic-script. By default, this
+won't have any effect, only if one sets X-offset! Drawback: One needs
+to set @code{DynamicText #'X-offset}, which will apply to all dynamic
+texts! Also, it is aligned at the right edge of the additional text,
+not at the center of pp.
+
+
+
+
+"
+  doctitle = "Horizontally aligning custom dynamics (e.g. \"sempre pp\" \"piu f\" \"subito p\")"
+} % begin verbatim
+
+
+\header { title = "Horizontally aligning custom dynamics" }
+
+\paper { ragged-right = ##f }
+
+% Solution 1: Using a simple markup with a particular halign value
+% Drawback: It's a markup, not a dynamic command, so \dynamicDown
+%           etc. will have no effect
+semppMarkup = \markup { \halign #1.4 \italic "sempre" \dynamic "pp" }
+
+% Solution 2: Using a dynamic script & shifting with
+%             \once \override ...X-offset = ..
+% Drawback: \once \override needed for every invocation
+semppK =
+#(make-dynamic-script
+  (markup #:line
+          (#:normal-text
+           #:italic "sempre"
+           #:dynamic "pp")))
+
+% Solution 3: Padding the dynamic script so the center-alignment
+%             puts it at the correct position
+% Drawback: the padding really reserves the space, nothing else can be there
+semppT =
+#(make-dynamic-script
+  (markup #:line
+          (#:normal-text
+           #:italic "sempre"
+           #:dynamic "pp"
+           #:hspace 7.1)))
+
+% Solution 4: Dynamic, setting the dimensions of the additional text to 0
+% Drawback: To lilypond "sempre" has no extent, so it might put
+%           other stuff there => collisions
+% Drawback: Also, there seems to be some spacing, so it's not exactly the
+%           same alignment as without the additional text
+semppM =
+#(make-dynamic-script
+  (markup #:line
+          (#:with-dimensions '(0 . 0) '(0 . 0)
+                             #:right-align
+                             #:normal-text
+                             #:italic "sempre"
+                             #:dynamic "pp")))
+
+% Solution 5: Dynamic with explicit shifting inside the scheme function
+semppG =
+#(make-dynamic-script
+  (markup #:hspace 0
+          #:translate '(-18.85 . 0)
+          #:line (#:normal-text
+                  #:italic "sempre"
+                  #:dynamic "pp")))
+
+% Solution 6: Dynamic with explicit alignment. This has only effect
+%             if one sets X-offset!
+% Drawback: One needs to set DynamicText.X-offset!
+% Drawback: Aligned at the right edge of the additional text,
+%           not at the center of pp
+semppMII =
+#(make-dynamic-script
+  (markup #:line (#:right-align
+                  #:normal-text
+                  #:italic "sempre"
+                  #:dynamic "pp")))
+
+\context StaffGroup <<
+  \context Staff = "s" <<
+    \set Staff.instrumentName = #"Normal"
+    \relative c'' {
+      \key es \major
+      c4\pp c\p c c | c\ff c c\pp c
+    }
+  >>
+  \context Staff = "sMarkup" <<
+    \set Staff.instrumentName = \markup \column { Normal markup }
+    \relative c'' {
+      \key es \major
+      c4-\semppMarkup c\p c c | c\ff c c-\semppMarkup c
+    }
+  >>
+  \context Staff = "sK" <<
+    \set Staff.instrumentName = \markup \column { Explicit shifting }
+    \relative c'' {
+      \key es \major
+      \once \override DynamicText.X-offset = #-9.2
+      c4\semppK c\p c c
+      c4\ff c
+      \once \override DynamicText.X-offset = #-9.2
+      c4\semppK c
+    }
+  >>
+  \context Staff = "sT" <<
+    \set Staff.instrumentName = \markup \column { Right padding }
+    \relative c'' {
+      \key es \major
+      c4\semppT c\p c c | c\ff c c\semppT c
+    }
+  >>
+  \context Staff = "sM" <<
+    \set Staff.instrumentName = \markup \column { Setting dimension "to zero" }
+    \relative c'' {
+      \key es \major
+      c4\semppM c\p c c | c\ff c c\semppM c
+    }
+  >>
+  \context Staff = "sG" <<
+    \set Staff.instrumentName = \markup \column { Shifting inside dynamics }
+    \relative c'' {
+      \key es \major
+      c4\semppG c\p c c | c\ff c c\semppG c
+    }
+  >>
+  \context Staff = "sMII" <<
+    \set Staff.instrumentName = \markup \column { Alignment inside dynamics }
+    \relative c'' {
+      \key es \major
+      % Setting to ##f (false) gives the same result
+      \override DynamicText.X-offset = #0
+      c4\semppMII c\p c c | c\ff c c\semppMII c
+    }
+  >>
+>>