]> git.donarmstrong.com Git - lilypond.git/blobdiff - lily/grob.cc
* flower
[lilypond.git] / lily / grob.cc
index a39ac0f4126fd851679aefc2d95b5b0ff95adc67..0594582d79ad343231f0307163a0b1a58081f8d8 100644 (file)
@@ -3,11 +3,12 @@
 
   source file of the GNU LilyPond music typesetter
 
-  (c) 1997--2004 Han-Wen Nienhuys <hanwen@cs.uu.nl>
+  (c) 1997--2005 Han-Wen Nienhuys <hanwen@cs.uu.nl>
 */
 
+#include "grob.hh"
 
-#include <string.h>
+#include <cstring>
 #include <math.h>
 
 #include "main.hh"
@@ -17,9 +18,7 @@
 #include "misc.hh"
 #include "paper-score.hh"
 #include "stencil.hh"
-#include "grob.hh"
 #include "warn.hh"
-#include "spanner.hh"
 #include "system.hh"
 #include "item.hh"
 #include "stencil.hh"
 
 #include "ly-smobs.icc"
 
+Grob *
+Grob::clone (int count) const
+{
+  return new Grob (*this, count);
+}
+
 /* TODO:
 
-  - remove dynamic_cast<Spanner,Item> and put this code into respective
-    subclass.  */
+- remove dynamic_cast<Spanner, Item> and put this code into respective
+subclass.  */
 
 #define HASH_SIZE 3
 #define INFINITY_MSG "Infinity or NaN encountered"
 
-Grob::Grob (SCM basicprops)
+Grob::Grob (SCM basicprops,
+           Object_key const *key)
 {
+  key_ = key;
   /* FIXME: default should be no callback.  */
   self_scm_ = SCM_EOL;
-  pscore_= 0;
+  pscore_ = 0;
   status_ = 0;
   original_ = 0;
-  immutable_property_alist_ =  basicprops;
+  immutable_property_alist_ = basicprops;
   mutable_property_alist_ = SCM_EOL;
 
   /* We do smobify_self () as the first step.  Since the object lives
@@ -52,34 +59,38 @@ Grob::Grob (SCM basicprops)
      GC. After smobify_self (), they are.  */
   smobify_self ();
 
+  /*
+    We always get a new key object for a new grob.
+  */
+  scm_gc_unprotect_object (key_->self_scm ());
   SCM meta = get_property ("meta");
   if (scm_is_pair (meta))
     {
       SCM ifs = scm_assoc (ly_symbol2scm ("interfaces"), meta);
 
       /* Switch off interface checks for the moment.  */
-      bool itc = internal_type_checking_global_b;
-      internal_type_checking_global_b = false;
-      internal_set_property (ly_symbol2scm ("interfaces"), ly_cdr (ifs));
-      internal_type_checking_global_b = itc;
+      bool itc = do_internal_type_checking_global;
+      do_internal_type_checking_global = false;
+      internal_set_property (ly_symbol2scm ("interfaces"), scm_cdr (ifs));
+      do_internal_type_checking_global = itc;
     }
 
   /* TODO:
 
-    - destill this into a function, so we can re-init the immutable
-      properties with a new BASICPROPS value after
-      creation. Convenient eg. when using \override with
-      StaffSymbol.  */
+  - destill this into a function, so we can re-init the immutable
+  properties with a new BASICPROPS value after
+  creation. Convenient eg. when using \override with
+  StaffSymbol.  */
 
-  char const*onames[] = {"X-offset-callbacks", "Y-offset-callbacks"};
-  char const*xnames[] = {"X-extent", "Y-extent"};
-  char const*enames[] = {"X-extent-callback", "Y-extent-callback"};
+  char const *onames[] = {"X-offset-callbacks", "Y-offset-callbacks"};
+  char const *xnames[] = {"X-extent", "Y-extent"};
+  char const *enames[] = {"X-extent-callback", "Y-extent-callback"};
 
   for (int a = X_AXIS; a <= Y_AXIS; a++)
     {
       SCM l = get_property (onames[a]);
 
-      if (scm_ilength (l) >=0)
+      if (scm_ilength (l) >= 0)
        {
          dim_cache_[a].offset_callbacks_ = l;
          dim_cache_[a].offsets_left_ = scm_ilength (l);
@@ -88,24 +99,31 @@ Grob::Grob (SCM basicprops)
        programming_error ("[XY]-offset-callbacks must be a list");
 
       SCM cb = get_property (enames[a]);
-      SCM xt = get_property (xnames[a]);
+      if (cb == SCM_BOOL_F)
+       {
+         dim_cache_[a].dimension_ = SCM_BOOL_F;
+       }
 
-      /* Should change default to empty?  */
+      SCM xt = get_property (xnames[a]);
       if (is_number_pair (xt))
-       cb = xt;
-      else if (cb != SCM_BOOL_F
-         && !ly_c_procedure_p (cb) && !scm_is_pair (cb)
-         && ly_c_procedure_p (get_property ("print-function")))
-       cb = stencil_extent_proc;
-
-      dim_cache_[a].dimension_ = cb;
+       {
+         dim_cache_[a].dimension_ = xt;
+       }
+      else if (ly_c_procedure_p (cb))
+       {
+         dim_cache_[a].dimension_callback_ = cb;
+       }
+      else if (cb == SCM_EOL
+              && ly_c_procedure_p (get_property ("print-function")))
+       dim_cache_[a].dimension_callback_ = stencil_extent_proc;
     }
 }
 
-Grob::Grob (Grob const &s)
-   : dim_cache_ (s.dim_cache_)
+Grob::Grob (Grob const &s, int copy_index)
+  : dim_cache_ (s.dim_cache_)
 {
-  original_ = (Grob*) &s;
+  key_ = new Copied_key (s.key_, copy_index);
+  original_ = (Grob *) &s;
   self_scm_ = SCM_EOL;
 
   immutable_property_alist_ = s.immutable_property_alist_;
@@ -117,6 +135,7 @@ Grob::Grob (Grob const &s)
   pscore_ = 0;
 
   smobify_self ();
+  scm_gc_unprotect_object (key_->self_scm ());
 }
 
 Grob::~Grob ()
@@ -137,26 +156,24 @@ Grob::stencil_extent (SCM element_smob, SCM scm_axis)
   return ly_interval2scm (e);
 }
 
