[Lilypond-auto] [LilyIssues-auto] [testlilyissues:issues] #4948 Doc: Extending - rewrite para describing LP variables in Scheme Tutorial

[Auto mailings of changes to Lily Issues]

• status: Fixed --> Verified

---

[issues:#4948] Doc: Extending - rewrite para describing LP variables in Scheme Tutorial

Status: Verified
Labels: Fixed_2_19_47
Created: Sun Jul 31, 2016 04:30 PM UTC by pkx166h
Last Updated: Wed Aug 10, 2016 04:24 PM UTC
Owner: pkx166h

On 29/07/16 21:32, catalaco - wrote:

The last paragraph of 1.2.2 LilyPond variableshttp://lilypond.org/doc/v2.18/Documentation/extending/lilypond-variables in Extending LilyPondhttp://lilypond.org/doc/v2.18/Documentation/extending/index is very hard to understand.
The whole thing might need to be rewritten but I don't understand enough to do that. All I can do is offer suggestions for rephrasing, although I might be misinterpreting as I'm not fully understanding what I'm reading!

Original text

The usual way to refer to Lilypond variables, LilyPond Scheme syntaxhttp://lilypond.org/doc/v2.18/Documentation/extending/lilypond-scheme-syntax, is to call them using a backslash, i.e., \twentyFour.
Since this creates a copy of the value for most of LilyPond’s internal types, in particular music expressions, music functions don’t usually create copies of material they change. For this reason, music expressions given with # should usually not contain material that is not either created from scratch or explicitly copied rather than directly referenced.

---

Rephrased

Lilypond variables are usually called using a backslash, e.g. \twentyFour (see LilyPond Scheme syntaxhttp://lilypond.org/doc/v2.18/Documentation/extending/lilypond-scheme-syntax), which creates a copy of the value. For that reason music functions in LilyPond don't usually create copies of material they change. Because of this, scheme music expressions written with the # syntax should not directly reference material. They should only be used for material created from scratch or explicitly copied.

Greetings,
Martin

---

Sent from sourceforge.net because address@hidden is subscribed to https://sourceforge.net/p/testlilyissues/issues/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/testlilyissues/admin/issues/options. Or, if this is a mailing list, you can unsubscribe from the mailing list.

------------------------------------------------------------------------------
Developer Access Program for Intel Xeon Phi Processors
Access to Intel Xeon Phi processor-based developer platforms.
With one year of Intel Parallel Studio XE.
Training and support from Colfax.
Order your platform today. http://sdm.link/xeonphi

_______________________________________________
Testlilyissues-auto mailing list
address@hidden
https://lists.sourceforge.net/lists/listinfo/testlilyissues-auto