scm/define-translator-properties.scm

   1 ;;;; translator-property-description.scm -- part of backend documentation
   2 ;;;;
   3 ;;;;  source file of the GNU LilyPond music typesetter
   4 ;;;;
   5 ;;;; (c)  1998--2003  Han-Wen Nienhuys <hanwen@cs.uu.nl>
   6 ;;;;                 Jan Nieuwenhuizen <janneke@gnu.org>
   7
   8
   9 (define-public all-translation-properties '())
  10
  11 (define (translator-property-description symbol type? description)
  12  (if (not (equal? #f (object-property symbol 'translation-doc)))
  13       (begin
  14         (ly:warn (string-append "Redefining " (symbol->string symbol) "\n"))
  15         (exit 2)
  16       ))
  17
  18   (set-object-property! symbol 'translation-type? type?)
  19   (set-object-property! symbol 'translation-doc description)
  20   (set! all-translation-properties (cons symbol all-translation-properties))
  21   )
  22
  23
  24
  25 (translator-property-description 'acceptHashTable vector? "Internal
  26 variable: store table with MusicName to Engraver entries.")
  27 (translator-property-description 'acknowledgeHashTable vector?
  28 "Internal variable: store interface to engraver smob table for current
  29 context. Don't mess with this.")
  30 (translator-property-description 'aDueText string? "text for begin of a due")
  31 (translator-property-description 'alignBassFigureAccidentals boolean?
  32                                  "If true, then the accidentals are aligned in bass figure context.")
  33
  34 (translator-property-description 'allowBeamBreak boolean?
  35                                  "If true allow line breaks during beams.")
  36 (translator-property-description 'associatedVoice string? "Name of the
  37 Voice that has the melody for this LyricsVoice.")
  38 (translator-property-description 'associatedVoiceContext ly:context? "The context object of the Voice that has the melody for this LyricsVoice.")
  39 (translator-property-description 'autoBeamSettings list? "Specifies
  40 when automatically generated beams should begin and end.  The elements
  41 have the format:
  42
  43 @example
  44
  45    function shortest-duration-in-beam time-signature
  46
  47 where
  48
  49     function = begin or end
  50     shortest-duration-in-beam = numerator denominator; eg: 1 16
  51     time-signature = numerator denominator, eg: 4 4
  52
  53 unspecified or wildcard entries for duration or time-signature
  54 are given by * *
  55
  56 The user can override beam begin or end time by pushing a wildcard entries
  57 '(begin * * * *) or '(end * * * *) resp., eg:
  58
  59     property Voice.autoBeamSettings push #'(end * * * *) = #(ly:make-moment 1 4)
  60
  61 The head of the list:
  62     '(
  63 ((end * * 3 2) . ,(ly:make-moment 1 2))
  64 ((end 1 16 3 2) . ,(ly:make-moment 1 4))
  65 ((end 1 32 3 2) . ,(ly:make-moment 1 8))
  66      ...
  67     )
  68
  69 @end example")
  70
  71 ;; "
  72
  73 (translator-property-description 'autoAccidentals list? "List of
  74 different ways to typeset an accidental. All algorithms in the list
  75 are tried, and the one returning the most accidentals is used.
  76 Each entry is either a symbol containg a context name or a name-value
  77 pair containing an algorithm-description.
  78 The list must begin with a symbol (context name).
  79 The symbols denote in which context THE FOLLOWING algorithms (until next symbol)
  80 will be interpreted. All notes in the interpretation context will share accidentals.
  81 The contexts must be stated in order, innermost first.
  82 The algorithms are:
  83 @table @samp
  84 @item same-octave:
  85 This is the default algorithm. Accidentals are typeset if the note changes
  86 the accidental of that note in that octave. Accidentals lasts to the end of the measure
  87 and then as many measures as specified in the value. I.e. 1 means to the end
  88 of next measure, -1 means to the end of previous measure (that is: no duration at all), etc. #t means forever.
  89 @item any-octave:
  90 Accidentals are typeset if the note is different from
  91 the previous note on the same pitch in any octave. The value has same meaning as in
  92 same-octave.
  93 @end table
  94 ")
  95 (translator-property-description 'autoBeaming boolean? "If set to true
  96 then beams are generated automatically.")
  97
  98 (translator-property-description 'autoCautionaries list? "List similar to
  99 autoAccidentals, but it controls cautionary accidentals rather than
 100 normal ones. Both lists are tried, and the one giving the most accidentals
 101 wins. In case of draw, a normal accidental is typeset.
 102 ")
 103 (translator-property-description 'automaticBars boolean? " If set to true then bar lines will not be printed
 104     automatically; they must be explicitly created with @code{bar}
 105     keywords.  Unlike with the @code{cadenza} keyword, measures are
 106     still counted.  Bar generation will resume according to that
 107     count if this property is set to zero.
 108 ")
 109
 110 (translator-property-description 'barAlways boolean? "If set to true a bar line is drawn after each note.
 111 ")
 112 (translator-property-description 'barCheckLastFail ly:moment? "Where in  the measurze did the last barcheck fail?")
 113
 114 (translator-property-description 'barCheckSynchronize boolean? "If
 115 true then reset measurePosition when finding a barcheck. Turn off when
 116 using barchecks in polyphonic music.")
 117 (translator-property-description 'barNumberVisibility procedure? "Procedure that takes an int and returns whether the corresponding bar number should be printed")
 118 (translator-property-description 'bassFigureFormatFunction procedure? "DOCME")
 119 (translator-property-description 'beamMelismaBusy boolean? "Signal if a beam is present.")
 120 (translator-property-description 'beatLength ly:moment? "The length of one beat in this time signature.")
 121 (translator-property-description 'beatGrouping list?
 122                                  "List of beatgroups. Eg. in 5/8 time #(list 2 3).")
 123
 124
 125 (translator-property-description 'breakableSeparationItem ly:grob?
 126 "The breakable items in this time step, for this staff.")
 127
 128 (translator-property-description 'breakAlignOrder list? "Defines the order in which
 129 prefatory matter (clefs, key signatures) appears, eg. this puts the
 130 key signatures after the bar lines:
 131
 132 @example
 133         \\property Score.breakAlignOrder = #'(
 134           span-bar
 135           breathing-sign
 136           clef
 137           staff-bar
 138           key
 139           time-signature
 140         )
 141 @end example
 142 ")
 143 (translator-property-description 'busyGrobs list? "
 144 a queue of (END-MOMENT . GROB) conses. This is for internal (C++) use only.
 145 Use at your own risk.  This property contains the grobs for which  END-MOMENT >= NOW.
 146 ")
 147
 148 (translator-property-description 'centralCPosition number? "Place of
 149 the central C, measured in half staffspaces.  Usually determined by
 150 looking at clefPosition and clefGlyph.")
 151
 152 (translator-property-description
 153  'chordNameFunction procedure?
 154  "The function that converts lists of pitches to chord names.")
 155 (translator-property-description
 156  'chordNoteNamer procedure?
 157  "Function that converts from a pitch object to a text markup. Used for single pitches.")
 158 (translator-property-description
 159  'chordRootNamer procedure?
 160  "Function that converts from a pitch object to a text markup. Used for chords.")
 161 (translator-property-description
 162  'chordNameExceptions list?
 163  "Alist of chord exceptions. Contains (CHORD . MARKUP) entries.")
 164 (translator-property-description
 165  'chordNameExceptionsFull list?
 166  "Alist of chord exceptions. Contains (CHORD . (MARKUP)) entries.")
 167 (translator-property-description
 168  'chordNameExceptionsPartial list?
 169  "Alist of partial chord exceptions. Contains (CHORD . (PREFIX-MARKUP SUFFIX-MARKUP)) entries.")
 170 (translator-property-description
 171  'chordNameSeparator markup?
 172  "The markup object used to separate parts of a chord name.")
 173
 174 (translator-property-description 'chordChanges boolean? "Only show changes in chords scheme?")
 175 (translator-property-description 'clefGlyph string? "Name of the symbol within the music font")
 176 (translator-property-description 'clefOctavation integer? "Add
 177 this much extra octavation. Values of 7 and -7 are common.")
 178
 179 (translator-property-description 'clefPosition number? "Where should
 180 the center of the clef symbol go?  On systems with an odd number of
 181 stafflines, the value 0 puts the clef on the middle staffline; a
 182 positive value shifts it up, a negative value shifts it down.  The
 183 unit of this distance is the half staff space.")
 184
 185 (translator-property-description 'connectArpeggios boolean? " If
 186 set, connect all arpeggios that are found.  In this way, you can make
 187 arpeggios that cross staves.
 188 ")
 189 (translator-property-description 'createKeyOnClefChange boolean? "Print a key signature whenever the clef is changed.")
 190 (translator-property-description 'crescendoText markup? "Text to print at start of non-hairpin crecscendo, ie: @samp{cresc.}")
 191 (translator-property-description 'crescendoSpanner symbol? "Type of spanner to be used for crescendi.  One of: @samp{hairpin}, @samp{line}, @samp{dashed-line}, @samp{dotted-line}.  If unset, hairpin type is used.")
 192 (translator-property-description 'decrescendoText markup? "Text to print at start of non-hairpin decrecscendo, ie: @samp{dim.}")
 193 (translator-property-description 'drumStyleTable hash-table?
 194                                  "A hash table containing mapping drums to layout settings.
 195 Predefined values: @code{drums-style}, @code{timbales-style}, @code{congas-style}, @code{bongos-style}
 196 and @code{percussion-style}.
 197
 198 The layout style is a hash table, containing the drum-pitches  (eg. the symbol @code{hihat}) as key,
 199 and a list (@var{notehead-style} @var{script} @var{vertical-position}) as values.
 200  ")
 201 (translator-property-description 'currentBarNumber integer? "Contains the current barnumber. This property is incremented at
 202 every barline.
 203 ")
 204 (translator-property-description 'currentCommandColumn ly:grob? "Grob that is X-parent to all current breakable (clef, key signature, etc.) items.")
 205 (translator-property-description 'currentMusicalColumn ly:grob? "Grob that is X-parent to all non-breakable items (note heads, lyrics, etc.).")
 206 (translator-property-description 'defaultBarType string? "Sets the default type of bar line.  Available bar types: [FIXME];
 207
 208 This variable is typically read at Score level, so overriding
 209 Staff.defaultBarType will have no effect.
 210
 211 ")
 212
 213 (translator-property-description 'decrescendoSpanner symbol? "Type of spanner to be used for decrescendi.  One of: @samp{hairpin}, @samp{line}, @samp{dashed-line}, @samp{dotted-line}.  If unset, hairpin type is used.")
 214
 215 (translator-property-description 'dynamicAbsoluteVolumeFunction procedure? "
 216 [DOCUMENT-ME]
 217 ")
 218 (translator-property-description 'explicitClefVisibility procedure? "visibility-lambda function for clef changes.")
 219
 220 (translator-property-description 'explicitKeySignatureVisibility
 221 procedure? "visibility-lambda function for explicit Key changes;
 222 \\override of #'break-visibility will set the visibility for normal
 223 (ie. at the start of the line) key signatures.")
 224
 225 (translator-property-description 'extraNatural boolean? "Whether to typeset an
 226 extra natural sign before accidentals changing from a non-natural to
 227 another non-natural.
 228 ")
 229
 230 (translator-property-description 'extraVerticalExtent number-pair?
 231 "extra vertical extent, same format as MinimumVerticalExtent")
 232
 233
 234 (translator-property-description 'finalizations list? "List of expressions to evaluate before proceeding to next time step. Internal variable.")
 235 (translator-property-description 'followVoice boolean?
 236                                  "if set, note heads are tracked  across staff switches by a thin line")
 237 (translator-property-description 'fontSize number?
 238                                  "Used to set the relative size of all grobs
 239 in a context. This is done using the @code{Font_size_engraver}.")
 240
 241 (translator-property-description
 242  'fingeringOrientations list?
 243  "List of symbols, containing left, right, up and/or down. This list determines where fingerings are put wrt. to the chord being fingered.")
 244
 245 (translator-property-description 'forceClef boolean? "Show clef symbol, even if it hasn't changed. Only active for the first clef after the property is set, not for the full staff.")
 246
 247 (translator-property-description 'graceSettings vector?
 248                                  "Overrides for grace notes. This
 249 property should be manipulated through the @code{add-grace-property}
 250 function.")
 251
 252 (translator-property-description 'highStringOne boolean? "Whether the
 253 1st string is the string with highest pitch on the instrument (used by
 254 the automatic string selector).")
 255
 256 (translator-property-description 'ignoreMelismata boolean?
 257                                  "Ignore melismata for this @ref{LyricsVoice}.")
 258 (translator-property-description 'instr markup? "see @code{instrument}")
 259 (translator-property-description 'instrument markup? " If @code{Instrument_name_engraver}
 260 @cindex Instrument_name_engraver
 261  is
 262     added to the Staff translator, then the @code{instrument} property
 263     is used to label the first line of the staff and the @code{instr}
 264     property is used to label subsequent lines.  If the
 265     @code{midiInstrument} property is not set, then @code{instrument}
 266     is used to determine the instrument for MIDI output.")
 267
 268 (translator-property-description 'instrumentEqualizer procedure? "[DOCUMENT-ME]")
 269 (translator-property-description 'instrumentSupport list? "
 270 list of grobs to attach instrument name to.
 271 ")
 272 (translator-property-description 'keyAccidentalOrder list? "
 273 Alist that defines in what order  alterations should be printed.
 274 The format is (NAME . ALTER), where NAME is from 0 .. 6 and ALTER from  -1, 1.
 275 ")
 276 (translator-property-description 'keySignature list? "The current key signature. This is an alist containing (NAME . ALTER) or ((OCTAVE . NAME) . ALTER) or ((OCTAVE . NAME) . (ALTER . BARNUMBER)) pairs, where NAME is from 0.. 6 and ALTER from -2,-1,0,1,2. The optional barnumber contains the number of the measure of the accidental. FIXME: describe broken tie entries.")
 277
 278 (translator-property-description 'lastKeySignature list? "Last key
 279 signature before a key signature change.")
 280
 281 (translator-property-description 'localKeySignature list? "the key
 282 signature at this point in the measure.  The format is the same as for keySignature. Is reset at every bar line."
 283 )
 284 (translator-property-description 'localKeySignatureChanges list? "Experimental.
 285  [DOCME]")
 286
 287 (translator-property-description 'majorSevenSymbol markup? "How should
 288 the major7 be formatted in a chord name?")
 289 (translator-property-description 'markFormatter procedure? "Procedure
 290 taking as arguments context and rehearsal mark. It should return the
 291 formatted mark as a markup object.")
 292
 293 (translator-property-description 'measureLength ly:moment? "Length of one
 294 measure in the current time signature last?")
 295 (translator-property-description 'measurePosition ly:moment? "How much
 296 of the current measure (measured in whole notes) have we had.  This
 297 can be set manually to create incomplete measures (anacrusis, upbeat),
 298 the start of the music.
 299 ")
 300 (translator-property-description 'melismaBusy boolean? "Signifies
 301 whether a melisma is active. This can be used to signal melismas on
 302 top of those automatically detected. ")
 303 (translator-property-description 'melismaBusyProperties list?
 304                                  "List of properties (symbols) to
 305 determine whether a melisma is playing.  Setting this property will
 306 influence how lyrics are aligned to notes.  For example, if set to
 307 @code{#'(melismaBusy beamMelismaBusy)}, only manual melismata
 308 (i.e. setting @code{melismaBusy} to @code{#t}) and manual beams are
 309 considered. Possible values include @code{melismaBusy},
 310 @code{slurMelismaBusy}, @code{tieMelismaBusy}, and
 311 @code{beamMelismaBusy}")
 312
 313
 314 (translator-property-description 'metronomeMarkFormatter procedure?
 315                                  "How to produce a metronome markup.
 316 Called with 2 arguments,  event and context.")
 317 (translator-property-description 'midiInstrument string? "Name of the
 318 MIDI instrument to use ")
 319 (translator-property-description 'midiMinimumVolume number? "[DOCUMENT-ME]")
 320 (translator-property-description 'midiMaximumVolume number? "[DOCUMENT-ME]")
 321 (translator-property-description 'minimumFret number? "The tablature
 322 auto string-selecting mechanism selects the highest string with a fret
 323 not less than minimumFret")
 324 (translator-property-description 'minimumVerticalExtent number-pair?
 325 "minimum vertical extent, same format as VerticalExtent")
 326 (translator-property-description 'recordEventSequence procedure?
 327                                  "Upon termination of this context,
 328 this function is called with current context and a list of music
 329 objects.  The list of contains entries with start times, music objects
 330 and whether they're processed in this context.")
 331
 332 (translator-property-description
 333  'originalCentralCPosition integer?
 334  "Used for temporary overriding central C in octavation brackets. ")
 335 (translator-property-description 'othersolo boolean? "FIXME")
 336 (translator-property-description 'ottavation string? "If set, the text
 337 for an 8va spanner. Changing this implies a new text spanner. ")
 338 (translator-property-description 'pedalSustainStrings list? "List of   string to print for sustain-pedal. Format is
 339  (UP UPDOWN DOWN), where each of the three is the string to print when
 340 this is done with the pedal.")
 341 (translator-property-description 'pedalUnaCordaStrings list? "see pedalSustainStrings.")
 342 (translator-property-description 'pedalSostenutoStrings list? "see pedalSustainStrings.")
 343 (translator-property-description 'pedalSustainStyle symbol? "A symbol
 344 that indicates how to print sustain pedals: text, bracket or mixed
 345 (both).")
 346 (translator-property-description 'pedalUnaCordaStyle symbol? "see pedalSustainStyle.")
 347 (translator-property-description 'pedalSostenutoStyle symbol? "see pedalSustainStyle.")
 348
 349 (translator-property-description 'rehearsalMark integer? "The
 350 last rehearsal mark printed.")
 351 (translator-property-description 'repeatCommands list? "This property is read to find any command of the form (volta . X), where X is a string or #f")
 352 (translator-property-description 'scriptDefinitions list? "
 353 Description of scripts. This is used by Script_engraver for typesetting note-super/subscripts. See @file{scm/script.scm} for more information
 354 ")
 355
 356 (translator-property-description 'restNumberThreshold number?
 357                                  "If a multimeasure rest takes less
 358 than this number of measures, no number is printed. ")
 359
 360 (translator-property-description 'skipBars boolean? "If set to true, then
 361 skip the empty bars that are produced by multimeasure notes and rests.
 362 These bars will not appear on the printed output.  If not set (the
 363 default) multimeasure notes and rests expand into their full length,
 364 printing the appropriate number of empty bars so that synchronization
 365 with other voices is preserved.
 366
 367
 368 @example
 369 @@lilypond[fragment,verbatim,center]
 370 r1 r1*3 R1*3  \\\\property Score.skipBars= ##t r1*3 R1*3
 371
 372 @@end lilypond
 373 @end example
 374
 375 ")
 376 (translator-property-description 'skipTypesetting boolean?
 377                                  "When true, all no typesetting is done at
 378 this moment, causing  the interpretation phase to go a lot faster. This can
 379 help with debugging large scores.")
 380 (translator-property-description 'slurMelismaBusy boolean? "Signal if a slur is present.")
 381 (translator-property-description 'solo boolean? "set if solo is detected by the part combiner.")
 382 (translator-property-description 'soloADue boolean? "set Solo/A due texts in the part combiner?.")
 383 (translator-property-description 'soloIIText string? "text for begin of solo for voice ``two'' when part-combining.")
 384 (translator-property-description 'soloText string? "text for begin of solo when part-combining.")
 385 (translator-property-description 'sparseTies boolean? "only create one tie per chord.")
 386 (translator-property-description 'squashedPosition integer? " Vertical position of
 387 squashing for Pitch_squash_engraver.")
 388 (translator-property-description 'stringOneTopmost boolean? "Whether the 1st string is printed on the
 389 top line of the tablature.")
 390 (translator-property-description 'stavesFound list? "list of all staff-symbols found.")
 391 (translator-property-description 'stanza markup? "Stanza `number' to
 392 print before the start of a verse. Use in LyricsVoice context.")
 393 (translator-property-description 'stemLeftBeamCount integer? "
 394 Specify the number of beams to draw on the left side of the next note.
 395 Overrides automatic beaming.  The value is only used once, and then it
 396 is erased.
 397 .")
 398 (translator-property-description 'stemRightBeamCount integer? "idem, for the right side.")
 399 (translator-property-description 'stringTunings list? "The tablature strings tuning. Must be a list of the different semitons pitch of each string (starting by the lower one).")
 400 (translator-property-description 'subdivideBeams boolean? "If set, multiple beams will be subdivided at beat
 401 positions - by only drawing one beam over the beat.")
 402 (translator-property-description 'systemStartDelimiter symbol? "Which grob to make for the start of the system/staff? Set to @code{SystemStartBrace}, @code{SystemStartBracket} or @code{SystemStartBar}.")
 403 (translator-property-description 'tablatureFormat procedure?
 404                                  "Function formatting a tab notehead; it takes
 405 a string number, a list of string tunings and Pitch object. It returns the text as a string.")
 406
 407 (translator-property-description 'tieMelismaBusy boolean? "Signal whether a tie is present.")
 408 (translator-property-description 'timeSignatureFraction number-pair?
 409 "pair of numbers, signifying the time signature. For example #'(4 . 4)
 410 is a 4/4 time signature.")
 411
 412 (translator-property-description 'timing boolean? " Keep administration of measure length, position, bar number, etc?
 413 Switch off for cadenzas.")
 414 (translator-property-description 'tonic ly:pitch?
 415                                  "The tonic of the current scale")
 416 (translator-property-description 'transposing integer? "Transpose the MIDI output.  Set this property to the number of half-steps to transpose by.")
 417 (translator-property-description 'tremoloFlags integer? "Number of tremolo flags to add if none is specified.")
 418 (translator-property-description 'tupletNumberFormatFunction procedure?
 419                                  "Function taking a music as input, producing a string. This function is called to determine the text to print on a tuplet bracket.")
 420
 421
 422 ;; remove this?
 423 (translator-property-description 'tupletInvisible boolean? "
 424     If set to true, tuplet bracket creation is switched off
 425 entirely. This has the same effect as setting both
 426 @code{tupletNumberVisibility} and @code{tupletBracketVisibility} to
 427 @code{#f}, but as this does not even create any grobs, this setting
 428 uses less memory and time.")
 429
 430 (translator-property-description 'tupletSpannerDuration ly:moment? "
 431 Normally a tuplet bracket is as wide as the
 432 @code{  imes} expression that gave rise to it. By setting this
 433 property, you can make brackets last shorter. Example
 434
 435 @example
 436 @@lilypond[verbatim,fragment]
 437 context Voice   imes 2/3 @{
 438   property Voice.tupletSpannerDuration = #(ly:make-moment 1 4)
 439   c-[8 c c-] c-[ c c-]
 440 @}
 441 @@end lilypond
 442 @end example
 443 .")
 444 (translator-property-description 'verticalAlignmentChildCallback
 445 procedure? "what callback to add to children of a vertical alignment.
 446 It determines what alignment procedure is used on the alignment
 447 itself.  .")
 448 (translator-property-description 'verticalExtent number-pair? "hard
 449 coded vertical extent.  The format is a pair of dimensions, for
 450 example, this sets the sizes of a staff to 10 (5+5) staffspaces high.
 451
 452 @example
 453 property Staff.verticalExtent = #(-5.0 . 5.0)
 454 @end example
 455
 456 VerticalExtent, MinimumVerticalExtent and ExtraVerticalExtent are
 457 predefined in all relevant contexts to @code{#f}, so they will not
 458 inherit values.
 459
 460 Note that these VerticalExtents can only operate on vertical groups,
 461 and therefore only work in contexts which contain an
 462 @code{Axis_group_engraver}.
 463 ")
 464
 465 (translator-property-description 'vocalName markup?
 466                                  "Name of a vocal line.")
 467 (translator-property-description 'vocNam markup?
 468                                  "Name of a vocal line, short version.")
 469
 470 (translator-property-description 'voltaOnThisStaff boolean?
 471  "Normally, volta brackets are put only on the topmost staff. Setting
 472 this variable to true, will force a bracket to be on this staff as
 473 well.")
 474
 475 (translator-property-description 'voltaSpannerDuration ly:moment? "maximum duration of the volta bracket.
 476
 477     Set to a duration to control the size of the brackets printed by
 478 @code{\\alternative}.  It specifies the number of whole notes duration
 479 to use for the brackets.  This can be used to shrink the length of
 480 brackets in the situation where one alternative is very large.  It may
 481 have odd effects if the specified duration is longer than the music
 482 given in an @code{\\alternative}.
 483 .")
 484 (translator-property-description 'whichBar string?
 485                                  "This property is read to determine what type of barline to create.
 486
 487 Example:
 488 @example
 489 \\property Staff.whichBar = \"|:\"
 490 @end example
 491
 492 This will create a start-repeat bar in this staff only.
 493
 494 If not set explicitly (by property or @code{\\bar}), this is set
 495 according to values of @code{defaultBarType}, @code{barAlways},
 496 @code{barNonAuto} and @code{measurePosition}.
 497
 498 Valid values are described in @ref{(lilypond-internals)bar-line-interface}.
 499
 500 .")
 501
 502
 503 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 504
 505 (define-public default-melisma-properties '(melismaBusy slurMelismaBusy tieMelismaBusy beamMelismaBusy))