-
 Interval
-robust_relative_extent (Grob*me, Grob*refp, Axis a)
+robust_relative_extent (Grob *me, Grob *refp, Axis a)
 {
-  Interval ext =  me->extent  (refp, a);
-  if (ext.is_empty())
+  Interval ext = me->extent (refp, a);
+  if (ext.is_empty ())
     {
       ext.add_point (me->relative_coordinate (refp, a));
     }
 
-  return ext;      
+  return ext;
 }
 
 Output_def *
-Grob::get_paper () const
+Grob::get_layout () const
 {
return pscore_ ? pscore_->paper_ : 0;
 return pscore_ ? pscore_->layout_ : 0;
 }
 
-
 /* Recursively track all dependencies of this Grob.  The status_ field
    is used as a mark-field.  It is marked with BUSY during execution
    of this function, and marked with FINAL when finished.
@@ -177,8 +194,8 @@ Grob::calculate_dependencies (int final, int busy, SCM funcname)
   status_ = busy;
 
   for (SCM d = get_property ("dependencies"); scm_is_pair (d);
-       d = ly_cdr (d))
-    unsmob_grob (ly_car (d))->calculate_dependencies (final, busy, funcname);
+       d = scm_cdr (d))
+    unsmob_grob (scm_car (d))->calculate_dependencies (final, busy, funcname);
 
   SCM proc = internal_get_property (funcname);
   if (ly_c_procedure_p (proc))
@@ -188,7 +205,7 @@ Grob::calculate_dependencies (int final, int busy, SCM funcname)
 }
 
 Stencil *
-Grob::get_stencil ()  const
+Grob::get_stencil () const
 {
   if (!is_live ())
     return 0;
@@ -198,10 +215,9 @@ Grob::get_stencil ()  const
     return unsmob_stencil (stil);
 
   stil = get_uncached_stencil ();
-
   if (is_live ())
     {
-      Grob *me = (Grob*) this;
+      Grob *me = (Grob *) this;
       me->set_property ("stencil", stil);
     }
 
@@ -213,29 +229,40 @@ Grob::get_uncached_stencil () const
 {
   SCM proc = get_property ("print-function");
 
-  SCM  stil = SCM_EOL;
+  SCM stil = SCM_EOL;
   if (ly_c_procedure_p (proc))
     stil = scm_apply_0 (proc, scm_list_n (this->self_scm (), SCM_UNDEFINED));
 
   if (Stencil *m = unsmob_stencil (stil))
-     {
+    {
       if (to_boolean (get_property ("transparent")))
        stil = Stencil (m->extent_box (), SCM_EOL).smobbed_copy ();
       else
        {
-         SCM expr = scm_list_3 (ly_symbol2scm ("grob-cause"), self_scm(),
+         SCM expr = scm_list_3 (ly_symbol2scm ("grob-cause"), self_scm (),
                                 m->expr ());
-         stil = Stencil (m->extent_box (),expr). smobbed_copy ();
+         stil = Stencil (m->extent_box (), expr). smobbed_copy ();
        }
-     }
+
+      /* color support... see interpret_stencil_expression() for more... */
+      SCM color = get_property ("color");
+      if (color != SCM_EOL)
+       {
+         m = unsmob_stencil (stil);
+         SCM expr = scm_list_3 (ly_symbol2scm ("color"),
+                                color,
+                                m->expr ());
+
+         stil = Stencil (m->extent_box (), expr).smobbed_copy ();
+       }
+    }
 
   return stil;
 }
 
 /*
   VIRTUAL STUBS
-
- */
+*/
 void
 Grob::do_break_processing ()
 {
@@ -260,7 +287,7 @@ Grob::add_dependency (Grob *e)
 void
 Grob::handle_broken_dependencies ()
 {
-  Spanner *sp = dynamic_cast<Spanner*> (this);
+  Spanner *sp = dynamic_cast<Spanner *> (this);
   if (original_ && sp)
     return;
 
@@ -268,8 +295,8 @@ Grob::handle_broken_dependencies ()
     /* THIS, SP is the original spanner.  We use a special function
        because some Spanners have enormously long lists in their
        properties, and a special function fixes FOO  */
-    for (SCM s = mutable_property_alist_; scm_is_pair (s); s = ly_cdr (s))
-      sp->substitute_one_mutable_property (ly_caar (s), ly_cdar (s));
+    for (SCM s = mutable_property_alist_; scm_is_pair (s); s = scm_cdr (s))
+      sp->substitute_one_mutable_property (scm_caar (s), scm_cdar (s));
 
   System *system = get_system ();
 
@@ -279,7 +306,7 @@ Grob::handle_broken_dependencies ()
     substitute_mutable_properties (system
                                   ? system->self_scm () : SCM_UNDEFINED,
                                   mutable_property_alist_);
-  else if (dynamic_cast <System*> (this))
+  else if (dynamic_cast<System *> (this))
     substitute_mutable_properties (SCM_UNDEFINED, mutable_property_alist_);
   else
     /* THIS element is `invalid'; it has been removed from all
@@ -307,6 +334,9 @@ Grob::suicide ()
   set_extent (SCM_EOL, Y_AXIS);
   set_extent (SCM_EOL, X_AXIS);
 
+  set_extent_callback (SCM_EOL, Y_AXIS);
+  set_extent_callback (SCM_EOL, X_AXIS);
+
   for (int a = X_AXIS; a <= Y_AXIS; a++)
     {
       dim_cache_[a].offset_callbacks_ = SCM_EOL;
@@ -321,7 +351,7 @@ Grob::handle_prebroken_dependencies ()
      mutable_property_alist_ centralized.  */
   if (original_)
     {
-      Item *it = dynamic_cast<Item*> (this);
+      Item *it = dynamic_cast<Item *> (this);
       substitute_mutable_properties (scm_int2num (it->break_status_dir ()),
                                     original_->mutable_property_alist_);
     }
@@ -343,7 +373,6 @@ Grob::translate_axis (Real y, Axis a)
     dim_cache_[a].offset_ += y;
 }
 
-
 /* Find the offset relative to D.  If D equals THIS, then it is 0.
    Otherwise, it recursively defd as
 
@@ -366,14 +395,14 @@ Grob::relative_coordinate (Grob const *refp, Axis a) const
 Real
 Grob::get_offset (Axis a) const
 {
-  Grob *me = (Grob*) this;
+  Grob *me = (Grob *) this;
   while (dim_cache_[a].offsets_left_)
     {
       int l = --me->dim_cache_[a].offsets_left_;
       SCM cb = scm_list_ref (dim_cache_[a].offset_callbacks_, scm_int2num (l));
       SCM retval = scm_call_2 (cb, self_scm (), scm_int2num (a));
 
-      Real r =  scm_to_double (retval);
+      Real r = scm_to_double (retval);
       if (isinf (r) || isnan (r))
        {
          programming_error (INFINITY_MSG);
@@ -387,8 +416,22 @@ Grob::get_offset (Axis a) const
 bool
 Grob::is_empty (Axis a) const
 {
-  return ! (scm_is_pair (dim_cache_[a].dimension_)
-           || ly_c_procedure_p (dim_cache_[a].dimension_));
+  return !(scm_is_pair (dim_cache_[a].dimension_)
+          || ly_c_procedure_p (dim_cache_[a].dimension_callback_));
+}
+
+void
+Grob::flush_extent_cache (Axis axis)
+{
+  Dimension_cache *d = &dim_cache_[axis];
+  if (ly_c_procedure_p (d->dimension_callback_)
+      && scm_is_pair (d->dimension_))
+    {
+      d->dimension_ = SCM_EOL;
+
+      if (get_parent (axis))
+       get_parent (axis)->flush_extent_cache (axis);
+    }
 }
 
 Interval
@@ -398,11 +441,12 @@ Grob::extent (Grob *refp, Axis a) const
 
   Dimension_cache *d = (Dimension_cache *) &dim_cache_[a];
   Interval ext;
-  if (scm_is_pair (d->dimension_))
-    ;
-  else if (ly_c_procedure_p (d->dimension_))
-    /* FIXME: add doco on types, and should typecheck maybe?  */
-    d->dimension_= scm_call_2 (d->dimension_, self_scm (), scm_int2num (a));
+
+  SCM dimpair = d->dimension_;
+  if (scm_is_pair (dimpair));
+  else if (ly_c_procedure_p (d->dimension_callback_)
+          && d->dimension_ == SCM_EOL)
+    d->dimension_ = scm_call_2 (d->dimension_callback_, self_scm (), scm_int2num (a));
   else
     return ext;
 
@@ -418,16 +462,16 @@ Grob::extent (Grob *refp, Axis a) const
   /* Signs ?  */
   if (scm_is_pair (extra))
     {
-      ext[BIGGER] += scm_to_double (ly_cdr (extra));
-      ext[SMALLER] += scm_to_double (ly_car (extra));
+      ext[BIGGER] += scm_to_double (scm_cdr (extra));
+      ext[SMALLER] += scm_to_double (scm_car (extra));
     }
 
   extra = get_property (a == X_AXIS
                        ? "minimum-X-extent"
                        : "minimum-Y-extent");
   if (scm_is_pair (extra))
-    ext.unite (Interval (scm_to_double (ly_car (extra)),
-                        scm_to_double (ly_cdr (extra))));
+    ext.unite (Interval (scm_to_double (scm_car (extra)),
+                        scm_to_double (scm_cdr (extra))));
 
   ext.translate (x);
 
@@ -444,7 +488,7 @@ Grob::common_refpoint (Grob const *s, Axis a) const
   for (Grob const *c = this; c; c = c->dim_cache_[a].parent_)
     for (Grob const *d = s; d; d = d->dim_cache_[a].parent_)
       if (d == c)
-       return (Grob*) d;
+       return (Grob *) d;
 
   return 0;
 }
