From 23c3488226827238ec04a089b9b71e709501c807 Mon Sep 17 00:00:00 2001 From: David Kastrup Date: Thu, 2 Aug 2012 12:20:10 +0200 Subject: [PATCH] Explain issue 2702 in changes.tely --- Documentation/changes.tely | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/Documentation/changes.tely b/Documentation/changes.tely index 912800a3a1..9e7c59be99 100644 --- a/Documentation/changes.tely +++ b/Documentation/changes.tely @@ -60,6 +60,27 @@ which scares away people. * only show user-visible changes. @end ignore +@item +The syntax of words (character sequences recognized without enclosing +quotes) and commands (now always a backslash @samp{\} followed by a +word) has been unified across all modes: it now consists of alphabetic +characters, possibly enclosing isolated dashes @samp{-} and underlines +@samp{_}. + +As one consequence, using unquoted text scripts like (literally!) +@example +@{ c-script c\f_script @} +@end example +will now tend to result in invalid music. Omitting quote marks +for arbitrary text rather than keywords has never been good practice or +even documented, and it is unlikely to have seen significant use. + +Staying with established conventions (like not using dashes or +underlines for command names intended to be used inside of music) +remains advisable. The reason for this change is more robust +recognition of LilyPond's lexical units for LilyPond itself as well as +external tools interpreting its syntax. + @item Support for Kievan square notation: @lilypond[quote,relative=1,verbatim] -- 2.39.2