ADD_INTERFACE: Formatting and fixing typos.

[lilypond.git] / lily / item.cc

diff --git a/lily/item.cc b/lily/item.cc
index fdf9b00ce9d36c1498076dc221e6ab01f992be61..82147a46552b41718b43d931e0a707459a093578 100644 (file)
--- a/lily/item.cc
+++ b/lily/item.cc
@@ -249,28 +249,31 @@ Item::less (Grob * const &g1, Grob * const &g2)
 }
 
 ADD_INTERFACE (Item,
-
-              "Grobs can be distinguished in their role in the horizontal spacing.\n"
-              "Many grobs define constraints on the spacing by their sizes. For\n"
-              "example, note heads, clefs, stems, and all other symbols with a fixed\n"
-              "shape.  These grobs form a subtype called @code{Item}.\n"
-              "\n"
+              "Grobs can be distinguished in their role in the horizontal "
+              "spacing.  Many grobs define constraints on the spacing by "
+              "their sizes, for example, note heads, clefs, stems, and all "
+              "other symbols with a fixed shape.  These grobs form a "
+              "subtype called @code{Item}.\n"
               "\n"
-              "Some items need special treatment for line breaking. For example, a\n"
-              "clef is normally only printed at the start of a line (i.e. after a\n"
-              "line break).  To model this, `breakable' items (clef, key signature,\n"
-              "bar lines, etc.) are copied twice. Then we have three versions of each\n"
-              "breakable item: one version if there is no line break, one version\n"
-              "that is printed before the line break (at the end of a system), one\n"
-              "version that is printed after the line break.\n"
+              "Some items need special treatment for line breaking.  For "
+              "example, a clef is normally only printed at the start of a "
+              "line (i.e., after a line break).   To model this, "
+              "@q{breakable} items (clef, key signature, bar lines, etc.) "
+              "are copied twice.  Then we have three versions of each "
+              "breakable item: one version if there is no line break, one "
+              "version that is printed before the line break (at the end of "
+              "a system), and one version that is printed after the line "
+              "break.\n"
               "\n"
-              "Whether these versions are visible and take up space, is determined by\n"
-              "the outcome of the @code{break-visibility}. This grob property is a\n"
-              "function taking a direction (-1, 0 or 1) as argument. It returns a\n"
-              "cons of booleans, signifying whether this grob should be transparent\n"
-              "and have no extent.\n"
+              "Whether these versions are visible and take up space is "
+              "determined by the outcome of the @code{break-visibility} "
+              "grob property, which is a function taking a direction (-1, 0 "
+              "or@tie{}1) as an argument.  It returns a cons of booleans, "
+              "signifying whether this grob should be transparent and have "
+              "no extent.\n"
               "\n"
-              "The following variables for break-visibility are predefined:\n"
+              "The following variables for @code{break-visibility} are "
+              "predefined:\n"
               "@example\n"
               "           grob will show:   before  no     after\n"
               "                             break   break  break\n"
@@ -281,10 +284,11 @@ ADD_INTERFACE (Item,
               "  begin-of-line-invisible    yes     yes    no\n"
               "  end-of-line-invisible      no      yes    yes\n"
               "  center-invisible           yes      no    yes\n"
-              "@end example\n",
+              "@end example",
 
               /* properties */
               "break-visibility "
               "extra-spacing-width "
               "infinite-spacing-height "
-              "non-musical")
+              "non-musical "
+              );