@@ -452,8 +496,8 @@ Grob::common_refpoint (Grob const *s, Axis a) const
 Grob *
 common_refpoint_of_list (SCM elist, Grob *common, Axis a)
 {
-  for (; scm_is_pair (elist); elist = ly_cdr (elist))
-    if (Grob *s = unsmob_grob (ly_car (elist)))
+  for (; scm_is_pair (elist); elist = scm_cdr (elist))
+    if (Grob *s = unsmob_grob (scm_car (elist)))
       {
        if (common)
          common = common->common_refpoint (s, a);
@@ -467,7 +511,7 @@ common_refpoint_of_list (SCM elist, Grob *common, Axis a)
 Grob *
 common_refpoint_of_array (Link_array<Grob> const &arr, Grob *common, Axis a)
 {
-  for (int i = arr.size (); i--; )
+  for (int i = arr.size (); i--;)
     if (Grob *s = arr[i])
       {
        if (common)
@@ -484,7 +528,7 @@ Grob::name () const
 {
   SCM meta = get_property ("meta");
   SCM nm = scm_assoc (ly_symbol2scm ("name"), meta);
-  nm = (scm_is_pair (nm)) ? ly_cdr (nm) : SCM_EOL;
+  nm = (scm_is_pair (nm)) ? scm_cdr (nm) : SCM_EOL;
   return scm_is_symbol (nm) ? ly_symbol2string (nm) : classname (this);
 }
 
@@ -492,21 +536,21 @@ void
 Grob::add_offset_callback (SCM cb, Axis a)
 {
   if (!has_offset_callback (cb, a))
-  {
-    dim_cache_[a].offset_callbacks_
-      = scm_cons (cb, dim_cache_[a].offset_callbacks_);
-    dim_cache_[a].offsets_left_ ++;
-  }
+    {
+      dim_cache_[a].offset_callbacks_
+       = scm_cons (cb, dim_cache_[a].offset_callbacks_);
+      dim_cache_[a].offsets_left_++;
+    }
 }
 
 bool
-Grob::has_extent_callback (SCM cb, Axis a)const
+Grob::has_extent_callback (SCM cb, Axis a) const
 {
-  return scm_equal_p (cb, dim_cache_[a].dimension_) == SCM_BOOL_T;
+  return scm_equal_p (cb, dim_cache_[a].dimension_callback_) == SCM_BOOL_T;
 }
 
 bool
-Grob::has_offset_callback (SCM cb, Axis a)const
+Grob::has_offset_callback (SCM cb, Axis a) const
 {
   return scm_c_memq (cb, dim_cache_[a].offset_callbacks_) != SCM_BOOL_F;
 }
@@ -517,18 +561,24 @@ Grob::set_extent (SCM dc, Axis a)
   dim_cache_[a].dimension_ = dc;
 }
 
+void
+Grob::set_extent_callback (SCM dc, Axis a)
+{
+  dim_cache_[a].dimension_callback_ = dc;
+}
+
 void
 Grob::set_parent (Grob *g, Axis a)
 {
   dim_cache_[a].parent_ = g;
 }
 
-MAKE_SCHEME_CALLBACK (Grob,fixup_refpoint,1);
+MAKE_SCHEME_CALLBACK (Grob, fixup_refpoint, 1);
 SCM
 Grob::fixup_refpoint (SCM smob)
 {
   Grob *me = unsmob_grob (smob);
-  for (int a = X_AXIS; a < NO_AXES; a ++)
+  for (int a = X_AXIS; a < NO_AXES; a++)
     {
       Axis ax = (Axis)a;
       Grob *parent = me->get_parent (ax);
@@ -542,13 +592,13 @@ Grob::fixup_refpoint (SCM smob)
          me->set_parent (newparent, ax);
        }
 
-      if (Item *i = dynamic_cast<Item*> (me))
+      if (Item *i = dynamic_cast<Item *> (me))
        {
-         Item *parenti = dynamic_cast<Item*> (parent);
+         Item *parenti = dynamic_cast<Item *> (parent);
 
          if (parenti && i)
            {
-             Direction  my_dir = i->break_status_dir () ;
+             Direction my_dir = i->break_status_dir ();
              if (my_dir!= parenti->break_status_dir ())
                {
                  Item *newparent = parenti->find_prebroken_piece (my_dir);
@@ -561,7 +611,7 @@ Grob::fixup_refpoint (SCM smob)
 }
 
 void
-Grob::warning (String s)const
+Grob::warning (String s) const
 {
   SCM cause = self_scm ();
   while (Grob *g = unsmob_grob (cause))
@@ -580,10 +630,9 @@ Grob::programming_error (String s) const
   warning (s);
 }
 
-
 /****************************************************
   SMOB funcs
- ****************************************************/
+****************************************************/
 
 IMPLEMENT_SMOBS (Grob);
 IMPLEMENT_DEFAULT_EQUAL_P (Grob);
@@ -591,13 +640,14 @@ IMPLEMENT_DEFAULT_EQUAL_P (Grob);
 SCM
 Grob::mark_smob (SCM ses)
 {
-  Grob *s = (Grob*) SCM_CELL_WORD_1 (ses);
+  Grob *s = (Grob *) SCM_CELL_WORD_1 (ses);
   scm_gc_mark (s->immutable_property_alist_);
-
-  for (int a = 0 ; a < 2; a++)
+  scm_gc_mark (s->key_->self_scm ());
+  for (int a = 0; a < 2; a++)
     {
       scm_gc_mark (s->dim_cache_[a].offset_callbacks_);
       scm_gc_mark (s->dim_cache_[a].dimension_);
+      scm_gc_mark (s->dim_cache_[a].dimension_callback_);
 
       /* Do not mark the parents.  The pointers in the mutable
         property list form two tree like structures (one for X
@@ -646,15 +696,21 @@ Grob::internal_has_interface (SCM k)
   return scm_c_memq (k, ifs) != SCM_BOOL_F;
 }
 
+Grob *
+Grob::get_parent (Axis a) const
+{
+  return dim_cache_[a].parent_;
+}
+
 /** Return Array of Grobs in SCM list LST */
 Link_array<Grob>
 ly_scm2grobs (SCM lst)
 {
   Link_array<Grob> arr;
 
-  for (SCM s = lst; scm_is_pair (s); s = ly_cdr (s))
+  for (SCM s = lst; scm_is_pair (s); s = scm_cdr (s))
     {
-      SCM e = ly_car (s);
+      SCM e = scm_car (s);
       arr.push (unsmob_grob (e));
     }
 
@@ -662,40 +718,45 @@ ly_scm2grobs (SCM lst)
   return arr;
 }
 
+Object_key const *
+Grob::get_key () const
+{
+  return key_;
+}
+
 /** Return SCM list of Grob array A */
 SCM
 ly_grobs2scm (Link_array<Grob> a)
 {
   SCM s = SCM_EOL;
   for (int i = a.size (); i; i--)
-    s = scm_cons (a[i-1]->self_scm (), s);
+    s = scm_cons (a[i - 1]->self_scm (), s);
 
   return s;
 }
 
-
 IMPLEMENT_TYPE_P (Grob, "ly:grob?");
 
 ADD_INTERFACE (Grob, "grob-interface",
               "A grob represents a piece of music notation\n"
               "\n"
-"All grobs have an X and Y-position on the page.  These X and Y positions\n"
-"are stored in a relative format, so they can easily be combined by\n"
-"stacking them, hanging one grob to the side of another, and coupling\n"
-"them into a grouping objects.\n"
-"\n"
-"Each grob has a reference point (a.k.a.  parent): the position of a grob\n"
-"is stored relative to that reference point. For example the X-reference\n"
-"point of a staccato dot usually is the note head that it applies\n"
-"to. When the note head is moved, the staccato dot moves along\n"
-"automatically.\n"
-"\n"
-"A grob is often associated with a symbol, but some grobs do not print\n"
-"any symbols. They take care of grouping objects. For example, there is a\n"
-"separate grob that stacks staves vertically. The @ref{NoteCollision}\n"
-"is also an abstract grob: it only moves around chords, but doesn't print\n"
-"anything.\n"
-"\n"
+              "All grobs have an X and Y-position on the page.  These X and Y positions\n"
+              "are stored in a relative format, so they can easily be combined by\n"
+              "stacking them, hanging one grob to the side of another, and coupling\n"
+              "them into a grouping objects.\n"
+              "\n"
+              "Each grob has a reference point (a.k.a.  parent): the position of a grob\n"
+              "is stored relative to that reference point. For example the X-reference\n"
+              "point of a staccato dot usually is the note head that it applies\n"
+              "to. When the note head is moved, the staccato dot moves along\n"
+              "automatically.\n"
+              "\n"
+              "A grob is often associated with a symbol, but some grobs do not print\n"
+              "any symbols. They take care of grouping objects. For example, there is a\n"
+              "separate grob that stacks staves vertically. The @ref{NoteCollision}\n"
+              "is also an abstract grob: it only moves around chords, but doesn't print\n"
+              "anything.\n"
+              "\n"
               "Grobs have a properties: Scheme variables, that can be read and set. "
               "They have two types. Immutable variables "
               "define the default style and behavior.  They are shared between  many objects. "
@@ -704,16 +765,14 @@ ADD_INTERFACE (Grob, "grob-interface",
               "Mutable properties are variables that are specific to one grob. Typically, "
               "lists of other objects, or results from computations are stored in"
               "mutable properties: every call to set-grob-property (or its C++ equivalent) "
-              "sets a mutable property. "
-
-,
+              "sets a mutable property. ",
               "X-offset-callbacks Y-offset-callbacks X-extent-callback stencil cause "
               "Y-extent-callback print-function extra-offset spacing-procedure "
-              "staff-symbol interfaces dependencies X-extent Y-extent extra-X-extent "
+              "context staff-symbol interfaces dependencies X-extent Y-extent extra-X-extent "
               "meta layer before-line-breaking-callback "
+              "color "
+              "axis-group-parent-X "
+              "axis-group-parent-Y "
               "after-line-breaking-callback extra-Y-extent minimum-X-extent "
-              // FIXME: page-penalty?
-              "minimum-Y-extent page-penalty transparent "
-              );
-
+              "minimum-Y-extent transparent tweak-count tweak-rank");