Issue 3271: Provide \absolute music function to complement \relative

From its documentation string:

Make @var{music} absolute.  This does not actually change the
music itself but rather hides it from surrounding @code{\\relative}
commands.

diff --git a/ly/music-functions-init.ly b/ly/music-functions-init.ly
index ad9f7bdda27dfa7f9e7d5df1b5ca50742eaa6289..183bf4db21f79b5207be319967ef7d0f16e4ffd9 100644 (file)
--- a/ly/music-functions-init.ly
+++ b/ly/music-functions-init.ly
@@ -31,6 +31,14 @@
 
 %% TODO: using define-music-function in a .scm causes crash.
 
+absolute =
+#(define-music-function (parser location music)
+   (ly:music?)
+   (_i "Make @var{music} absolute.  This does not actually change the
+music itself but rather hides it from surrounding @code{\\relative}
+commands.")
+   (make-music 'RelativeOctaveMusic 'element music))
+
 acciaccatura =
 #(def-grace-function startAcciaccaturaMusic stopAcciaccaturaMusic
    (_i "Create an acciaccatura from the following music expression"))