From: David Kastrup <dak@gnu.org>
Date: Thu, 11 Jun 2015 09:27:46 +0000 (+0200)
Subject: Issue 4444: Better function documentation for \overrideProperty
X-Git-Tag: release/2.19.22-1~40
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=a392363c4c1c3b6d7ff59df918ede76161247e39;p=lilypond.git

Issue 4444: Better function documentation for \overrideProperty
---

diff --git a/ly/music-functions-init.ly b/ly/music-functions-init.ly
index 563f97dfcb..6ccecd6581 100644
--- a/ly/music-functions-init.ly
+++ b/ly/music-functions-init.ly
@@ -954,7 +954,13 @@ overrideProperty =
    (_i "Set the grob property specified by @var{grob-property-path} to
 @var{value}.  @var{grob-property-path} is a symbol list of the form
 @code{Context.GrobName.property} or @code{GrobName.property}, possibly
-with subproperties given as well.")
+with subproperties given as well.
+
+As opposed to @code{\\override} which overrides the context-dependent
+defaults with which a grob is created, this command uses
+@code{Output_property_engraver} at the grob acknowledge stage.  This
+may be necessary for overriding values set after the initial grob
+creation.")
    (let ((p (check-grob-path grob-property-path (*location*)
                              #:default 'Bottom
                              #:min 3)))