X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=lily%2Fitem.cc;h=ee3ee99d17bc234c13a9a5fb2f4fcb32e450cfc9;hb=1250bccd52cc74203c10f7815008bd47635fcf83;hp=fdf9b00ce9d36c1498076dc221e6ab01f992be61;hpb=df2459d457ba9cca8ec6b5dfb071f146aaef117a;p=lilypond.git diff --git a/lily/item.cc b/lily/item.cc index fdf9b00ce9..ee3ee99d17 100644 --- a/lily/item.cc +++ b/lily/item.cc @@ -1,9 +1,20 @@ /* - item.cc -- implement Item + This file is part of LilyPond, the GNU music typesetter. - source file of the GNU LilyPond music typesetter + Copyright (C) 1997--2009 Han-Wen Nienhuys - (c) 1997--2007 Han-Wen Nienhuys + LilyPond is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + LilyPond is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with LilyPond. If not, see . */ #include "item.hh" @@ -249,28 +260,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" + " (@code{-1}, @code{0} or@tie{}@code{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 +295,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-height " "extra-spacing-width " - "infinite-spacing-height " - "non-musical") + "non-musical " + );