From: Jürgen Reuter <j@web.de>
Date: Wed, 2 Jul 2003 22:15:00 +0000 (+0000)
Subject: * Documentation/user/refman.itely (Gregorian square neumes
X-Git-Tag: release/1.7.24~16
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=8c29be317f46136a5dd1b2b0c46abb04602548c4;p=lilypond.git
* Documentation/user/refman.itely (Gregorian square neumes
ligatures): fixed typo
* lily/vaticana-ligature-engraver.cc,
lily/include/vaticana-ligature.hh: bugfix: use special heads for
lower/upper head of Pes only when heads are stacked
* lily/vaticana-ligature-engraver.cc, lily/vaticana-ligature.cc,
scm/define-grob-properties.scm: cleanup: make "join-left" a
boolean grob property and save delta pitch in grob property
"delta-pitch" instead
* lily/include/gregorian-ligature.hh: bugfix: corrected comments
---
diff --git a/ChangeLog b/ChangeLog
index 17a831b2ad..2d5b76df4d 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,19 @@
+2003-07-03 Juergen Reuter <reuter@ipd.uka.de>
+
+ * Documentation/user/refman.itely (Gregorian square neumes
+ ligatures): fixed typo
+
+ * lily/vaticana-ligature-engraver.cc,
+ lily/include/vaticana-ligature.hh: bugfix: use special heads for
+ lower/upper head of Pes only when heads are stacked
+
+ * lily/vaticana-ligature-engraver.cc, lily/vaticana-ligature.cc,
+ scm/define-grob-properties.scm: cleanup: make "join-left" a
+ boolean grob property and save delta pitch in grob property
+ "delta-pitch" instead
+
+ * lily/include/gregorian-ligature.hh: bugfix: corrected comments
+
2003-07-02 Han-Wen Nienhuys <hanwen@cs.uu.nl>
* lily/parser.yy (Repeated_music): bug fix beam multiplicity was
diff --git a/Documentation/user/refman.itely b/Documentation/user/refman.itely
index a8ceca8099..a899059905 100644
--- a/Documentation/user/refman.itely
+++ b/Documentation/user/refman.itely
@@ -6136,7 +6136,7 @@ volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
@tab
@item
-@code{16. Trigomus}
+@code{16. Trigonus}
@tab
@lilypond[noindent, 26pt, nofragment, linewidth=1.0cm]
\include "gregorian-init.ly"
diff --git a/lily/include/gregorian-ligature.hh b/lily/include/gregorian-ligature.hh
index d1811e4d96..299c37833c 100644
--- a/lily/include/gregorian-ligature.hh
+++ b/lily/include/gregorian-ligature.hh
@@ -15,8 +15,8 @@
* setting a gregorian ligature grob property or using the "\~"
* keyword). If the according bit of the head prefix value is set,
* the attribute applies for this head. The binary opereator "\~" is
- * marked only upon the second head (i.e. the note that comes after
- * the operator).
+ * treated like a prefix for the head that follows the operator, but
+ * does not affect the head that precedes the operator, if any.
*/
#define VIRGA 0x0001 // attribute "\virga"
#define STROPHA 0x0002 // attribute "\stropha"
@@ -33,7 +33,10 @@
/*
* Ligature context info: these attributes are derived from the head
- * prefixes by considering the current and the following head.
+ * prefixes by considering the current and the two neighbouring heads.
+ *
+ * These definitions may be extended by more specific Gregorian
+ * ligatures such as vaticana-ligature.hh.
*/
#define PES_LOWER 0x0001 // this is a head before "\~" in an
// ascending melody
diff --git a/lily/include/vaticana-ligature.hh b/lily/include/vaticana-ligature.hh
index feb965d355..72f78fe18d 100644
--- a/lily/include/vaticana-ligature.hh
+++ b/lily/include/vaticana-ligature.hh
@@ -19,4 +19,12 @@ struct Vaticana_ligature
static bool has_interface (Grob *);
};
+/*
+ * Ligature context info: these attributes are derived from the head
+ * prefixes by considering the current and the two neighbouring heads.
+ *
+ * The below definition extends those in gregorian-ligature.hh.
+ */
+#define STACKED_HEAD 0x0100 // this head is stacked on the previous one
+
#endif // VATICANA_LIGATURE_HH
diff --git a/lily/vaticana-ligature-engraver.cc b/lily/vaticana-ligature-engraver.cc
index 2486acaf8b..3ccc3a861f 100644
--- a/lily/vaticana-ligature-engraver.cc
+++ b/lily/vaticana-ligature-engraver.cc
@@ -25,15 +25,11 @@ class Vaticana_ligature_engraver : public Gregorian_ligature_engraver
{
private:
- Real finish_primitive (Item *first_primitive,
- Item *primitive,
- int prefix_set,
- int context_info,
- String glyph_name,
- int pitch_delta,
- Real flexa_width,
- Real join_thickness,
- Real distance);
+ bool is_stacked_head (int prefix_set,
+ int context_info);
+ Real align_heads (Array<Grob_info> primitives,
+ Real flexa_width,
+ Real join_thickness);
public:
TRANSLATOR_DECLARATIONS(Vaticana_ligature_engraver);
@@ -54,57 +50,117 @@ Vaticana_ligature_engraver::create_ligature_spanner ()
return new Spanner (get_property ("VaticanaLigature"));
}
-Real
-Vaticana_ligature_engraver::finish_primitive (Item *first_primitive,
- Item *primitive,
- int prefix_set,
- int context_info,
- String glyph_name,
- int pitch_delta,
- Real flexa_width,
- Real join_thickness,
- Real distance)
+bool
+Vaticana_ligature_engraver::is_stacked_head (int prefix_set,
+ int context_info)
{
- Real next_distance = distance;
- if (primitive)
- { // determine width of previous head and x-offset
- Real head_width;
- Real x_offset;
- bool is_stacked;
+ bool is_stacked_b;
// upper head of pes is stacked upon lower head of pes ...
- is_stacked = context_info & PES_UPPER;
+ is_stacked_b = context_info & PES_UPPER;
// ... unless this note starts a flexa
if (context_info & FLEXA_LEFT)
- is_stacked = false;
+ is_stacked_b = false;
// ... or another pes
if (context_info & PES_LOWER)
- is_stacked = false;
+ is_stacked_b = false;
// ... or the previous note is a semivocalis or inclinatum
if (context_info & AFTER_DEMINUTUM)
- is_stacked = false;
+ is_stacked_b = false;
// auctum head is never stacked upon preceding note
if (prefix_set & AUCTUM)
- is_stacked = false;
+ is_stacked_b = false;
// virga is never stacked upon preceding note
if (prefix_set & VIRGA)
- is_stacked = false;
+ is_stacked_b = false;
// oriscus is never stacked upon preceding note
if (prefix_set & ORISCUS)
- is_stacked = false;
+ is_stacked_b = false;
if ((prefix_set & DEMINUTUM) &&
!(prefix_set & INCLINATUM) &&
(context_info & FLEXA_RIGHT))
- is_stacked = true; // semivocalis head of deminutus form
+ is_stacked_b = true; // semivocalis head of deminutus form
+
+ return is_stacked_b;
+}
+
+Real
+Vaticana_ligature_engraver::align_heads (Array<Grob_info> primitives,
+ Real flexa_width,
+ Real join_thickness)
+{
+ Item *first_primitive = dynamic_cast<Item*> (primitives[0].grob_);
+ Real ligature_width = 0.0;
+
+ /*
+ * Amount of extra space two put between some particular
+ * configurations of adjacent heads.
+ *
+ * TODO: make this a property of primtive grobs.
+ */
+ Real extra_space = 2.0 * join_thickness;
+
+ for (int i = 0; i < primitives.size(); i++)
+ {
+ Item *primitive = dynamic_cast<Item*> (primitives[i].grob_);
+
+ /*
+ * Get glyph_name, delta_pitch and context_info for this head.
+ */
- if (is_stacked)
+ SCM glyph_name_scm = primitive->get_grob_property ("glyph-name");
+ if (glyph_name_scm == SCM_EOL)
+ {
+ primitive->programming_error ("Vaticana_ligature:"
+ "undefined glyph-name -> "
+ "ignoring grob");
+ return 0.0;
+ }
+ String glyph_name = ly_scm2string (glyph_name_scm);
+
+ int delta_pitch;
+ SCM delta_pitch_scm = primitive->get_grob_property ("delta-pitch");
+ if (delta_pitch_scm != SCM_EOL)
+ {
+ delta_pitch = gh_scm2int (delta_pitch_scm);
+ }
+ else
+ {
+ primitive->programming_error ("Vaticana_ligature:"
+ "delta-pitch undefined -> "
+ "ignoring grob");
+ return 0.0;
+ }
+
+ int context_info;
+ SCM context_info_scm = primitive->get_grob_property ("context-info");
+ if (context_info_scm != SCM_EOL)
+ {
+ context_info = gh_scm2int (context_info_scm);
+ }
+ else
+ {
+ primitive->programming_error ("Vaticana_ligature:"
+ "context-info undefined -> "
+ "ignoring grob");
+ return 0.0;
+ }
+
+ /*
+ * Now determine width and x-offset of head.
+ */
+
+ Real head_width;
+ Real x_offset;
+
+ if (context_info & STACKED_HEAD)
{
/*
* This head is stacked upon the previous one; hence, it
@@ -137,10 +193,8 @@ Vaticana_ligature_engraver::finish_primitive (Item *first_primitive,
}
/*
- * Save the head's final shape and x-offset.
+ * Save the head's final x-offset.
*/
- primitive->set_grob_property ("glyph-name",
- scm_makfrom0str (glyph_name.to_str0 ()));
primitive->set_grob_property ("x-offset",
gh_double2scm (x_offset));
@@ -153,49 +207,58 @@ Vaticana_ligature_engraver::finish_primitive (Item *first_primitive,
((context_info & FLEXA_RIGHT) &&
!(context_info & PES_LOWER)))
{
- primitive->set_grob_property ("join-left",
- gh_int2scm (pitch_delta));
+ primitive->set_grob_property ("join-left", gh_bool2scm(true));
/*
* Create a small overlap of adjacent heads so that the join
* can be drawn perfectly between them.
*/
- next_distance -= join_thickness;
+ ligature_width -= join_thickness;
}
else if (!String::compare (glyph_name, ""))
{
/*
- * 2nd (virtual) head of flexa shape: join tightly with 1st
- * head, i.e. do *not* add additional space, such that next
- * head will not be off from the flexa shape.
+ * This is the 2nd (virtual) head of flexa shape. Join it
+ * tightly with 1st head, i.e. do *not* add additional
+ * space, such that next head will not be off from the flexa
+ * shape.
*/
}
else if (context_info & AFTER_VIRGA)
{
/*
- * Make a small space after a virga.
+ * After a virga, make a an additional small space such that
+ * the appendix on the right side of the head does not touch
+ * the following head.
*/
- next_distance += 2 * join_thickness;
+ ligature_width += extra_space;
}
- else if (pitch_delta == 0)
+ else if (delta_pitch == 0)
{
/*
- * Make a small space between two adjacent notes with the
- * same pitch.
+ * If there are two adjacent noteheads with the same pitch,
+ * add additional small space between them, such that they
+ * do not touch each other.
*/
- next_distance += 2 * join_thickness;
+ ligature_width += extra_space;
}
/*
* Horizontally line-up this head to form a ligature.
*/
get_set_column (primitive, first_primitive->get_column ());
- primitive->translate_axis (next_distance, X_AXIS);
- next_distance += head_width;
+ primitive->translate_axis (ligature_width, X_AXIS);
+ ligature_width += head_width;
}
- return next_distance;
+ /*
+ * Add extra horizontal padding space after ligature, such that
+ * neighbouring ligatures do not touch each other.
+ */
+ ligature_width += extra_space;
+
+ return ligature_width;
}
void
@@ -210,8 +273,9 @@ Vaticana_ligature_engraver::transform_heads (Spanner *ligature,
}
else
{
- programming_error ("Vaticana_ligature_engraver:"
- "flexa-width undefined; assuming 2.0 staff space");
+ ligature->programming_error ("Vaticana_ligature_engraver:"
+ "flexa-width undefined; "
+ "assuming 2.0 staff space");
flexa_width =
2.0 * Staff_symbol_referencer::staff_space (ligature);
}
@@ -224,29 +288,46 @@ Vaticana_ligature_engraver::transform_heads (Spanner *ligature,
}
else
{
- programming_error ("Vaticana_ligature_engraver:"
- "thickness undefined; assuming 1.4 linethickness");
+ ligature->programming_error ("Vaticana_ligature_engraver:"
+ "thickness undefined; "
+ "assuming 1.4 linethickness");
join_thickness = 1.4;
}
join_thickness *= ligature->get_paper ()->get_var ("linethickness");
- Item *first_primitive = 0;
Item *prev_primitive = 0;
int prev_prefix_set = 0;
int prev_context_info = 0;
int prev_pitch = 0;
- int prev_pitch_delta = 0;
String prev_glyph_name = "";
- Real prev_distance = 0.0;
for (int i = 0; i < primitives.size(); i++) {
Item *primitive = dynamic_cast<Item*> (primitives[i].grob_);
Music *music_cause = primitives[i].music_cause ();
- int context_info = gh_scm2int (primitive->get_grob_property ("context-info"));
- int pitch = unsmob_pitch (music_cause->get_mus_property ("pitch"))->steps ();
- String glyph_name;
- if (!first_primitive)
- first_primitive = primitive;
- int prefix_set = gh_scm2int (primitive->get_grob_property ("prefix-set"));
+
+ /* compute interval between previous and current primitive */
+ int pitch =
+ unsmob_pitch (music_cause->get_mus_property ("pitch"))->steps ();
+ int delta_pitch;
+ if (i == 0)
+ {
+ delta_pitch = 0;
+ }
+ else
+ {
+ delta_pitch = pitch - prev_pitch;
+ }
+
+ /* retrieve & complete prefix_set and context_info */
+ int prefix_set =
+ gh_scm2int (primitive->get_grob_property ("prefix-set"));
+ int context_info =
+ gh_scm2int (primitive->get_grob_property ("context-info"));
+ if (is_stacked_head (prefix_set, context_info))
+ {
+ context_info |= STACKED_HEAD;
+ primitive->set_grob_property ("context-info",
+ gh_int2scm (context_info));
+ }
/*
* Now determine which head to typeset (this is context sensitive
@@ -254,6 +335,7 @@ Vaticana_ligature_engraver::transform_heads (Spanner *ligature,
* this decision must be made here in the engraver rather than in
* the backend).
*/
+ String glyph_name;
if (prefix_set & VIRGA)
glyph_name = "vaticana_virga";
else if (prefix_set & QUILISMA)
@@ -272,12 +354,12 @@ Vaticana_ligature_engraver::transform_heads (Spanner *ligature,
else
glyph_name = "vaticana_inclinatum";
else if (prefix_set & DEMINUTUM)
- if (primitive == first_primitive)
+ if (i == 0)
{
// initio debilis
glyph_name = "vaticana_reverse_plica";
}
- else if (pitch > prev_pitch)
+ else if (delta_pitch > 0)
{
// epiphonus
if (!(prev_context_info & FLEXA_RIGHT))
@@ -286,18 +368,18 @@ Vaticana_ligature_engraver::transform_heads (Spanner *ligature,
}
glyph_name = "vaticana_plica";
}
- else // (pitch <= prev_pitch)
+ else // (delta_pitch <= 0)
{
// cephalicus
if (!(prev_context_info & FLEXA_RIGHT))
{
- if (prev_primitive == first_primitive)
+ if (i > 1)
{
- prev_glyph_name = "vaticana_cephalicus";
+ prev_glyph_name = "vaticana_inner_cephalicus";
}
else
{
- prev_glyph_name = "vaticana_inner_cephalicus";
+ prev_glyph_name = "vaticana_cephalicus";
}
}
glyph_name = "vaticana_reverse_plica";
@@ -318,42 +400,50 @@ Vaticana_ligature_engraver::transform_heads (Spanner *ligature,
(context_info & PES_LOWER) &&
(context_info & FLEXA_RIGHT))
glyph_name = ""; // second head of flexa shape
- else if (context_info & PES_UPPER)
- if (pitch - prev_pitch > 1)
+ else if ((context_info & STACKED_HEAD) &&
+ (context_info & PES_UPPER))
+ if (delta_pitch > 1)
glyph_name = "vaticana_upes";
else
glyph_name = "vaticana_vupes";
+ else if ((context_info & FLEXA_LEFT) &&
+ !(prefix_set && PES_OR_FLEXA))
+ glyph_name = "vaticana_rvirga";
else
glyph_name = "vaticana_punctum";
/*
- * May need updating previous head, depending on the current head.
+ * If the head for the current primitive represents the right head
+ * of a flexa or the upper head of a pes, then this may affect the
+ * shape of the previous head.
*/
if (prefix_set & PES_OR_FLEXA)
- if ((context_info & PES_LOWER) &&
- (context_info & FLEXA_RIGHT)) // flexa shape
- {
- prev_glyph_name = "flexa";
- prev_primitive->set_grob_property ("flexa-height",
- gh_int2scm (pitch - prev_pitch));
- prev_primitive->set_grob_property ("flexa-width",
- gh_double2scm (flexa_width));
- bool add_stem =
- !(prev_context_info & PES_UPPER) &&
- !(prev_context_info & FLEXA_RIGHT);
- prev_primitive->set_grob_property ("add-stem",
- gh_bool2scm (add_stem));
- }
- else if (context_info & PES_UPPER)
- {
- if (!String::compare (prev_glyph_name, "vaticana_punctum"))
- prev_glyph_name = "vaticana_lpes";
- }
- else // flexa
- {
- if (!String::compare (prev_glyph_name, "vaticana_punctum"))
- prev_glyph_name = "vaticana_rvirga";
- }
+ {
+ if ((context_info & FLEXA_RIGHT) && (context_info & PES_LOWER))
+ {
+ // join the two flexa heads into a single curved flexa shape
+ prev_glyph_name = "flexa";
+ prev_primitive->set_grob_property ("flexa-height",
+ gh_int2scm (delta_pitch));
+ prev_primitive->set_grob_property ("flexa-width",
+ gh_double2scm (flexa_width));
+ bool add_stem = !(prev_prefix_set && PES_OR_FLEXA);
+ prev_primitive->set_grob_property ("add-stem",
+ gh_bool2scm (add_stem));
+ }
+ if ((context_info & PES_UPPER) && (context_info & STACKED_HEAD))
+ {
+ if (!String::compare (prev_glyph_name, "vaticana_punctum"))
+ prev_glyph_name = "vaticana_lpes";
+ }
+ }
+
+ if (prev_primitive)
+ prev_primitive->set_grob_property ("glyph-name",
+ scm_makfrom0str (prev_glyph_name.to_str0 ()));
+
+ primitive->set_grob_property ("delta-pitch",
+ gh_int2scm (delta_pitch));
/*
* In the backend, flexa shapes and joins need to know about
@@ -363,52 +453,32 @@ Vaticana_ligature_engraver::transform_heads (Spanner *ligature,
*/
primitive->set_grob_property ("thickness", gh_double2scm (join_thickness));
- /*
- * The head of the current iteration still may change during the
- * next iteration due to the context sensitiveness of the
- * transformation. However, the head of the previous iteration is
- * now fully attributed and can be prepared for the backend.
- */
-
- /*
- * Finish head of previous iteration for backend.
- */
- prev_distance =
- finish_primitive (first_primitive, prev_primitive, prev_prefix_set,
- prev_context_info, prev_glyph_name, prev_pitch_delta,
- flexa_width, join_thickness, prev_distance);
-
prev_primitive = primitive;
prev_prefix_set = prefix_set;
prev_context_info = context_info;
- prev_pitch_delta = pitch - prev_pitch;
prev_pitch = pitch;
prev_glyph_name = glyph_name;
}
- /*
- * Finish head of last iteration for backend.
- */
- prev_distance =
- finish_primitive (first_primitive, prev_primitive, prev_prefix_set,
- prev_context_info, prev_glyph_name, prev_pitch_delta,
- flexa_width, join_thickness, prev_distance);
+ prev_primitive->set_grob_property ("glyph-name",
+ scm_makfrom0str (prev_glyph_name.to_str0 ()));
- /* TODO: make this cfg'able via SCM */
- Real padding = join_thickness;
+#if 0
+ Real ligature_width =
+#endif
- /* horizontal padding space after ligature */
- prev_distance += padding;
+ align_heads (primitives, flexa_width, join_thickness);
#if 0 // experimental code to collapse spacing after ligature
/* TODO: set to max(old/new spacing-increment), since other
voices/staves also may want to set this property. */
+ Item *first_primitive = dynamic_cast<Item*> (primitives[0].grob_);
Paper_column *paper_column = first_primitive->get_column();
paper_column->warning (_f ("Vaticana_ligature_engraver: "
"setting `spacing-increment = %f': ptr=%ul",
- prev_distance, paper_column));
+ ligature_width, paper_column));
paper_column->
- set_grob_property("forced-spacing", gh_double2scm (prev_distance));
+ set_grob_property("forced-spacing", gh_double2scm (ligature_width));
#endif
}
diff --git a/lily/vaticana-ligature.cc b/lily/vaticana-ligature.cc
index 2f0cd7bc09..9639cab8b4 100644
--- a/lily/vaticana-ligature.cc
+++ b/lily/vaticana-ligature.cc
@@ -248,21 +248,30 @@ vaticana_brew_primitive (Grob *me, bool ledger_take_space)
out.add_molecule (mol);
}
- SCM join_left_scm = me->get_grob_property ("join-left");
- if (join_left_scm != SCM_EOL)
+ if (to_boolean (me->get_grob_property ("join-left")))
{
- int join_left = gh_scm2int (join_left_scm);
- if (!join_left)
- programming_error (_f ("Vaticana_ligature: (join_left == 0)"));
- Real blotdiameter = (me->get_paper ()->get_var ("blotdiameter"));
- Interval x_extent = Interval (0, thickness);
- Interval y_extent = (join_left > 0) ?
- Interval (-join_left * 0.5 * staff_space, 0) : // ascending join
- Interval (0, -join_left * 0.5 * staff_space); // descending join
- Box stem_box (x_extent, y_extent);
-
- Molecule stem = Lookup::roundfilledbox (stem_box, blotdiameter);
- out.add_molecule (stem);
+ SCM delta_pitch_scm = me->get_grob_property ("delta-pitch");
+ if (delta_pitch_scm != SCM_EOL)
+ {
+ int delta_pitch = gh_scm2int (delta_pitch_scm);
+ if (!delta_pitch)
+ programming_error (_f ("Vaticana_ligature: (delta_pitch == 0)"));
+ Real blotdiameter = (me->get_paper ()->get_var ("blotdiameter"));
+ Interval x_extent = Interval (0, thickness);
+ Interval y_extent = (delta_pitch > 0) ?
+ Interval (-delta_pitch * 0.5 * staff_space, 0) : // ascending join
+ Interval (0, -delta_pitch * 0.5 * staff_space); // descending join
+ Box stem_box (x_extent, y_extent);
+
+ Molecule stem = Lookup::roundfilledbox (stem_box, blotdiameter);
+ out.add_molecule (stem);
+ }
+ else
+ {
+ programming_error (_f ("Vaticana_ligature:"
+ "delta-pitch -> ignoring join",
+ me));
+ }
}
int pos = (int)rint (Staff_symbol_referencer::get_position (me));
@@ -295,4 +304,4 @@ Vaticana_ligature::brew_molecule (SCM)
ADD_INTERFACE (Vaticana_ligature, "vaticana-ligature-interface",
"A vaticana style gregorian ligature",
"glyph-name flexa-height flexa-width thickness join-left "
- "add-stem x-offset ligature-primitive-callback");
+ "delta-pitch add-stem x-offset ligature-primitive-callback");
diff --git a/scm/define-grob-properties.scm b/scm/define-grob-properties.scm
index 1069d2303a..f9e3d92302 100644
--- a/scm/define-grob-properties.scm
+++ b/scm/define-grob-properties.scm
@@ -531,10 +531,10 @@ staff in a row more often, when the heights of the notes vary.
(grob-property-description 'grace-space-factor number? "space grace at this fraction of the increment.")
(grob-property-description 'position-callbacks list? "list of
functions set spanner positions.")
-(grob-property-description 'join-left number? "in ligature such as pes and flexa, the length of the vertical joining beam attached to the left side of the head")
-(grob-property-description 'delta-pitch number? "DOCME")
+(grob-property-description 'join-left boolean? "is this ligature head joined with the previous one?")
+(grob-property-description 'delta-pitch number? "the interval between this and the neighbouring note, or, more precisely, their vertical distance; this is used in ligatures for calculation of the height of vertical joins flexa shapes")
(grob-property-description 'head-width ly:dimension? "width of this ligature head")
-(grob-property-description 'primitive number? "DOCME")
+(grob-property-description 'primitive ly:grob? "Pointer to a ligature primitive, i.e. an item similar to a note head that is part of a ligature.")
(grob-property-description 'minimum-beam-collision-distance ly:dimension?
"Minimum distance to beam for a rest collision.")