From fcc5f76615e024803904a055902fdc6a3b24dccb Mon Sep 17 00:00:00 2001 From: Werner Lemberg Date: Fri, 14 Mar 2008 08:57:30 +0100 Subject: [PATCH] ADD_TRANSLATOR: Formatting, fix typos, add some doc strings. --- lily/ambitus-engraver.cc | 15 +++++++--- lily/arpeggio-engraver.cc | 16 +++++++--- lily/auto-beam-engraver.cc | 18 +++++++---- lily/axis-group-engraver.cc | 13 ++++++-- lily/balloon-engraver.cc | 13 ++++++-- lily/bar-engraver.cc | 19 ++++++++---- lily/bar-number-engraver.cc | 24 +++++++++------ lily/beam-engraver.cc | 35 ++++++++++++---------- lily/beam-performer.cc | 14 ++++++++- lily/bend-engraver.cc | 16 +++++++--- lily/break-align-engraver.cc | 22 ++++++++++---- lily/breathing-sign-engraver.cc | 16 +++++++--- lily/chord-name-engraver.cc | 19 +++++++----- lily/chord-tremolo-engraver.cc | 16 +++++++--- lily/clef-engraver.cc | 16 ++++++---- lily/cluster-engraver.cc | 12 ++++++-- lily/collision-engraver.cc | 17 ++++++++--- lily/completion-note-heads-engraver.cc | 17 +++++++---- lily/control-track-performer.cc | 15 ++++++++-- lily/custos-engraver.cc | 16 +++++++--- lily/default-bar-line-engraver.cc | 16 +++++----- lily/dot-column-engraver.cc | 18 +++++++---- lily/dots-engraver.cc | 16 +++++----- lily/drum-note-engraver.cc | 15 +++++++--- lily/drum-note-performer.cc | 13 +++++++- lily/dynamic-engraver.cc | 15 ++++++---- lily/dynamic-performer.cc | 15 ++++++---- lily/engraver-group.cc | 16 +++++++--- lily/engraver.cc | 12 ++++++-- lily/extender-engraver.cc | 16 +++++++--- lily/figured-bass-engraver.cc | 11 ++++--- lily/figured-bass-position-engraver.cc | 7 +++-- lily/fingering-engraver.cc | 14 ++++++--- lily/font-size-engraver.cc | 16 +++++++--- lily/forbid-break-engraver.cc | 18 +++++++---- lily/fretboard-engraver.cc | 16 ++++++---- lily/glissando-engraver.cc | 10 +++++-- lily/grace-engraver.cc | 16 +++++++--- lily/grace-spacing-engraver.cc | 7 +++-- lily/grid-line-span-engraver.cc | 18 +++++++---- lily/grid-point-engraver.cc | 16 +++++++--- lily/grob-pq-engraver.cc | 16 +++++++--- lily/hara-kiri-engraver.cc | 19 ++++++++---- lily/horizontal-bracket-engraver.cc | 15 ++++++++-- lily/hyphen-engraver.cc | 18 +++++++---- lily/instrument-name-engraver.cc | 10 +++---- lily/instrument-switch-engraver.cc | 13 +++++--- lily/key-engraver.cc | 13 ++++---- lily/key-performer.cc | 10 ++++++- lily/laissez-vibrer-engraver.cc | 12 ++++++-- lily/ledger-line-engraver.cc | 17 ++++++++--- lily/ligature-bracket-engraver.cc | 17 ++++++++--- lily/lyric-engraver.cc | 15 +++++++--- lily/lyric-performer.cc | 15 ++++++++-- lily/mark-engraver.cc | 20 ++++++++----- lily/measure-grouping-engraver.cc | 13 ++++---- lily/melody-engraver.cc | 15 ++++++++-- lily/mensural-ligature-engraver.cc | 17 ++++++++--- lily/metronome-engraver.cc | 22 ++++++++------ lily/multi-measure-rest-engraver.cc | 14 +++++---- lily/new-fingering-engraver.cc | 20 +++++++------ lily/note-head-line-engraver.cc | 20 +++++++++---- lily/note-heads-engraver.cc | 13 ++++++-- lily/note-name-engraver.cc | 16 +++++++--- lily/note-performer.cc | 15 ++++++++-- lily/note-spacing-engraver.cc | 17 ++++++++--- lily/ottava-engraver.cc | 19 +++++++----- lily/output-property-engraver.cc | 6 ++-- lily/page-turn-engraver.cc | 12 ++++++-- lily/paper-column-engraver.cc | 26 +++++++++------- lily/parenthesis-engraver.cc | 14 ++++++--- lily/part-combine-engraver.cc | 17 +++++++---- lily/performer-group.cc | 16 +++++++--- lily/phrasing-slur-engraver.cc | 16 +++++++--- lily/piano-pedal-align-engraver.cc | 5 ++-- lily/piano-pedal-engraver.cc | 7 +++-- lily/piano-pedal-performer.cc | 15 ++++++++-- lily/pitch-squash-engraver.cc | 23 ++++++++------ lily/pitched-trill-engraver.cc | 9 ++++-- lily/repeat-acknowledge-engraver.cc | 20 +++++++++---- lily/repeat-tie-engraver.cc | 12 ++++++-- lily/rest-collision-engraver.cc | 16 +++++++--- lily/rest-engraver.cc | 16 +++++++--- lily/rhythmic-column-engraver.cc | 17 ++++++++--- lily/score-engraver.cc | 25 ++++++++++------ lily/score-performer.cc | 16 +++++++--- lily/script-column-engraver.cc | 17 ++++++++--- lily/script-engraver.cc | 16 +++++++--- lily/script-row-engraver.cc | 16 +++++++--- lily/separating-line-group-engraver.cc | 14 ++++++--- lily/slash-repeat-engraver.cc | 16 +++++++--- lily/slur-engraver.cc | 12 ++++++-- lily/slur-performer.cc | 14 +++++++-- lily/spacing-engraver.cc | 15 ++++++---- lily/span-arpeggio-engraver.cc | 16 +++++++--- lily/span-bar-engraver.cc | 18 +++++++---- lily/spanner-break-forbid-engraver.cc | 16 +++++++--- lily/staff-collecting-engraver.cc | 15 +++++++--- lily/staff-performer.cc | 14 +++++++-- lily/staff-symbol-engraver.cc | 17 +++++++---- lily/stanza-number-align-engraver.cc | 10 ++++++- lily/stanza-number-engraver.cc | 16 +++++++--- lily/stem-engraver.cc | 10 ++++--- lily/string-number-engraver.cc | 23 +++++++++----- lily/swallow-engraver.cc | 19 ++++++++---- lily/swallow-perf.cc | 16 +++++++--- lily/system-start-delimiter-engraver.cc | 19 ++++++++---- lily/tab-harmonic-engraver.cc | 14 ++++++--- lily/tab-note-heads-engraver.cc | 11 ++++--- lily/tab-staff-symbol-engraver.cc | 18 +++++++---- lily/tempo-performer.cc | 14 +++++++-- lily/text-engraver.cc | 16 +++++++--- lily/text-spanner-engraver.cc | 3 ++ lily/tie-engraver.cc | 13 ++++++-- lily/tie-performer.cc | 16 +++++++--- lily/time-signature-engraver.cc | 12 +++++--- lily/time-signature-performer.cc | 14 ++++++++- lily/timing-translator.cc | 18 ++++++----- lily/translator.cc | 12 ++++++-- lily/trill-spanner-engraver.cc | 13 ++++++-- lily/tuplet-engraver.cc | 7 +++-- lily/tweak-engraver.cc | 16 +++++++--- lily/type-swallow-translator.cc | 35 ++++++++++++++++++---- lily/vaticana-ligature-engraver.cc | 17 ++++++++--- lily/vertical-align-engraver.cc | 14 ++++++--- lily/vertically-spaced-context-engraver.cc | 16 +++++++--- lily/volta-engraver.cc | 19 +++++++++--- 127 files changed, 1426 insertions(+), 550 deletions(-) diff --git a/lily/ambitus-engraver.cc b/lily/ambitus-engraver.cc index e00ea133dd..c316716a8b 100644 --- a/lily/ambitus-engraver.cc +++ b/lily/ambitus-engraver.cc @@ -194,11 +194,18 @@ Ambitus_engraver::finalize () ADD_ACKNOWLEDGER (Ambitus_engraver, note_head); ADD_TRANSLATOR (Ambitus_engraver, - /* doc */ "", + /* doc */ + "", + /* create */ "Ambitus " "AmbitusLine " "AmbitusNoteHead " - "AmbitusAccidental", - /* read */ "", - /* write */ ""); + "AmbitusAccidental ", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/arpeggio-engraver.cc b/lily/arpeggio-engraver.cc index 399823408f..6fa2f79c9d 100644 --- a/lily/arpeggio-engraver.cc +++ b/lily/arpeggio-engraver.cc @@ -92,7 +92,15 @@ ADD_ACKNOWLEDGER (Arpeggio_engraver, stem); ADD_ACKNOWLEDGER (Arpeggio_engraver, rhythmic_head); ADD_TRANSLATOR (Arpeggio_engraver, - /* doc */ "Generate an Arpeggio symbol", - /* create */ "Arpeggio", - /* read */ "", - /* write */ ""); + /* doc */ + "Generate an Arpeggio symbol.", + + /* create */ + "Arpeggio", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/auto-beam-engraver.cc b/lily/auto-beam-engraver.cc index a98b05f48d..db6ef1baa0 100644 --- a/lily/auto-beam-engraver.cc +++ b/lily/auto-beam-engraver.cc @@ -423,12 +423,16 @@ ADD_ACKNOWLEDGER (Auto_beam_engraver, bar_line); ADD_ACKNOWLEDGER (Auto_beam_engraver, beam); ADD_ACKNOWLEDGER (Auto_beam_engraver, rest); ADD_TRANSLATOR (Auto_beam_engraver, - /* doc */ "Generate beams based on measure characteristics and observed " - "Stems. Uses beatLength, measureLength and measurePosition to decide " - "when to start and stop a beam. Overriding beaming is done through " + /* doc */ + "Generate beams based on measure characteristics and observed " + "Stems. Uses @code{beatLength}, @code{measureLength}, and " + "@code{measurePosition} to decide when to start and stop a " + "beam. Overriding beaming is done through " "@ref{Stem_engraver} properties @code{stemLeftBeamCount} and " - "@code{stemRightBeamCount}. ", - /* create */ "Beam", + "@code{stemRightBeamCount}.", + + /* create */ + "Beam ", /* read */ "autoBeaming " @@ -436,4 +440,6 @@ ADD_TRANSLATOR (Auto_beam_engraver, "beatLength " "subdivideBeams ", - /* write */ ""); + /* write */ + "" + ); diff --git a/lily/axis-group-engraver.cc b/lily/axis-group-engraver.cc index 3d83349526..15e26309ce 100644 --- a/lily/axis-group-engraver.cc +++ b/lily/axis-group-engraver.cc @@ -97,9 +97,16 @@ Axis_group_engraver::add_element (Grob *e) ADD_ACKNOWLEDGER (Axis_group_engraver, grob); ADD_TRANSLATOR (Axis_group_engraver, - /* doc */ "Group all objects created in this context in a VerticalAxisGroup spanner.", - /* create */ "VerticalAxisGroup", + /* doc */ + "Group all objects created in this context in a " + "@code{VerticalAxisGroup} spanner.", + + /* create */ + "VerticalAxisGroup ", + /* read */ "currentCommandColumn ", - /* write */ ""); + /* write */ + "" + ); diff --git a/lily/balloon-engraver.cc b/lily/balloon-engraver.cc index b1497ef403..27be460531 100644 --- a/lily/balloon-engraver.cc +++ b/lily/balloon-engraver.cc @@ -80,8 +80,15 @@ Balloon_engraver::acknowledge_grob (Grob_info info) ADD_ACKNOWLEDGER (Balloon_engraver, grob); ADD_TRANSLATOR (Balloon_engraver, - "Create balloon texts", + /* doc */ + "Create balloon texts.", + + /* create */ "BalloonTextItem ", - /*read*/ "", - /*write*/ "" + + /*read*/ + "", + + /*write*/ + "" ); diff --git a/lily/bar-engraver.cc b/lily/bar-engraver.cc index 2357c087b5..ac0afa37f2 100644 --- a/lily/bar-engraver.cc +++ b/lily/bar-engraver.cc @@ -102,8 +102,17 @@ Bar_engraver::acknowledge_end_spanner (Grob_info gi) ADD_END_ACKNOWLEDGER (Bar_engraver, spanner); ADD_TRANSLATOR (Bar_engraver, - /* doc */ "Create barlines. This engraver is controlled through the " - "@code{whichBar} property. If it has no bar line to create, it will forbid a linebreak at this point", - /* create */ "BarLine", - /* read */ "whichBar", - /* write */ "forbidBreak"); + /* doc */ + "Create barlines. This engraver is controlled through the " + "@code{whichBar} property. If it has no bar line to create, " + "it will forbid a linebreak at this point.", + + /* create */ + "BarLine ", + + /* read */ + "whichBar ", + + /* write */ + "forbidBreak " + ); diff --git a/lily/bar-number-engraver.cc b/lily/bar-number-engraver.cc index 3693f97b3e..5c4bf82ab3 100644 --- a/lily/bar-number-engraver.cc +++ b/lily/bar-number-engraver.cc @@ -120,17 +120,23 @@ ADD_ACKNOWLEDGER (Bar_number_engraver, break_aligned); ADD_ACKNOWLEDGER (Bar_number_engraver, break_alignment); ADD_TRANSLATOR (Bar_number_engraver, - /* doc */ "A bar number is created whenever measurePosition " - "is zero and when there is a bar line (ie. when @code{whichBar} is set. " - "It is \n" - "put on top of all staves, and appears only at left side of the staff. " - "The staves are taken from @code{stavesFound}, which is maintained by " - "@code{@ref{Staff_collecting_engraver}}. ", - - /* create */ "BarNumber", + /* doc */ + "A bar number is created whenever @code{measurePosition} is " + "zero and when there is a bar line (i.e., when " + "@code{whichBar} is set). It is put on top of all staves, " + "and appears only at the left side of the staff. The staves " + "are taken from @code{stavesFound}, which is maintained by " + "@ref{Staff_collecting_engraver}.", + + /* create */ + "BarNumber ", + /* read */ "currentBarNumber " "whichBar " "stavesFound " "barNumberVisibility ", - /* write */ ""); + + /* write */ + "" + ); diff --git a/lily/beam-engraver.cc b/lily/beam-engraver.cc index 90357c5264..724485a3e0 100644 --- a/lily/beam-engraver.cc +++ b/lily/beam-engraver.cc @@ -271,19 +271,20 @@ ADD_ACKNOWLEDGER (Beam_engraver, rest); ADD_TRANSLATOR (Beam_engraver, /* doc */ - - "Handles Beam events by engraving Beams. If omitted, then notes will be " - "printed with flags instead of beams.", + "Handle @code{Beam} events by engraving beams. If omitted, " + "then notes are printed with flags instead of beams.", - /* create */ "Beam", + /* create */ + "Beam ", /* read */ "beamMelismaBusy " "beatLength " - "subdivideBeams " - , + "subdivideBeams ", + /* write */ - "forbidBreak"); + "forbidBreak" + ); class Grace_beam_engraver : public Beam_engraver { @@ -335,18 +336,20 @@ ADD_ACKNOWLEDGER (Grace_beam_engraver, stem); ADD_ACKNOWLEDGER (Grace_beam_engraver, rest); ADD_TRANSLATOR (Grace_beam_engraver, - /* doc */ - - "Handles Beam events by engraving Beams. If omitted, then notes will " - "be printed with flags instead of beams. Only engraves beams when we " - " are at grace points in time. ", + "Handle @code{Beam} events by engraving beams. If omitted, " + "then notes are printed with flags instead of beams. Only " + "engraves beams when we are at grace points in time.", - /* create */ "Beam", + /* create */ + "Beam ", + /* read */ "beamMelismaBusy " "beatLength " - "subdivideBeams " - , - /* write */ ""); + "subdivideBeams ", + + /* write */ + "" + ); diff --git a/lily/beam-performer.cc b/lily/beam-performer.cc index 544dbfb3b1..34a1a86482 100644 --- a/lily/beam-performer.cc +++ b/lily/beam-performer.cc @@ -81,5 +81,17 @@ Beam_performer::listen_beam (Stream_event *ev) now_stop_ev_ = ev; } -ADD_TRANSLATOR (Beam_performer, "", "", "", ""); +ADD_TRANSLATOR (Beam_performer, + /* doc */ + "", + + /* create */ + "", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/bend-engraver.cc b/lily/bend-engraver.cc index 4f243dfc73..9f5602fef0 100644 --- a/lily/bend-engraver.cc +++ b/lily/bend-engraver.cc @@ -111,7 +111,15 @@ Bend_engraver::process_music () ADD_ACKNOWLEDGER (Bend_engraver, note_head); ADD_TRANSLATOR (Bend_engraver, - /* doc */ "Create fall spanners.", - /* create */ "BendAfter", - /* read */ "", - /* write */ ""); + /* doc */ + "Create fall spanners.", + + /* create */ + "BendAfter ", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/break-align-engraver.cc b/lily/break-align-engraver.cc index 8059200849..c02c298330 100644 --- a/lily/break-align-engraver.cc +++ b/lily/break-align-engraver.cc @@ -136,14 +136,24 @@ Break_align_engraver::add_to_group (SCM align_name, Item *item) } Axis_group_interface::add_element (group, item); } + ADD_ACKNOWLEDGER (Break_align_engraver, break_aligned); ADD_ACKNOWLEDGER (Break_align_engraver, break_alignable); ADD_TRANSLATOR (Break_align_engraver, - "Align grobs with corresponding @code{break-align-symbols} into " - "groups, and order the groups according to @code{breakAlignOrder}. " - "The left edge of the alignment gets a separate group, with a symbol @code{left-edge}. ", - /* create */ "BreakAlignment " + /* doc */ + "Align grobs with corresponding @code{break-align-symbols} " + "into groups, and order the groups according to " + "@code{breakAlignOrder}. The left edge of the alignment gets " + "a separate group, with a symbol @code{left-edge}.", + + /* create */ + "BreakAlignment " "BreakAlignGroup " "LeftEdge ", - /* read */ "", - /* write */ ""); + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/breathing-sign-engraver.cc b/lily/breathing-sign-engraver.cc index 02d4c0942d..9108be2a2f 100644 --- a/lily/breathing-sign-engraver.cc +++ b/lily/breathing-sign-engraver.cc @@ -64,7 +64,15 @@ Breathing_sign_engraver::stop_translation_timestep () } ADD_TRANSLATOR (Breathing_sign_engraver, - /* doc */ "", - /* create */ "BreathingSign", - /* read */ "", - /* write */ ""); + /* doc */ + "Create a breathing sign.", + + /* create */ + "BreathingSign ", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/chord-name-engraver.cc b/lily/chord-name-engraver.cc index 274e3ec390..649c1455be 100644 --- a/lily/chord-name-engraver.cc +++ b/lily/chord-name-engraver.cc @@ -138,16 +138,21 @@ Chord_name_engraver::stop_translation_timestep () which properties are read depend on the chord naming function active. */ ADD_TRANSLATOR (Chord_name_engraver, - /* doc */ "Catch note-events " - "and generate the appropriate chordname.", + /* doc */ + "Catch note events and generate the appropriate chordname.", - /* create */ "ChordName", - /* read */ "chordChanges " + /* create */ + "ChordName ", + + /* read */ + "chordChanges " "chordNameExceptions " "chordNameFunction " "chordNoteNamer " "chordRootNamer " "chordNameExceptions " - "majorSevenSymbol " - , - /* write */ ""); + "majorSevenSymbol ", + + /* write */ + "" + ); diff --git a/lily/chord-tremolo-engraver.cc b/lily/chord-tremolo-engraver.cc index 805cb52554..10a47074ca 100644 --- a/lily/chord-tremolo-engraver.cc +++ b/lily/chord-tremolo-engraver.cc @@ -146,7 +146,15 @@ Chord_tremolo_engraver::acknowledge_stem (Grob_info info) ADD_ACKNOWLEDGER (Chord_tremolo_engraver, stem); ADD_TRANSLATOR (Chord_tremolo_engraver, - /* doc */ "Generates beams for tremolo repeats.", - /* create */ "Beam", - /* read */ "", - /* write */ ""); + /* doc */ + "Generate beams for tremolo repeats.", + + /* create */ + "Beam ", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/clef-engraver.cc b/lily/clef-engraver.cc index 74992be976..415fed1bf2 100644 --- a/lily/clef-engraver.cc +++ b/lily/clef-engraver.cc @@ -193,14 +193,20 @@ Clef_engraver::stop_translation_timestep () ADD_ACKNOWLEDGER (Clef_engraver, bar_line); ADD_TRANSLATOR (Clef_engraver, - /* doc */ "Determine and set reference point for pitches", - /* create */ "Clef " + /* doc */ + "Determine and set reference point for pitches.", + + /* create */ + "Clef " "OctavateEight ", + /* read */ "clefGlyph " "clefOctavation " "clefPosition " "explicitClefVisibility " - "forceClef " - , - /* write */ ""); + "forceClef ", + + /* write */ + "" + ); diff --git a/lily/cluster-engraver.cc b/lily/cluster-engraver.cc index 898846e2d8..ea40ba2285 100644 --- a/lily/cluster-engraver.cc +++ b/lily/cluster-engraver.cc @@ -133,10 +133,16 @@ Cluster_spanner_engraver::acknowledge_note_column (Grob_info info) ADD_ACKNOWLEDGER (Cluster_spanner_engraver, note_column); ADD_TRANSLATOR (Cluster_spanner_engraver, /* doc */ - "Engraves a cluster using Spanner notation ", + "Engrave a cluster using @code{Spanner} notation.", + /* create */ "ClusterSpanner " "ClusterSpannerBeacon ", - /* read */ "", - /* write */ ""); + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/collision-engraver.cc b/lily/collision-engraver.cc index 7bff5a8cd4..79d66f6c12 100644 --- a/lily/collision-engraver.cc +++ b/lily/collision-engraver.cc @@ -70,7 +70,16 @@ Collision_engraver::Collision_engraver () ADD_ACKNOWLEDGER (Collision_engraver, note_column); ADD_TRANSLATOR (Collision_engraver, - /* doc */ "Collect NoteColumns, and as soon as there are two or more, put them in a NoteCollision object.", - /* create */ "NoteCollision", - /* read */ "", - /* write */ ""); + /* doc */ + "Collect @code{NoteColumns}, and as soon as there are two or " + "more, put them in a @code{NoteCollision} object.", + + /* create */ + "NoteCollision ", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/completion-note-heads-engraver.cc b/lily/completion-note-heads-engraver.cc index cbee0b2f5d..bba68859e0 100644 --- a/lily/completion-note-heads-engraver.cc +++ b/lily/completion-note-heads-engraver.cc @@ -224,16 +224,21 @@ Completion_heads_engraver::Completion_heads_engraver () } ADD_TRANSLATOR (Completion_heads_engraver, - /* doc */ "This engraver replaces " - "@code{Note_heads_engraver}. It plays some trickery to " - "break long notes and automatically tie them into the next measure.", + /* doc */ + "This engraver replaces @code{Note_heads_engraver}. It plays " + "some trickery to break long notes and automatically tie them " + "into the next measure.", + /* create */ "NoteHead " "Dots " - "Tie", + "Tie ", + /* read */ "middleCPosition " "measurePosition " - "measureLength", + "measureLength ", - /* write */ ""); + /* write */ + "" + ); diff --git a/lily/control-track-performer.cc b/lily/control-track-performer.cc index 3275b467d5..d1e677db63 100644 --- a/lily/control-track-performer.cc +++ b/lily/control-track-performer.cc @@ -65,5 +65,16 @@ Control_track_performer::initialize () add_text (Audio_text::TEXT, id_string); } -ADD_TRANSLATOR (Control_track_performer, "", "", - "", ""); +ADD_TRANSLATOR (Control_track_performer, + /* doc */ + "", + + /* create */ + "", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/custos-engraver.cc b/lily/custos-engraver.cc index 94bc4910ce..d0546bf65e 100644 --- a/lily/custos-engraver.cc +++ b/lily/custos-engraver.cc @@ -137,7 +137,15 @@ ADD_ACKNOWLEDGER (Custos_engraver, bar); ADD_ACKNOWLEDGER (Custos_engraver, note_head); ADD_TRANSLATOR (Custos_engraver, - /* doc */ "", - /* create */ "Custos", - /* read */ "", - /* write */ ""); + /* doc */ + "Engrave custodes.", + + /* create */ + "Custos ", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/default-bar-line-engraver.cc b/lily/default-bar-line-engraver.cc index d96110e87b..5710b186f5 100644 --- a/lily/default-bar-line-engraver.cc +++ b/lily/default-bar-line-engraver.cc @@ -28,13 +28,13 @@ public: #include "translator.icc" ADD_TRANSLATOR (Default_bar_line_engraver, - "This engraver determines what kind of automatic bar " - "lines should be produced, " - "and sets @code{whichBar} " - "accordingly. It should be at the same " - "level as @ref{Timing_translator}. ", + /* doc */ + "This engraver determines what kind of automatic bar lines " + "should be produced, and sets @code{whichBar} accordingly. " + "It should be at the same level as @ref{Timing_translator}.", - /* create */ "", + /* create */ + "", /* read */ "automaticBars " @@ -44,7 +44,9 @@ ADD_TRANSLATOR (Default_bar_line_engraver, "whichBar " "measurePosition ", - /* write */ "automaticBars"); + /* write */ + "automaticBars " + ); Default_bar_line_engraver::Default_bar_line_engraver () { diff --git a/lily/dot-column-engraver.cc b/lily/dot-column-engraver.cc index 3f2982df74..2b50a738d4 100644 --- a/lily/dot-column-engraver.cc +++ b/lily/dot-column-engraver.cc @@ -53,8 +53,16 @@ Dot_column_engraver::acknowledge_rhythmic_head (Grob_info info) ADD_ACKNOWLEDGER (Dot_column_engraver, rhythmic_head); ADD_TRANSLATOR (Dot_column_engraver, - /* doc */ "Engraves dots on dotted notes shifted to the right of the note.\n" - "If omitted, then dots appear on top of the notes.", - /* create */ "DotColumn", - /* read */ "", - /* write */ ""); + /* doc */ + "Engrave dots on dotted notes shifted to the right of the " + "note. If omitted, then dots appear on top of the notes.", + + /* create */ + "DotColumn ", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/dots-engraver.cc b/lily/dots-engraver.cc index b59a8d9a41..09b61310d2 100644 --- a/lily/dots-engraver.cc +++ b/lily/dots-engraver.cc @@ -53,13 +53,15 @@ Dots_engraver::acknowledge_rhythmic_head (Grob_info gi) ADD_ACKNOWLEDGER (Dots_engraver, rhythmic_head); ADD_TRANSLATOR (Dots_engraver, - "Create @ref{Dots} objects for @ref{rhythmic-head-interface}s.", + "Create @ref{Dots} objects for " + "@ref{rhythmic-head-interface}s.", - /* create */ - "Dots ", + /* create */ + "Dots ", - /*r*/ - "" , + /* read */ + "", - /*w*/ - ""); + /* write */ + "" + ); diff --git a/lily/drum-note-engraver.cc b/lily/drum-note-engraver.cc index 1db3e611f9..630c718ed6 100644 --- a/lily/drum-note-engraver.cc +++ b/lily/drum-note-engraver.cc @@ -135,10 +135,17 @@ ADD_ACKNOWLEDGER (Drum_notes_engraver, note_column); ADD_TRANSLATOR (Drum_notes_engraver, - /* doc */ "Generate noteheads.", + /* doc */ + "Generate drum note heads.", + /* create */ "NoteHead " - "Script", - /* read */ "drumStyleTable", - /* write */ ""); + "Script ", + + /* read */ + "drumStyleTable ", + + /* write */ + "" + ); diff --git a/lily/drum-note-performer.cc b/lily/drum-note-performer.cc index bb55ac2ef6..b31727ebc7 100644 --- a/lily/drum-note-performer.cc +++ b/lily/drum-note-performer.cc @@ -92,4 +92,15 @@ Drum_note_performer::listen_note (Stream_event *ev) } ADD_TRANSLATOR (Drum_note_performer, - "Play drum notes.", "", "", ""); + /* doc */ + "Play drum notes.", + + /* create */ + "", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/dynamic-engraver.cc b/lily/dynamic-engraver.cc index f6e5911f2b..e3171756ee 100644 --- a/lily/dynamic-engraver.cc +++ b/lily/dynamic-engraver.cc @@ -439,9 +439,10 @@ ADD_ACKNOWLEDGER (Dynamic_engraver, note_column); ADD_TRANSLATOR (Dynamic_engraver, /* doc */ - "This engraver creates hairpins, dynamic texts, and their vertical\n" - "alignments. The symbols are collected onto a DynamicLineSpanner grob\n" - "which takes care of vertical positioning. ", + "Create hairpins, dynamic texts, and their vertical " + "alignments. The symbols are collected onto a " + "@code{DynamicLineSpanner} grob which takes care of vertical " + "positioning.", /* create */ "DynamicLineSpanner " @@ -450,5 +451,9 @@ ADD_TRANSLATOR (Dynamic_engraver, "Hairpin " "TextSpanner ", - /* read */ "", - /* write */ ""); + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/dynamic-performer.cc b/lily/dynamic-performer.cc index 9b8f366843..e5a7f20069 100644 --- a/lily/dynamic-performer.cc +++ b/lily/dynamic-performer.cc @@ -192,14 +192,19 @@ Dynamic_performer::listen_absolute_dynamic (Stream_event *r) } ADD_TRANSLATOR (Dynamic_performer, - /* doc */ "", - /* create */ "", + /* doc */ + "", + + /* create */ + "", /* read */ "dynamicAbsoluteVolumeFunction " "instrumentEqualizer " "midiMaximumVolume " "midiMinimumVolume " - "midiInstrument " - , - /*writes*/""); + "midiInstrument ", + + /* write */ + "" + ); diff --git a/lily/engraver-group.cc b/lily/engraver-group.cc index aaa2ed7625..eaa025dd17 100644 --- a/lily/engraver-group.cc +++ b/lily/engraver-group.cc @@ -178,10 +178,18 @@ Engraver_group::Engraver_group () #include "translator.icc" ADD_TRANSLATOR_GROUP (Engraver_group, - /* doc */ "A group of engravers taken together", - /* create */ "", - /* read */ "", - /* write */ ""); + /* doc */ + "A group of engravers taken together.", + + /* create */ + "", + + /* read */ + "", + + /* write */ + "" + ); void Engraver_group::derived_mark () const diff --git a/lily/engraver.cc b/lily/engraver.cc index 70a8bf512f..c749be110a 100644 --- a/lily/engraver.cc +++ b/lily/engraver.cc @@ -167,8 +167,16 @@ Engraver::internal_make_spanner (SCM x, SCM cause, char const *name, char const #include "translator.icc" ADD_TRANSLATOR (Engraver, - "Base class for engravers. Does nothing, so it is not used.", + /* doc */ + "Base class for engravers. Does nothing, so it is not used.", + + /* create */ "", + + /* read */ "", - ""); + + /* write */ + "" + ); diff --git a/lily/extender-engraver.cc b/lily/extender-engraver.cc index ced1f123ce..77a9f7c952 100644 --- a/lily/extender-engraver.cc +++ b/lily/extender-engraver.cc @@ -155,7 +155,15 @@ Extender_engraver::finalize () ADD_ACKNOWLEDGER (Extender_engraver, lyric_syllable); ADD_TRANSLATOR (Extender_engraver, - /* doc */ "Create lyric extenders", - /* create */ "LyricExtender", - /* read */ "extendersOverRests", - /* write */ ""); + /* doc */ + "Create lyric extenders.", + + /* create */ + "LyricExtender ", + + /* read */ + "extendersOverRests ", + + /* write */ + "" + ); diff --git a/lily/figured-bass-engraver.cc b/lily/figured-bass-engraver.cc index a73cdf6bd8..32ad86a9eb 100644 --- a/lily/figured-bass-engraver.cc +++ b/lily/figured-bass-engraver.cc @@ -482,15 +482,14 @@ Figured_bass_engraver::create_grobs () ADD_TRANSLATOR (Figured_bass_engraver, /* doc */ - "Make figured bass numbers.", + /* create */ "BassFigure " "BassFigureAlignment " "BassFigureBracket " "BassFigureContinuation " - "BassFigureLine " - , + "BassFigureLine ", /* read */ "figuredBassAlterationDirection " @@ -498,8 +497,8 @@ ADD_TRANSLATOR (Figured_bass_engraver, "figuredBassFormatter " "implicitBassFigures " "useBassFigureExtenders " - "ignoreFiguredBassRest " - , + "ignoreFiguredBassRest ", /* write */ - ""); + "" + ); diff --git a/lily/figured-bass-position-engraver.cc b/lily/figured-bass-position-engraver.cc index ced3f7ef6e..8043640a2f 100644 --- a/lily/figured-bass-position-engraver.cc +++ b/lily/figured-bass-position-engraver.cc @@ -145,5 +145,8 @@ ADD_TRANSLATOR (Figured_bass_position_engraver, "BassFigureAlignmentPositioning ", /* read */ - " ", - /* write */ ""); + "", + + /* write */ + "" + ); diff --git a/lily/fingering-engraver.cc b/lily/fingering-engraver.cc index 874771f774..0c9426f095 100644 --- a/lily/fingering-engraver.cc +++ b/lily/fingering-engraver.cc @@ -147,8 +147,14 @@ ADD_ACKNOWLEDGER (Fingering_engraver, stem); ADD_TRANSLATOR (Fingering_engraver, /* doc */ - "Create fingering-scripts", + "Create fingering scripts.", + /* create */ - "Fingering", - /* read */ "", - /* write */ ""); + "Fingering ", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/font-size-engraver.cc b/lily/font-size-engraver.cc index 39b36586ba..d554545e2d 100644 --- a/lily/font-size-engraver.cc +++ b/lily/font-size-engraver.cc @@ -52,7 +52,15 @@ Font_size_engraver::acknowledge_font (Grob_info gi) ADD_ACKNOWLEDGER (Font_size_engraver, font); ADD_TRANSLATOR (Font_size_engraver, - /* doc */ "Puts fontSize into font-size grob property.", - /* create */ "", - /* read */ "fontSize", - /* write */ ""); + /* doc */ + "Put @code{fontSize} into @code{font-size} grob property.", + + /* create */ + "", + + /* read */ + "fontSize ", + + /* write */ + "" + ); diff --git a/lily/forbid-break-engraver.cc b/lily/forbid-break-engraver.cc index c44bbb6012..68bfbb6bb8 100644 --- a/lily/forbid-break-engraver.cc +++ b/lily/forbid-break-engraver.cc @@ -48,8 +48,16 @@ Forbid_line_break_engraver::start_translation_timestep () } ADD_TRANSLATOR (Forbid_line_break_engraver, - /* doc */ "Forbid line breaks when note heads " - "are still playing at some point.", - /* create */ "", - /* read */ "busyGrobs", - /* write */ "forbidBreak"); + /* doc */ + "Forbid line breaks when note heads are still playing at some " + "point.", + + /* create */ + "", + + /* read */ + "busyGrobs ", + + /* write */ + "forbidBreak " + ); diff --git a/lily/fretboard-engraver.cc b/lily/fretboard-engraver.cc index d0ad15050f..71b7351bda 100644 --- a/lily/fretboard-engraver.cc +++ b/lily/fretboard-engraver.cc @@ -85,16 +85,20 @@ Fretboard_engraver::stop_translation_timestep () } ADD_TRANSLATOR (Fretboard_engraver, - /* doc */ "Generate one or more tablature noteheads from event of type NoteEvent.", + /* doc */ + "Generate one or more tablature noteheads from event of type " + "@code{NoteEvent}.", + /* create */ - "FretBoard " - , + "FretBoard ", /* read */ "stringTunings " "minimumFret " "tablatureFormat " - "highStringOne " - , - /* write */ ""); + "highStringOne ", + + /* write */ + "" + ); diff --git a/lily/glissando-engraver.cc b/lily/glissando-engraver.cc index 3a88ef888c..66afed6403 100644 --- a/lily/glissando-engraver.cc +++ b/lily/glissando-engraver.cc @@ -105,11 +105,15 @@ Glissando_engraver::finalize () ADD_ACKNOWLEDGER (Glissando_engraver, rhythmic_head); ADD_TRANSLATOR (Glissando_engraver, - /* doc */ "", + /* doc */ + "Engrave glissandi.", + /* create */ - "Glissando", + "Glissando ", /* read */ "", - /* write */ ""); + /* write */ + "" + ); diff --git a/lily/grace-engraver.cc b/lily/grace-engraver.cc index 5be9307f08..2b02020f62 100644 --- a/lily/grace-engraver.cc +++ b/lily/grace-engraver.cc @@ -106,7 +106,15 @@ Grace_engraver::start_translation_timestep () #include "translator.icc" ADD_TRANSLATOR (Grace_engraver, - /* doc */ "Set font size and other properties for grace notes.", - /* create */ "", - /* read */ "graceSettings", - /* write */ ""); + /* doc */ + "Set font size and other properties for grace notes.", + + /* create */ + "", + + /* read */ + "graceSettings ", + + /* write */ + "" + ); diff --git a/lily/grace-spacing-engraver.cc b/lily/grace-spacing-engraver.cc index 689f76212f..d5ccc67a65 100644 --- a/lily/grace-spacing-engraver.cc +++ b/lily/grace-spacing-engraver.cc @@ -70,7 +70,8 @@ Grace_spacing_engraver::stop_translation_timestep () ADD_TRANSLATOR (Grace_spacing_engraver, - "Bookkeeping of shortest starting and playing notes in grace note runs.", + "Bookkeeping of shortest starting and playing notes in grace " + "note runs.", /* create */ "GraceSpacing ", @@ -78,4 +79,6 @@ ADD_TRANSLATOR (Grace_spacing_engraver, /* read */ "currentMusicalColumn ", - /* write */ ""); + /* write */ + "" + ); diff --git a/lily/grid-line-span-engraver.cc b/lily/grid-line-span-engraver.cc index ede6afdf42..0026572c57 100644 --- a/lily/grid-line-span-engraver.cc +++ b/lily/grid-line-span-engraver.cc @@ -60,8 +60,16 @@ Grid_line_span_engraver::stop_translation_timestep () #include "translator.icc" ADD_ACKNOWLEDGER (Grid_line_span_engraver, grid_point); ADD_TRANSLATOR (Grid_line_span_engraver, - /* doc */ "This engraver makes cross-staff linelines: It catches all normal " - "line lines, and draws a single span-line across them.", - /* create */ "GridLine", - /* read */ "", - /* write */ ""); + /* doc */ + "This engraver makes cross-staff lines: It catches all normal " + "lines and draws a single span line across them.", + + /* create */ + "GridLine ", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/grid-point-engraver.cc b/lily/grid-point-engraver.cc index 1a3641717b..ab4b6f6279 100644 --- a/lily/grid-point-engraver.cc +++ b/lily/grid-point-engraver.cc @@ -38,8 +38,16 @@ Grid_point_engraver::Grid_point_engraver () } ADD_TRANSLATOR (Grid_point_engraver, - /* doc */ "generate grid points.", - /* create */ "GridPoint", - /* read */ "gridInterval", - /* write */ ""); + /* doc */ + "Generate grid points.", + + /* create */ + "GridPoint ", + + /* read */ + "gridInterval ", + + /* write */ + "" + ); diff --git a/lily/grob-pq-engraver.cc b/lily/grob-pq-engraver.cc index 7265d46347..0dd0d6e533 100644 --- a/lily/grob-pq-engraver.cc +++ b/lily/grob-pq-engraver.cc @@ -138,8 +138,16 @@ Grob_pq_engraver::start_translation_timestep () #include "translator.icc" ADD_ACKNOWLEDGER (Grob_pq_engraver, grob); ADD_TRANSLATOR (Grob_pq_engraver, + /* doc */ + "Administrate when certain grobs (e.g., note heads) stop " + "playing.", - /* doc */ "Administrate when certain grobs (eg. note heads) stop playing", - /* create */ "", - /* read */ "busyGrobs", - /* write */ "busyGrobs"); + /* create */ + "", + + /* read */ + "busyGrobs ", + + /* write */ + "busyGrobs " + ); diff --git a/lily/hara-kiri-engraver.cc b/lily/hara-kiri-engraver.cc index 79fbd11f9d..0661bf7e64 100644 --- a/lily/hara-kiri-engraver.cc +++ b/lily/hara-kiri-engraver.cc @@ -79,9 +79,18 @@ Hara_kiri_engraver::acknowledge_grob (Grob_info i) ADD_ACKNOWLEDGER (Hara_kiri_engraver, grob); ADD_TRANSLATOR (Hara_kiri_engraver, - /* doc */ "Like Axis_group_engraver, but make a hara-kiri spanner, and add " - "interesting items (ie. note heads, lyric syllables and normal rests) ", - /* create */ "VerticalAxisGroup", - /* read */ "keepAliveInterfaces", - /* write */ ""); + /* doc */ + "Like @code{Axis_group_engraver}, but make a hara-kiri " + "spanner, and add interesting items (i.e., note heads, lyric " + "syllables, and normal rests).", + + /* create */ + "VerticalAxisGroup ", + + /* read */ + "keepAliveInterfaces ", + + /* write */ + "" + ); diff --git a/lily/horizontal-bracket-engraver.cc b/lily/horizontal-bracket-engraver.cc index d7e453da1f..2dea762454 100644 --- a/lily/horizontal-bracket-engraver.cc +++ b/lily/horizontal-bracket-engraver.cc @@ -35,10 +35,19 @@ public: ADD_ACKNOWLEDGER (Horizontal_bracket_engraver, note_column); ADD_TRANSLATOR (Horizontal_bracket_engraver, - "Create horizontal brackets over notes for musical analysis purposes.", - "HorizontalBracket", + /* doc */ + "Create horizontal brackets over notes for musical analysis " + "purposes.", + + /* create */ + "HorizontalBracket ", + + /* read */ "", - ""); + + /* write */ + "" + ); Horizontal_bracket_engraver::Horizontal_bracket_engraver () { diff --git a/lily/hyphen-engraver.cc b/lily/hyphen-engraver.cc index 3e03d9b8e0..a9ea53054e 100644 --- a/lily/hyphen-engraver.cc +++ b/lily/hyphen-engraver.cc @@ -147,8 +147,16 @@ Hyphen_engraver::stop_translation_timestep () ADD_ACKNOWLEDGER (Hyphen_engraver, lyric_syllable); ADD_TRANSLATOR (Hyphen_engraver, - /* doc */ "Create lyric hyphens and " - "distance constraints between words.", - /* create */ "LyricHyphen LyricSpace", - /* read */ "", - /* write */ ""); + /* doc */ + "Create lyric hyphens and distance constraints between words.", + + /* create */ + "LyricHyphen " + "LyricSpace ", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/instrument-name-engraver.cc b/lily/instrument-name-engraver.cc index d280913e53..d35e065afb 100644 --- a/lily/instrument-name-engraver.cc +++ b/lily/instrument-name-engraver.cc @@ -146,9 +146,8 @@ Instrument_name_engraver::stop_spanner () ADD_ACKNOWLEDGER (Instrument_name_engraver, axis_group); ADD_TRANSLATOR (Instrument_name_engraver, - /* doc */ - "Creates a system start text for instrument or vocal names.", + "Create a system start text for instrument or vocal names.", /* create */ "InstrumentName ", @@ -158,7 +157,8 @@ ADD_TRANSLATOR (Instrument_name_engraver, "shortInstrumentName " "instrumentName " "shortVocalName " - "vocalName " - , + "vocalName ", - /* write */ ""); + /* write */ + "" + ); diff --git a/lily/instrument-switch-engraver.cc b/lily/instrument-switch-engraver.cc index 2637fba441..9107297677 100644 --- a/lily/instrument-switch-engraver.cc +++ b/lily/instrument-switch-engraver.cc @@ -54,10 +54,15 @@ Instrument_switch_engraver::stop_translation_time_step () } ADD_TRANSLATOR (Instrument_switch_engraver, - "Create a cue text for taking instrument.", + /* doc */ + "Create a cue text for taking instrument.", - "InstrumentSwitch ", + /* create */ + "InstrumentSwitch ", - "instrumentCueName", + /* read */ + "instrumentCueName ", - ""); + /* write */ + "" + ); diff --git a/lily/key-engraver.cc b/lily/key-engraver.cc index 0b0a282064..d3b7eb01dd 100644 --- a/lily/key-engraver.cc +++ b/lily/key-engraver.cc @@ -208,8 +208,11 @@ ADD_ACKNOWLEDGER (Key_engraver, clef); ADD_ACKNOWLEDGER (Key_engraver, bar_line); ADD_TRANSLATOR (Key_engraver, - /* doc */ "", - /* create */ "KeySignature", + /* doc */ + "Engrave a key signature.", + + /* create */ + "KeySignature ", /* read */ "createKeyOnClefChange " @@ -218,10 +221,10 @@ ADD_TRANSLATOR (Key_engraver, "keyAlterationOrder " "keySignature " "lastKeySignature " - "printKeyCancellation " - , + "printKeyCancellation ", /* write */ "keySignature " "lastKeySignature " - "tonic ") + "tonic " + ); diff --git a/lily/key-performer.cc b/lily/key-performer.cc index 32f94a632e..8a12e9bcf5 100644 --- a/lily/key-performer.cc +++ b/lily/key-performer.cc @@ -96,7 +96,15 @@ Key_performer::listen_key_change (Stream_event *ev) } ADD_TRANSLATOR (Key_performer, + /* doc */ "", + + /* create */ "", + + /* read */ "", - ""); + + /* write */ + "" + ); diff --git a/lily/laissez-vibrer-engraver.cc b/lily/laissez-vibrer-engraver.cc index a6a4bd0e2b..efb0afbaa4 100644 --- a/lily/laissez-vibrer-engraver.cc +++ b/lily/laissez-vibrer-engraver.cc @@ -81,10 +81,16 @@ Laissez_vibrer_engraver::acknowledge_note_head (Grob_info inf) ADD_ACKNOWLEDGER (Laissez_vibrer_engraver, note_head); ADD_TRANSLATOR (Laissez_vibrer_engraver, - /* doc */ "Create Laissez vibrer items.", + /* doc */ + "Create laissez vibrer items.", /* create */ "LaissezVibrerTie " "LaissezVibrerTieColumn ", - /* read */ "", - /* write */ ""); + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/ledger-line-engraver.cc b/lily/ledger-line-engraver.cc index ecff48a7b8..ea06ac0e19 100644 --- a/lily/ledger-line-engraver.cc +++ b/lily/ledger-line-engraver.cc @@ -113,7 +113,16 @@ Ledger_line_engraver::acknowledge_ledgered (Grob_info s) ADD_ACKNOWLEDGER (Ledger_line_engraver, ledgered); ADD_ACKNOWLEDGER (Ledger_line_engraver, staff_symbol); ADD_TRANSLATOR (Ledger_line_engraver, - "Creates the spanner to draw ledger lines, and notices objects that need ledger lines", - /* create */ "LedgerLineSpanner", - /* read */ "", - /* write */ "") + /* doc */ + "Create the spanner to draw ledger lines, and notices " + "objects that need ledger lines.", + + /* create */ + "LedgerLineSpanner ", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/ligature-bracket-engraver.cc b/lily/ligature-bracket-engraver.cc index 9a4374f2ca..69c51dfb74 100644 --- a/lily/ligature-bracket-engraver.cc +++ b/lily/ligature-bracket-engraver.cc @@ -111,7 +111,16 @@ ADD_ACKNOWLEDGER (Ligature_bracket_engraver, rest); ADD_ACKNOWLEDGER (Ligature_bracket_engraver, note_column); ADD_TRANSLATOR (Ligature_bracket_engraver, - /* doc */ "Handles Ligature_events by engraving Ligature brackets.", - /* create */ "LigatureBracket", - /* read */ "", - /* write */ ""); + /* doc */ + "Handle @code{Ligature_events} by engraving @code{Ligature} " + "brackets.", + + /* create */ + "LigatureBracket ", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/lyric-engraver.cc b/lily/lyric-engraver.cc index ce13839089..0aa5fe3c97 100644 --- a/lily/lyric-engraver.cc +++ b/lily/lyric-engraver.cc @@ -171,7 +171,14 @@ Lyric_engraver::stop_translation_timestep () } ADD_TRANSLATOR (Lyric_engraver, - /* doc */ "", - /* create */ "LyricText", - /* read */ "lyricMelismaAlignment", - /* write */ ""); + /* doc */ + "Engrave text for lyrics.", + + /* create */ + "LyricText ", + /* read */ + "lyricMelismaAlignment ", + + /* write */ + "" + ); diff --git a/lily/lyric-performer.cc b/lily/lyric-performer.cc index 0d14a737d2..d759d4603a 100644 --- a/lily/lyric-performer.cc +++ b/lily/lyric-performer.cc @@ -63,5 +63,16 @@ Lyric_performer::listen_lyric (Stream_event *event) events_.push_back (event); } -ADD_TRANSLATOR (Lyric_performer, "", "", - "", ""); +ADD_TRANSLATOR (Lyric_performer, + /* doc */ + "", + + /* create */ + "", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/mark-engraver.cc b/lily/mark-engraver.cc index 8c0233c909..1b7ed78c42 100644 --- a/lily/mark-engraver.cc +++ b/lily/mark-engraver.cc @@ -139,17 +139,21 @@ Mark_engraver::process_music () ADD_ACKNOWLEDGER (Mark_engraver, break_alignment); ADD_TRANSLATOR (Mark_engraver, - /* doc */ "This engraver will create RehearsalMark objects. " - "It puts them on top of all staves (which is taken from " - "the property @code{stavesFound}). If moving this engraver " - "to a different context, " - "@ref{Staff_collecting_engraver} must move along, otherwise all marks" - "end up on the same Y-location", + /* doc */ + "Create @code{RehearsalMark} objects. It puts them on top of " + "all staves (which is taken from the property " + "@code{stavesFound}). If moving this engraver to a different " + "context, @ref{Staff_collecting_engraver} must move along, " + "otherwise all marks end up on the same Y@tie{}location.", - /* create */ "RehearsalMark", + /* create */ + "RehearsalMark ", + /* read */ "markFormatter " "rehearsalMark " "stavesFound ", - /* write */ ""); + /* write */ + "" + ); diff --git a/lily/measure-grouping-engraver.cc b/lily/measure-grouping-engraver.cc index 311448302c..81d3c5584e 100644 --- a/lily/measure-grouping-engraver.cc +++ b/lily/measure-grouping-engraver.cc @@ -109,14 +109,17 @@ Measure_grouping_engraver::Measure_grouping_engraver () ADD_ACKNOWLEDGER (Measure_grouping_engraver, note_column); ADD_TRANSLATOR (Measure_grouping_engraver, /* doc */ - "Creates MeasureGrouping to indicate beat subdivision.", + "Create @code{MeasureGrouping} to indicate beat subdivision.", + /* create */ - "MeasureGrouping", + "MeasureGrouping ", + /* read */ "beatLength " "currentMusicalColumn " "measurePosition " - "beatGrouping " - , + "beatGrouping ", + /* write */ - ""); + "" + ); diff --git a/lily/melody-engraver.cc b/lily/melody-engraver.cc index 9c0cb1d5fa..a39dda1c84 100644 --- a/lily/melody-engraver.cc +++ b/lily/melody-engraver.cc @@ -83,8 +83,17 @@ ADD_ACKNOWLEDGER (Melody_engraver, stem); ADD_ACKNOWLEDGER (Melody_engraver, slur); ADD_TRANSLATOR (Melody_engraver, - "Create information for context dependent typesetting decisions. ", - "MelodyItem", + /* doc */ + "Create information for context dependent typesetting " + "decisions.", + + /* create */ + "MelodyItem ", + + /* read */ "", - ""); + + /* write */ + "" + ); diff --git a/lily/mensural-ligature-engraver.cc b/lily/mensural-ligature-engraver.cc index d45c90c7dc..9271013d6c 100644 --- a/lily/mensural-ligature-engraver.cc +++ b/lily/mensural-ligature-engraver.cc @@ -418,7 +418,16 @@ ADD_ACKNOWLEDGER (Mensural_ligature_engraver, rest); ADD_ACKNOWLEDGER (Mensural_ligature_engraver, note_head); ADD_TRANSLATOR (Mensural_ligature_engraver, - /* doc */ "Handles Mensural_ligature_events by glueing special ligature heads together.", - /* create */ "MensuralLigature", - /* read */ "", - /* write */ ""); + /* doc */ + "Handle @code{Mensural_ligature_events} by glueing special " + "ligature heads together.", + + /* create */ + "MensuralLigature ", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/metronome-engraver.cc b/lily/metronome-engraver.cc index 26f1ec9b91..b30fea183a 100644 --- a/lily/metronome-engraver.cc +++ b/lily/metronome-engraver.cc @@ -94,18 +94,22 @@ Metronome_mark_engraver::process_music () } ADD_TRANSLATOR (Metronome_mark_engraver, - /* doc */ "Engrave metro nome marking. This delegates the formatting work " - "to the function in the metronomeMarkFormatter property. " - "The mark is put over all staves. " - "The staves are taken from the @code{stavesFound} property, " - "which is maintained by @code{@ref{Staff_collecting_engraver}}. ", - /* create */ "MetronomeMark", + /* doc */ + "Engrave metronome marking. This delegates the formatting " + "work to the function in the @code{metronomeMarkFormatter} " + "property. The mark is put over all staves. The staves are " + "taken from the @code{stavesFound} property, which is " + "maintained by @ref{Staff_collecting_engraver}.", + + /* create */ + "MetronomeMark ", /* read */ "stavesFound " "metronomeMarkFormatter " "tempoUnitDuration " - "tempoUnitCount " - , + "tempoUnitCount ", - /* write */ ""); + /* write */ + "" + ); diff --git a/lily/multi-measure-rest-engraver.cc b/lily/multi-measure-rest-engraver.cc index cf5f25a613..d621652247 100644 --- a/lily/multi-measure-rest-engraver.cc +++ b/lily/multi-measure-rest-engraver.cc @@ -252,10 +252,12 @@ Multi_measure_rest_engraver::finalize () ADD_TRANSLATOR (Multi_measure_rest_engraver, /* doc */ - "Engraves multi-measure rests that are produced with @code{R}. Reads " - "@code{measurePosition} and @code{internalBarNumber} to determine what number to print " - "over the @ref{MultiMeasureRest}. Reads @code{measureLength} to determine if it " - "should use a whole rest or a breve rest to represent 1 measure ", + "Engrave multi-measure rests that are produced with " + "@samp{R}. It reads @code{measurePosition} and " + "@code{internalBarNumber} to determine what number to print " + "over the @ref{MultiMeasureRest}. Reads @code{measureLength} " + "to determine whether it should use a whole rest or a breve " + "rest to represent one measure.", /* create */ "MultiMeasureRest " @@ -270,4 +272,6 @@ ADD_TRANSLATOR (Multi_measure_rest_engraver, "measurePosition " "measureLength ", - /* write */ ""); + /* write */ + "" + ); diff --git a/lily/new-fingering-engraver.cc b/lily/new-fingering-engraver.cc index 1aaa6a04eb..546fa8d3f6 100644 --- a/lily/new-fingering-engraver.cc +++ b/lily/new-fingering-engraver.cc @@ -345,20 +345,22 @@ ADD_ACKNOWLEDGER (New_fingering_engraver, rhythmic_head); ADD_ACKNOWLEDGER (New_fingering_engraver, stem); ADD_TRANSLATOR (New_fingering_engraver, - /* doc */ "Create fingering-scripts for notes in a new chord. " - "This engraver is ill-named, since it " - "also takes care of articulations and harmonic note heads", + /* doc */ + "Create fingering scripts for notes in a new chord. This " + "engraver is ill-named, since it also takes care of " + "articulations and harmonic note heads.", + /* create */ "Fingering " "StringNumber " "StrokeFinger " - "Script " - , + "Script ", + /* read */ - "fingeringOrientations " "strokeFingerOrientations " - "stringNumberOrientations " - , + "stringNumberOrientations ", - /* write */ ""); + /* write */ + "" + ); diff --git a/lily/note-head-line-engraver.cc b/lily/note-head-line-engraver.cc index aaf1304d29..35698563a7 100644 --- a/lily/note-head-line-engraver.cc +++ b/lily/note-head-line-engraver.cc @@ -103,8 +103,18 @@ Note_head_line_engraver::stop_translation_timestep () ADD_ACKNOWLEDGER (Note_head_line_engraver, rhythmic_head); ADD_TRANSLATOR (Note_head_line_engraver, - /* doc */ "Engrave a line between two note heads, for example a glissando. If " - " followVoice is set, staff switches also generate a line.", - /* create */ "Glissando VoiceFollower", - /* read */ "followVoice", - /* write */ ""); + /* doc */ + "Engrave a line between two note heads, for example a " + "glissando. If @code{followVoice} is set, staff switches " + "also generate a line.", + + /* create */ + "Glissando " + "VoiceFollower ", + + /* read */ + "followVoice ", + + /* write */ + "" + ); diff --git a/lily/note-heads-engraver.cc b/lily/note-heads-engraver.cc index 7240d61d51..173961cb08 100644 --- a/lily/note-heads-engraver.cc +++ b/lily/note-heads-engraver.cc @@ -112,9 +112,16 @@ Note_heads_engraver::stop_translation_timestep () } ADD_TRANSLATOR (Note_heads_engraver, - /* doc */ "Generate noteheads.", + /* doc */ + "Generate note heads.", + /* create */ "NoteHead ", - /* read */ "middleCPosition " + + /* read */ + "middleCPosition " "staffLineLayoutFunction ", - /* write */ ""); + + /* write */ + "" + ); diff --git a/lily/note-name-engraver.cc b/lily/note-name-engraver.cc index 1aebfd3d84..1cf78ba5e9 100644 --- a/lily/note-name-engraver.cc +++ b/lily/note-name-engraver.cc @@ -67,7 +67,15 @@ Note_name_engraver::Note_name_engraver () } ADD_TRANSLATOR (Note_name_engraver, - /* doc */ "Print pitches as words.", - /* create */ "NoteName", - /* read */ "printOctaveNames", - /* write */ ""); + /* doc */ + "Print pitches as words.", + + /* create */ + "NoteName ", + + /* read */ + "printOctaveNames ", + + /* write */ + "" + ); diff --git a/lily/note-performer.cc b/lily/note-performer.cc index 776061f6c6..435575da60 100644 --- a/lily/note-performer.cc +++ b/lily/note-performer.cc @@ -111,8 +111,19 @@ Note_performer::listen_note (Stream_event *ev) note_evs_.push_back (ev); } -ADD_TRANSLATOR (Note_performer, "", "", - "", ""); +ADD_TRANSLATOR (Note_performer, + /* doc */ + "", + + /* create */ + "", + + /* read */ + "", + + /* write */ + "" + ); Note_performer::Note_performer () { diff --git a/lily/note-spacing-engraver.cc b/lily/note-spacing-engraver.cc index f1a8cbbf23..23b0fcd797 100644 --- a/lily/note-spacing-engraver.cc +++ b/lily/note-spacing-engraver.cc @@ -130,7 +130,16 @@ ADD_ACKNOWLEDGER (Note_spacing_engraver, note_column); ADD_ACKNOWLEDGER (Note_spacing_engraver, rhythmic_grob); ADD_TRANSLATOR (Note_spacing_engraver, - /* doc */ "Generates NoteSpacing, an object linking horizontal lines for use in spacing.", - /* create */ "NoteSpacing", - /* read */ "", - /* write */ ""); + /* doc */ + "Generate @code{NoteSpacing}, an object linking horizontal " + "lines for use in spacing.", + + /* create */ + "NoteSpacing ", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/ottava-engraver.cc b/lily/ottava-engraver.cc index 01bf1d85c6..f104287796 100644 --- a/lily/ottava-engraver.cc +++ b/lily/ottava-engraver.cc @@ -129,12 +129,17 @@ Ottava_spanner_engraver::finalize () ADD_ACKNOWLEDGER (Ottava_spanner_engraver, note_column); ADD_TRANSLATOR (Ottava_spanner_engraver, - /* doc */ "Create a text spanner when the ottavation property changes..", - /* create */ "OttavaBracket", - /* read */ "ottavation " + /* doc */ + "Create a text spanner when the ottavation property changes.", + + /* create */ + "OttavaBracket ", + + /* read */ + "ottavation " "originalMiddleCPosition " - "currentMusicalColumn " - - , + "currentMusicalColumn ", - /* write */ ""); + /* write */ + "" + ); diff --git a/lily/output-property-engraver.cc b/lily/output-property-engraver.cc index e66faba789..cbef4235a1 100644 --- a/lily/output-property-engraver.cc +++ b/lily/output-property-engraver.cc @@ -66,9 +66,8 @@ Output_property_engraver::Output_property_engraver () ADD_ACKNOWLEDGER (Output_property_engraver, grob); ADD_TRANSLATOR (Output_property_engraver, - /* doc */ - "Apply a procedure to any grob acknowledged. ", + "Apply a procedure to any grob acknowledged.", /* create */ "", @@ -77,4 +76,5 @@ ADD_TRANSLATOR (Output_property_engraver, "", /* write */ - ""); + "" + ); diff --git a/lily/page-turn-engraver.cc b/lily/page-turn-engraver.cc index fbd7370bcc..02a437d863 100644 --- a/lily/page-turn-engraver.cc +++ b/lily/page-turn-engraver.cc @@ -332,10 +332,16 @@ Page_turn_engraver::finalize () ADD_ACKNOWLEDGER (Page_turn_engraver, note_head); ADD_TRANSLATOR (Page_turn_engraver, - /* doc */ "Decide where page turns are allowed to go", - /* create */ "", + /* doc */ + "Decide where page turns are allowed to go.", + + /* create */ + "", + /* read */ "minimumPageTurnLength " "minimumRepeatLengthForPageTurn ", - /* write */ "" + + /* write */ + "" ); diff --git a/lily/paper-column-engraver.cc b/lily/paper-column-engraver.cc index 481ffd1464..58fd467ae6 100644 --- a/lily/paper-column-engraver.cc +++ b/lily/paper-column-engraver.cc @@ -263,21 +263,25 @@ ADD_ACKNOWLEDGER (Paper_column_engraver, note_spacing); ADD_ACKNOWLEDGER (Paper_column_engraver, staff_spacing); ADD_TRANSLATOR (Paper_column_engraver, - /* doc */ "Takes care of generating columns." - "\n\n " - "This engraver decides whether a column is breakable. The default is " - "that a column is always breakable. However, every Bar_engraver " - "that does not have a barline at a certain point will set forbidBreaks " - "in the score context to stop linebreaks. In practice, this " - "means that you can make a breakpoint by creating a barline (assuming " - "that there are no beams or notes that prevent a breakpoint.) ", + /* doc */ + "Take care of generating columns.\n" + "\n" + "This engraver decides whether a column is breakable. The " + "default is that a column is always breakable. However, " + "every @code{Bar_engraver} that does not have a barline at a " + "certain point will set @code{forbidBreaks} in the score " + "context to stop line breaks. In practice, this means that " + "you can make a break point by creating a bar line (assuming " + "that there are no beams or notes that prevent a break " + "point).", /* create */ "PaperColumn " - "NonMusicalPaperColumn", + "NonMusicalPaperColumn ", + /* read */ - "forbidBreak " - , + "forbidBreak ", + /* write */ "forbidBreak " "currentCommandColumn " diff --git a/lily/parenthesis-engraver.cc b/lily/parenthesis-engraver.cc index 10e3be740e..5cfa3adb71 100644 --- a/lily/parenthesis-engraver.cc +++ b/lily/parenthesis-engraver.cc @@ -64,10 +64,16 @@ Parenthesis_engraver::acknowledge_grob (Grob_info info) ADD_ACKNOWLEDGER (Parenthesis_engraver, grob); ADD_TRANSLATOR (Parenthesis_engraver, - /* doc */ "Parenthesize objects whose music cause has the @code{parenthesize} " - "property.", + /* doc */ + "Parenthesize objects whose music cause has the " + "@code{parenthesize} property.", /* create */ "ParenthesesItem ", - /* read */ "", - /* write */ ""); + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/part-combine-engraver.cc b/lily/part-combine-engraver.cc index b12eb19a5f..178a9176e4 100644 --- a/lily/part-combine-engraver.cc +++ b/lily/part-combine-engraver.cc @@ -101,12 +101,19 @@ Part_combine_engraver::stop_translation_timestep () ADD_ACKNOWLEDGER (Part_combine_engraver, note_head); ADD_ACKNOWLEDGER (Part_combine_engraver, stem); ADD_TRANSLATOR (Part_combine_engraver, - /* doc */ "Part combine engraver for orchestral scores: " - "Print markings a2, Solo, Solo II, and unisono ", - /* create */ "CombineTextScript", + /* doc */ + "Part combine engraver for orchestral scores: Print markings " + "@q{a2}, @q{Solo}, @q{Solo II}, and @q{unisono}.", + + /* create */ + "CombineTextScript ", + /* read */ "printPartCombineTexts " "soloText " "soloIIText " - "aDueText", - /* write */ ""); + "aDueText ", + + /* write */ + "" + ); diff --git a/lily/performer-group.cc b/lily/performer-group.cc index 4b3270f4ee..32c22d13da 100644 --- a/lily/performer-group.cc +++ b/lily/performer-group.cc @@ -14,10 +14,18 @@ #include "warn.hh" ADD_TRANSLATOR_GROUP (Performer_group, - /* doc */ "", - /* create */ "", - /* read */ "", - /* write */ ""); + /* doc */ + "", + + /* create */ + "", + + /* read */ + "", + + /* write */ + "" + ); void Performer_group::announce_element (Audio_element_info info) diff --git a/lily/phrasing-slur-engraver.cc b/lily/phrasing-slur-engraver.cc index 10b767d615..b0ef2b2d74 100644 --- a/lily/phrasing-slur-engraver.cc +++ b/lily/phrasing-slur-engraver.cc @@ -177,7 +177,15 @@ ADD_ACKNOWLEDGER (Phrasing_slur_engraver, text_script); ADD_ACKNOWLEDGER (Phrasing_slur_engraver, tie); ADD_TRANSLATOR (Phrasing_slur_engraver, - /* doc */ "Print phrasing slurs. Similar to @ref{Slur_engraver}", - /* create */ "PhrasingSlur", - /* read */ "", - /* write */ ""); + /* doc */ + "Print phrasing slurs. Similar to @ref{Slur_engraver}.", + + /* create */ + "PhrasingSlur ", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/piano-pedal-align-engraver.cc b/lily/piano-pedal-align-engraver.cc index a7031fbb01..c05f7fdc6e 100644 --- a/lily/piano-pedal-align-engraver.cc +++ b/lily/piano-pedal-align-engraver.cc @@ -251,7 +251,6 @@ ADD_END_ACKNOWLEDGER (Piano_pedal_align_engraver, piano_pedal_bracket); ADD_TRANSLATOR (Piano_pedal_align_engraver, - /* doc */ "Align piano pedal symbols and brackets.", @@ -263,4 +262,6 @@ ADD_TRANSLATOR (Piano_pedal_align_engraver, /* read */ "currentCommandColumn ", - /* write */ ""); + /* write */ + "" + ); diff --git a/lily/piano-pedal-engraver.cc b/lily/piano-pedal-engraver.cc index 703183b3c6..141ae8e3af 100644 --- a/lily/piano-pedal-engraver.cc +++ b/lily/piano-pedal-engraver.cc @@ -493,7 +493,6 @@ Piano_pedal_engraver::typeset_all (Pedal_info *p) ADD_ACKNOWLEDGER (Piano_pedal_engraver, note_column); ADD_TRANSLATOR (Piano_pedal_engraver, - /* doc */ "Engrave piano pedal symbols and brackets.", @@ -510,6 +509,8 @@ ADD_TRANSLATOR (Piano_pedal_engraver, "pedalSustainStrings " "pedalSustainStyle " "pedalUnaCordaStrings " - "pedalUnaCordaStyle", + "pedalUnaCordaStyle ", - /* write */ ""); + /* write */ + "" + ); diff --git a/lily/piano-pedal-performer.cc b/lily/piano-pedal-performer.cc index 0c52377670..323ee40cd3 100644 --- a/lily/piano-pedal-performer.cc +++ b/lily/piano-pedal-performer.cc @@ -159,5 +159,16 @@ Piano_pedal_performer::listen_una_corda (Stream_event *r) info_alist_[UNA_CORDA].event_drul_[d] = r; } -ADD_TRANSLATOR (Piano_pedal_performer, "", "", - "", ""); +ADD_TRANSLATOR (Piano_pedal_performer, + /* doc */ + "", + + /* create */ + "", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/pitch-squash-engraver.cc b/lily/pitch-squash-engraver.cc index 8fd4d4e26d..3a8cb7ea29 100644 --- a/lily/pitch-squash-engraver.cc +++ b/lily/pitch-squash-engraver.cc @@ -36,12 +36,17 @@ Pitch_squash_engraver::Pitch_squash_engraver () ADD_ACKNOWLEDGER (Pitch_squash_engraver, note_head); ADD_TRANSLATOR (Pitch_squash_engraver, /* doc */ - "Set the vertical position of noteheads to " - "@code{squashedPosition}, if that " - "property is set. " - "This can be used to make a single line staff " - "demonstrating the rhythm of a melody.", - - /* create */ "", - /* read */ "squashedPosition", - /* write */ ""); + "Set the vertical position of note heads to " + "@code{squashedPosition}, if that property is set. This can " + "be used to make a single-line staff demonstrating the " + "rhythm of a melody.", + + /* create */ + "", + + /* read */ + "squashedPosition ", + + /* write */ + "" + ); diff --git a/lily/pitched-trill-engraver.cc b/lily/pitched-trill-engraver.cc index daa3bee42c..3104b48ce0 100644 --- a/lily/pitched-trill-engraver.cc +++ b/lily/pitched-trill-engraver.cc @@ -140,13 +140,16 @@ ADD_ACKNOWLEDGER (Pitched_trill_engraver, trill_spanner); ADD_TRANSLATOR (Pitched_trill_engraver, /* doc */ - "Print the bracketed notehead after a notehead with trill.", + "Print the bracketed note head after a note head with trill.", /* create */ "TrillPitchHead " "TrillPitchAccidental " "TrillPitchGroup ", - /* read */ "", + /* read */ + "", - /* write */ ""); + /* write */ + "" + ); diff --git a/lily/repeat-acknowledge-engraver.cc b/lily/repeat-acknowledge-engraver.cc index 3e3025556f..209c7d5017 100644 --- a/lily/repeat-acknowledge-engraver.cc +++ b/lily/repeat-acknowledge-engraver.cc @@ -107,8 +107,18 @@ Repeat_acknowledge_engraver::process_music () } ADD_TRANSLATOR (Repeat_acknowledge_engraver, - /* doc */ "Acknowledge repeated music, and convert the contents of " - "repeatCommands ainto an appropriate setting for whichBar.", - /* create */ "", - /* read */ "repeatCommands whichBar", - /* write */ ""); + /* doc */ + "Acknowledge repeated music, and convert the contents of " + "@code{repeatCommands} into an appropriate setting for " + "@code{whichBar}.", + + /* create */ + "", + + /* read */ + "repeatCommands " + "whichBar ", + + /* write */ + "" + ); diff --git a/lily/repeat-tie-engraver.cc b/lily/repeat-tie-engraver.cc index 1285848a32..832a584d41 100644 --- a/lily/repeat-tie-engraver.cc +++ b/lily/repeat-tie-engraver.cc @@ -81,10 +81,16 @@ Repeat_tie_engraver::acknowledge_note_head (Grob_info inf) ADD_ACKNOWLEDGER (Repeat_tie_engraver, note_head); ADD_TRANSLATOR (Repeat_tie_engraver, - /* doc */ "Create repeat ties.", + /* doc */ + "Create repeat ties.", /* create */ "RepeatTie " "RepeatTieColumn ", - /* read */ "", - /* write */ ""); + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/rest-collision-engraver.cc b/lily/rest-collision-engraver.cc index d0704a10b5..ecc3164c7c 100644 --- a/lily/rest-collision-engraver.cc +++ b/lily/rest-collision-engraver.cc @@ -67,7 +67,15 @@ Rest_collision_engraver::stop_translation_timestep () ADD_ACKNOWLEDGER (Rest_collision_engraver, note_column); ADD_TRANSLATOR (Rest_collision_engraver, - /* doc */ "Handles collisions of rests.", - /* create */ "RestCollision", - /* read */ "", - /* write */ ""); + /* doc */ + "Handle collisions of rests.", + + /* create */ + "RestCollision ", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/rest-engraver.cc b/lily/rest-engraver.cc index e6e7ecb7de..13f8d70a89 100644 --- a/lily/rest-engraver.cc +++ b/lily/rest-engraver.cc @@ -77,7 +77,15 @@ Rest_engraver::listen_rest (Stream_event *ev) } ADD_TRANSLATOR (Rest_engraver, - /* doc */ "", - /* create */ "Rest ", - /* read */ "middleCPosition", - /* write */ ""); + /* doc */ + "Engrave rests.", + + /* create */ + "Rest ", + + /* read */ + "middleCPosition ", + + /* write */ + "" + ); diff --git a/lily/rhythmic-column-engraver.cc b/lily/rhythmic-column-engraver.cc index 827a6fb94f..b80f0de61b 100644 --- a/lily/rhythmic-column-engraver.cc +++ b/lily/rhythmic-column-engraver.cc @@ -130,7 +130,16 @@ ADD_ACKNOWLEDGER (Rhythmic_column_engraver, rhythmic_head); ADD_ACKNOWLEDGER (Rhythmic_column_engraver, arpeggio); ADD_TRANSLATOR (Rhythmic_column_engraver, - /* doc */ "Generates NoteColumn, an objects that groups stems, noteheads and rests.", - /* create */ "NoteColumn", - /* read */ "", - /* write */ ""); + /* doc */ + "Generate @code{NoteColumn}, an object that groups stems, " + "note heads, and rests.", + + /* create */ + "NoteColumn ", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/score-engraver.cc b/lily/score-engraver.cc index 8d66adf0dd..746701722f 100644 --- a/lily/score-engraver.cc +++ b/lily/score-engraver.cc @@ -170,14 +170,20 @@ Score_engraver::typeset_all () } ADD_TRANSLATOR_GROUP (Score_engraver, - /* doc */ "Top level engraver. Takes care of generating columns and the complete system (ie. System) " - "\n\n " - "This engraver decides whether a column is breakable. The default is " - "that a column is always breakable. However, every Bar_engraver " - "that does not have a barline at a certain point will set " - "forbidBreaks to stop linebreaks. In practice, this " - "means that you can make a breakpoint by creating a barline (assuming " - "that there are no beams or notes that prevent a breakpoint.) ", + /* doc */ + "The top-level engraver. Takes care of generating " + "columns and the complete system (i.e., " + "@code{System}).\n" + "\n" + "This engraver decides whether a column is breakable. " + "The default is that a column is always breakable. " + "However, every @code{Bar_engraver} that does not have " + "a bar line at a certain point sets @code{forbidBreaks} " + "to stop line breaks. In practice, this means that you " + "can make a break point by creating a bar line " + "(assuming that there are no beams or notes that " + "prevent a break point).", + /* create */ "System ", @@ -187,4 +193,5 @@ ADD_TRANSLATOR_GROUP (Score_engraver, "verticallySpacedContexts ", /* write */ - ""); + "" + ); diff --git a/lily/score-performer.cc b/lily/score-performer.cc index 99d2f84967..58043e0644 100644 --- a/lily/score-performer.cc +++ b/lily/score-performer.cc @@ -22,10 +22,18 @@ #include "audio-item.hh" ADD_TRANSLATOR_GROUP (Score_performer, - /* doc */ "", - /* create */ "", - /* read */ "", - /* write */ ""); + /* doc */ + "", + + /* create */ + "", + + /* read */ + "", + + /* write */ + "" + ); Score_performer::Score_performer () { diff --git a/lily/script-column-engraver.cc b/lily/script-column-engraver.cc index 6a0211530d..8a3a54327d 100644 --- a/lily/script-column-engraver.cc +++ b/lily/script-column-engraver.cc @@ -68,7 +68,16 @@ Script_column_engraver::process_acknowledged () ADD_ACKNOWLEDGER (Script_column_engraver, side_position); ADD_TRANSLATOR (Script_column_engraver, - /* doc */ "", - /* create */ "ScriptColumn", - /* read */ "", - /* write */ ""); + /* doc */ + "Find potentially colliding scripts and put them into a " + "@code{ScriptColumn} object; that will fix the collisions.", + + /* create */ + "ScriptColumn ", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/script-engraver.cc b/lily/script-engraver.cc index 72359defcf..d0d713bfc4 100644 --- a/lily/script-engraver.cc +++ b/lily/script-engraver.cc @@ -241,7 +241,15 @@ ADD_ACKNOWLEDGER (Script_engraver, note_column); ADD_ACKNOWLEDGER (Script_engraver, stem_tremolo); ADD_TRANSLATOR (Script_engraver, - /* doc */ "Handles note scripted articulations.", - /* create */ "Script", - /* read */ "scriptDefinitions", - /* write */ ""); + /* doc */ + "Handle note scripted articulations.", + + /* create */ + "Script ", + + /* read */ + "scriptDefinitions ", + + /* write */ + "" + ); diff --git a/lily/script-row-engraver.cc b/lily/script-row-engraver.cc index 0e08362c58..38bf0bdf7c 100644 --- a/lily/script-row-engraver.cc +++ b/lily/script-row-engraver.cc @@ -85,7 +85,15 @@ Script_row_engraver::process_acknowledged () ADD_ACKNOWLEDGER (Script_row_engraver, accidental_placement); ADD_ACKNOWLEDGER (Script_row_engraver, side_position); ADD_TRANSLATOR (Script_row_engraver, - /* doc */ "Determine order in horizontal side position elements. ", - /* create */ "ScriptRow ", - /* read */ "", - /* write */ ""); + /* doc */ + "Determine order in horizontal side position elements.", + + /* create */ + "ScriptRow ", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/separating-line-group-engraver.cc b/lily/separating-line-group-engraver.cc index aafb49399e..954c5834d4 100644 --- a/lily/separating-line-group-engraver.cc +++ b/lily/separating-line-group-engraver.cc @@ -146,9 +146,15 @@ ADD_ACKNOWLEDGER (Separating_line_group_engraver, item); ADD_ACKNOWLEDGER (Separating_line_group_engraver, break_aligned); ADD_TRANSLATOR (Separating_line_group_engraver, - /* doc */ "Generates objects for computing spacing parameters.", + /* doc */ + "Generate objects for computing spacing parameters.", - /* create */ "StaffSpacing", - /* read */ "createSpacing", - /* write */ "hasStaffSpacing" + /* create */ + "StaffSpacing ", + + /* read */ + "createSpacing ", + + /* write */ + "hasStaffSpacing " ); diff --git a/lily/slash-repeat-engraver.cc b/lily/slash-repeat-engraver.cc index f772e876fb..62f80c1619 100644 --- a/lily/slash-repeat-engraver.cc +++ b/lily/slash-repeat-engraver.cc @@ -68,7 +68,15 @@ Slash_repeat_engraver::process_music () } ADD_TRANSLATOR (Slash_repeat_engraver, - /* doc */ "Make beat repeats.", - /* create */ "RepeatSlash", - /* read */ "measureLength", - /* write */ ""); + /* doc */ + "Make beat repeats.", + + /* create */ + "RepeatSlash ", + + /* read */ + "measureLength ", + + /* write */ + "" + ); diff --git a/lily/slur-engraver.cc b/lily/slur-engraver.cc index 57068e6225..fae0aa3db4 100644 --- a/lily/slur-engraver.cc +++ b/lily/slur-engraver.cc @@ -224,10 +224,16 @@ ADD_ACKNOWLEDGER (Slur_engraver, text_script); ADD_ACKNOWLEDGER (Slur_engraver, tie); ADD_ACKNOWLEDGER (Slur_engraver, tuplet_number); ADD_TRANSLATOR (Slur_engraver, - /* doc */ "Build slur grobs from slur events", - /* create */ "Slur", + /* doc */ + "Build slur grobs from slur events.", + + /* create */ + "Slur ", + /* read */ "slurMelismaBusy " "doubleSlurs ", - /* write */ ""); + /* write */ + "" + ); diff --git a/lily/slur-performer.cc b/lily/slur-performer.cc index 20d5d5a4fc..01fdb32615 100644 --- a/lily/slur-performer.cc +++ b/lily/slur-performer.cc @@ -85,5 +85,15 @@ Slur_performer::listen_slur (Stream_event *ev) } ADD_TRANSLATOR (Slur_performer, - "", "", - "", ""); + /* doc */ + "", + + /* create */ + "", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/spacing-engraver.cc b/lily/spacing-engraver.cc index fae9a120c7..6c79a92980 100644 --- a/lily/spacing-engraver.cc +++ b/lily/spacing-engraver.cc @@ -262,13 +262,18 @@ ADD_ACKNOWLEDGER (Spacing_engraver, rhythmic_head); ADD_ACKNOWLEDGER (Spacing_engraver, rhythmic_grob); ADD_TRANSLATOR (Spacing_engraver, - "make a SpacingSpanner and do " - "bookkeeping of shortest starting and playing notes ", + /* doc */ + "Make a @code{SpacingSpanner} and do bookkeeping of shortest " + "starting and playing notes.", + + /* create */ + "SpacingSpanner ", - /* create */ "SpacingSpanner", /* read */ "currentMusicalColumn " "currentCommandColumn " - "proportionalNotationDuration", + "proportionalNotationDuration ", - /* write */ ""); + /* write */ + "" + ); diff --git a/lily/span-arpeggio-engraver.cc b/lily/span-arpeggio-engraver.cc index fa2e91eec3..3188e83e28 100644 --- a/lily/span-arpeggio-engraver.cc +++ b/lily/span-arpeggio-engraver.cc @@ -103,7 +103,15 @@ Span_arpeggio_engraver::stop_translation_timestep () ADD_ACKNOWLEDGER (Span_arpeggio_engraver, arpeggio); ADD_TRANSLATOR (Span_arpeggio_engraver, - /* doc */ "", - /* create */ "Arpeggio", - /* read */ "connectArpeggios", - /* write */ ""); + /* doc */ + "Make arpeggios that span multiple staves.", + + /* create */ + "Arpeggio ", + + /* read */ + "connectArpeggios ", + + /* write */ + "" + ); diff --git a/lily/span-bar-engraver.cc b/lily/span-bar-engraver.cc index a1618a2756..a135e6abb1 100644 --- a/lily/span-bar-engraver.cc +++ b/lily/span-bar-engraver.cc @@ -76,8 +76,16 @@ Span_bar_engraver::stop_translation_timestep () ADD_ACKNOWLEDGER (Span_bar_engraver, bar_line); ADD_TRANSLATOR (Span_bar_engraver, - /* doc */ "This engraver makes cross-staff barlines: It catches all normal " - "bar lines, and draws a single span-bar across them.", - /* create */ "SpanBar", - /* read */ "", - /* write */ ""); + /* doc */ + "Make cross-staff bar lines: It catches all normal bar lines " + "and draws a single span bar across them.", + + /* create */ + "SpanBar ", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/spanner-break-forbid-engraver.cc b/lily/spanner-break-forbid-engraver.cc index 41d061c058..cd81a8d147 100644 --- a/lily/spanner-break-forbid-engraver.cc +++ b/lily/spanner-break-forbid-engraver.cc @@ -62,7 +62,15 @@ Spanner_break_forbid_engraver::Spanner_break_forbid_engraver () ADD_END_ACKNOWLEDGER (Spanner_break_forbid_engraver, unbreakable_spanner); ADD_ACKNOWLEDGER (Spanner_break_forbid_engraver, unbreakable_spanner); ADD_TRANSLATOR (Spanner_break_forbid_engraver, - /* doc */ "Forbid breaks in certain spanners", - /* create */ "", - /* read */ "", - /* write */ ""); + /* doc */ + "Forbid breaks in certain spanners.", + + /* create */ + "", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/staff-collecting-engraver.cc b/lily/staff-collecting-engraver.cc index 72b1bf51cd..6e4c5ad809 100644 --- a/lily/staff-collecting-engraver.cc +++ b/lily/staff-collecting-engraver.cc @@ -47,8 +47,15 @@ ADD_ACKNOWLEDGER (Staff_collecting_engraver, staff_symbol); ADD_END_ACKNOWLEDGER (Staff_collecting_engraver, staff_symbol); ADD_TRANSLATOR (Staff_collecting_engraver, - /* doc */ "Maintain the stavesFound variable", + /* doc */ + "Maintain the @code{stavesFound} variable.", - /* create */ "", - /* read */ "stavesFound", - /* write */ "stavesFound"); + /* create */ + "", + + /* read */ + "stavesFound ", + + /* write */ + "stavesFound " + ); diff --git a/lily/staff-performer.cc b/lily/staff-performer.cc index d0ad8e1e05..0b138701c3 100644 --- a/lily/staff-performer.cc +++ b/lily/staff-performer.cc @@ -42,8 +42,18 @@ private: #include "translator.icc" -ADD_TRANSLATOR (Staff_performer, "", "", - "", ""); +ADD_TRANSLATOR (Staff_performer, + /* doc */ + "", + + /* create */ + "", + + /* read */ + "", + + /* write */ + ""); Staff_performer::Staff_performer () { diff --git a/lily/staff-symbol-engraver.cc b/lily/staff-symbol-engraver.cc index 0b0d212a90..5d5acd9a42 100644 --- a/lily/staff-symbol-engraver.cc +++ b/lily/staff-symbol-engraver.cc @@ -148,8 +148,15 @@ Staff_symbol_engraver::acknowledge_grob (Grob_info s) ADD_ACKNOWLEDGER (Staff_symbol_engraver, grob); ADD_TRANSLATOR (Staff_symbol_engraver, - /* doc */ "Create the constellation of five (default) " - "staff lines.", - /* create */ "StaffSymbol", - /* read */ "", - /* write */ ""); + /* doc */ + "Create the constellation of five (default) staff lines.", + + /* create */ + "StaffSymbol ", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/stanza-number-align-engraver.cc b/lily/stanza-number-align-engraver.cc index 2e862dc269..e2b5f4100c 100644 --- a/lily/stanza-number-align-engraver.cc +++ b/lily/stanza-number-align-engraver.cc @@ -62,8 +62,16 @@ ADD_ACKNOWLEDGER (Stanza_number_align_engraver, lyric_syllable); ADD_ACKNOWLEDGER (Stanza_number_align_engraver, stanza_number); ADD_TRANSLATOR (Stanza_number_align_engraver, - "This engraver ensures that stanza numbers are neatly aligned. ", + /* doc */ + "This engraver ensures that stanza numbers are neatly " + "aligned.", + + /* create */ "", + + /* read */ "", + + /* write */ ""); diff --git a/lily/stanza-number-engraver.cc b/lily/stanza-number-engraver.cc index 41759ff12a..78476d9cc6 100644 --- a/lily/stanza-number-engraver.cc +++ b/lily/stanza-number-engraver.cc @@ -74,7 +74,15 @@ Stanza_number_engraver::stop_translation_timestep () ADD_ACKNOWLEDGER (Stanza_number_engraver, lyric_syllable); ADD_TRANSLATOR (Stanza_number_engraver, - /* doc */ "", - /* create */ "StanzaNumber", - /* read */ "stanza", - /* write */ ""); + /* doc */ + "Engrave stanza numbers.", + + /* create */ + "StanzaNumber ", + + /* read */ + "stanza ", + + /* write */ + "" + ); diff --git a/lily/stem-engraver.cc b/lily/stem-engraver.cc index 164bedff36..0e52e18a94 100644 --- a/lily/stem-engraver.cc +++ b/lily/stem-engraver.cc @@ -168,9 +168,9 @@ Stem_engraver::listen_tremolo (Stream_event *ev) ADD_ACKNOWLEDGER (Stem_engraver, rhythmic_head); ADD_TRANSLATOR (Stem_engraver, - - /* doc */ "Create stems and single-stem tremolos. It also works together with " - "the beam engraver for overriding beaming.", + /* doc */ + "Create stems and single-stem tremolos. It also works " + "together with the beam engraver for overriding beaming.", /* create */ "Stem " @@ -181,4 +181,6 @@ ADD_TRANSLATOR (Stem_engraver, "stemLeftBeamCount " "stemRightBeamCount ", - /* write */ ""); + /* write */ + "" + ); diff --git a/lily/string-number-engraver.cc b/lily/string-number-engraver.cc index 9164fe74bf..4b3c39e590 100644 --- a/lily/string-number-engraver.cc +++ b/lily/string-number-engraver.cc @@ -35,11 +35,18 @@ String_number_engraver::String_number_engraver () #include "translator.icc" ADD_TRANSLATOR (String_number_engraver, - /* doc */ "Swallow string-number-events - the purpose of this engraver is to" - " process tab for normal notation. To provent warnings for unprocessed " - " string-number-event to obscure real error messages, this engraver " - " swallows them all.", - - /* create */ "", - /* read */ "", - /* write */ ""); + /* doc */ + "Swallow string number events. The purpose of this engraver " + "is to process tablatures for normal notation. To provent " + "warnings for unprocessed string number events to obscure " + "real error messages, this engraver swallows them all.", + + /* create */ + "", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/swallow-engraver.cc b/lily/swallow-engraver.cc index 7d0c851ab0..cb42085950 100644 --- a/lily/swallow-engraver.cc +++ b/lily/swallow-engraver.cc @@ -29,8 +29,17 @@ Swallow_engraver::Swallow_engraver () #include "translator.icc" ADD_TRANSLATOR (Swallow_engraver, - /* doc */ "This engraver swallows everything given to it silently. The purpose of " - "this is to prevent spurious \"event junked\" warnings.", - /* create */ "", - /* read */ "", - /* write */ ""); + /* doc */ + "This engraver swallows everything given to it silently. " + "The purpose of this is to prevent spurious @q{event junked} " + "warnings.", + + /* create */ + "", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/swallow-perf.cc b/lily/swallow-perf.cc index 2bd42dfa5c..907b41de17 100644 --- a/lily/swallow-perf.cc +++ b/lily/swallow-perf.cc @@ -32,7 +32,15 @@ Swallow_performer::Swallow_performer () #include "translator.icc" ADD_TRANSLATOR (Swallow_performer, - /* doc */ "", - /* create */ "", - /* read */ "", - /* write */ ""); + /* doc */ + "", + + /* create */ + "", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/system-start-delimiter-engraver.cc b/lily/system-start-delimiter-engraver.cc index ee4bf6ef11..0eebd7f15e 100644 --- a/lily/system-start-delimiter-engraver.cc +++ b/lily/system-start-delimiter-engraver.cc @@ -250,14 +250,23 @@ ADD_ACKNOWLEDGER (System_start_delimiter_engraver, system_start_delimiter); ADD_ACKNOWLEDGER (System_start_delimiter_engraver, system_start_text); ADD_TRANSLATOR (System_start_delimiter_engraver, - /* doc */ "Creates a system start delimiter (ie. SystemStart@{Bar, Brace, Bracket@} spanner", - /* create */ "SystemStartSquare " + /* doc */ + "Create a system start delimiter (i.e., a " + "@code{SystemStartBar}, @code{SystemStartBrace}, " + "@code{SystemStartBracket} or @code{SystemStartSquare} " + "spanner).", + + /* create */ + "SystemStartSquare " "SystemStartBrace " "SystemStartBracket " - "SystemStartBar", + "SystemStartBar ", + /* read */ "systemStartDelimiter " "systemStartDelimiterHierarchy " - "currentCommandColumn", + "currentCommandColumn ", - /* write */ ""); + /* write */ + "" + ); diff --git a/lily/tab-harmonic-engraver.cc b/lily/tab-harmonic-engraver.cc index 1faa114144..10fc13f579 100644 --- a/lily/tab-harmonic-engraver.cc +++ b/lily/tab-harmonic-engraver.cc @@ -64,10 +64,16 @@ Tab_harmonic_engraver::acknowledge_note_head (Grob_info info) ADD_ACKNOWLEDGER (Tab_harmonic_engraver, note_head); ADD_TRANSLATOR (Tab_harmonic_engraver, - /* doc */ "Parenthesize objects whose music cause has the @code{parenthesize} " - "property.", + /* doc */ + "In a tablature, parenthesize objects whose music cause has " + "the @code{parenthesize} property.", /* create */ "HarmonicParenthesesItem ", - /* read */ "", - /* write */ ""); + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/tab-note-heads-engraver.cc b/lily/tab-note-heads-engraver.cc index 045e3f3b6d..4c64432757 100644 --- a/lily/tab-note-heads-engraver.cc +++ b/lily/tab-note-heads-engraver.cc @@ -148,10 +148,12 @@ Tab_note_heads_engraver::stop_translation_timestep () } ADD_TRANSLATOR (Tab_note_heads_engraver, - /* doc */ "Generate one or more tablature noteheads from event of type NoteEvent.", + /* doc */ + "Generate one or more tablature noteheads from event of type " + "@code{NoteEvent}.", + /* create */ - "TabNoteHead " - , + "TabNoteHead ", /* read */ "middleCPosition " @@ -161,5 +163,6 @@ ADD_TRANSLATOR (Tab_note_heads_engraver, "highStringOne " "stringOneTopmost ", - /* write */ ""); + /* write */ "" + ); diff --git a/lily/tab-staff-symbol-engraver.cc b/lily/tab-staff-symbol-engraver.cc index f103e0f6b4..1a4ff8a298 100644 --- a/lily/tab-staff-symbol-engraver.cc +++ b/lily/tab-staff-symbol-engraver.cc @@ -34,9 +34,15 @@ Tab_staff_symbol_engraver::Tab_staff_symbol_engraver () ADD_ACKNOWLEDGER (Tab_staff_symbol_engraver, staff_symbol); ADD_TRANSLATOR (Tab_staff_symbol_engraver, /* doc */ - "Create a staff-symbol, but look at " - "stringTunings for the number of lines. " - , - /* create */ "StaffSymbol", - /* read */ "stringTunings", - /* write */ ""); + "Create a tablature staff symbol, but look at " + "@code{stringTunings} for the number of lines.", + + /* create */ + "StaffSymbol ", + + /* read */ + "stringTunings ", + + /* write */ + "" + ); diff --git a/lily/tempo-performer.cc b/lily/tempo-performer.cc index ac537891ef..d7975c5719 100644 --- a/lily/tempo-performer.cc +++ b/lily/tempo-performer.cc @@ -74,6 +74,16 @@ Tempo_performer::stop_translation_timestep () } } -ADD_TRANSLATOR (Tempo_performer, "", "", +ADD_TRANSLATOR (Tempo_performer, + /* doc */ + "", + + /* create */ + "", + + /* read */ "tempoWholesPerMinute ", - ""); + + /* write */ + "" + ); diff --git a/lily/text-engraver.cc b/lily/text-engraver.cc index 14f519ec85..90376d2a62 100644 --- a/lily/text-engraver.cc +++ b/lily/text-engraver.cc @@ -83,7 +83,15 @@ Text_engraver::Text_engraver () } ADD_TRANSLATOR (Text_engraver, - /* doc */ "Create text-scripts", - /* create */ "TextScript", - /* read */ "", - /* write */ ""); + /* doc */ + "Create text scripts.", + + /* create */ + "TextScript ", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/text-spanner-engraver.cc b/lily/text-spanner-engraver.cc index cb7b850013..fb6c90d81f 100644 --- a/lily/text-spanner-engraver.cc +++ b/lily/text-spanner-engraver.cc @@ -145,10 +145,13 @@ ADD_ACKNOWLEDGER (Text_spanner_engraver, note_column); ADD_TRANSLATOR (Text_spanner_engraver, /* doc */ "Create text spanner from an event.", + /* create */ "TextSpanner ", + /* read */ "", + /* write */ "" ); diff --git a/lily/tie-engraver.cc b/lily/tie-engraver.cc index cf525dc7b9..123d6aad4f 100644 --- a/lily/tie-engraver.cc +++ b/lily/tie-engraver.cc @@ -279,9 +279,16 @@ Tie_engraver::typeset_tie (Grob *her) ADD_ACKNOWLEDGER (Tie_engraver, note_head); ADD_TRANSLATOR (Tie_engraver, - /* doc */ "Generate ties between noteheads of equal pitch.", + /* doc */ + "Generate ties between note heads of equal pitch.", + /* create */ "Tie " "TieColumn ", - /* read */ "tieWaitForNote", - /* write */ "tieMelismaBusy"); + + /* read */ + "tieWaitForNote ", + + /* write */ + "tieMelismaBusy " + ); diff --git a/lily/tie-performer.cc b/lily/tie-performer.cc index 2fe3df0733..d6cd7628a0 100644 --- a/lily/tie-performer.cc +++ b/lily/tie-performer.cc @@ -110,7 +110,15 @@ Tie_performer::stop_translation_timestep () } ADD_TRANSLATOR (Tie_performer, - /* doc */ "Generate ties between noteheads of equal pitch.", - /* create */ "", - /* read */ "tieMelismaBusy", - /* write */ ""); + /* doc */ + "Generate ties between note heads of equal pitch.", + + /* create */ + "", + + /* read */ + "tieMelismaBusy", + + /* write */ + "" + ); diff --git a/lily/time-signature-engraver.cc b/lily/time-signature-engraver.cc index 5e23c5e3fe..d72ba64645 100644 --- a/lily/time-signature-engraver.cc +++ b/lily/time-signature-engraver.cc @@ -86,13 +86,17 @@ Time_signature_engraver::stop_translation_timestep () #include "translator.icc" ADD_TRANSLATOR (Time_signature_engraver, - /* doc */ "Create a @ref{TimeSignature} whenever @code{timeSignatureFraction} changes", + /* doc */ + "Create a @ref{TimeSignature} whenever " + "@code{timeSignatureFraction} changes.", + /* create */ "TimeSignature ", /* read */ "implicitTimeSignatureVisibility " - "timeSignatureFraction " + "timeSignatureFraction ", - , - /* write */ ""); + /* write */ + "" + ); diff --git a/lily/time-signature-performer.cc b/lily/time-signature-performer.cc index 3e57a2c02c..2401c2f771 100644 --- a/lily/time-signature-performer.cc +++ b/lily/time-signature-performer.cc @@ -70,4 +70,16 @@ Time_signature_performer::stop_translation_timestep () #include "translator.icc" -ADD_TRANSLATOR (Time_signature_performer, "", "", "", ""); +ADD_TRANSLATOR (Time_signature_performer, + /* doc */ + "", + + /* create */ + "", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/timing-translator.cc b/lily/timing-translator.cc index ee609a4db0..a813957d04 100644 --- a/lily/timing-translator.cc +++ b/lily/timing-translator.cc @@ -124,21 +124,23 @@ Timing_translator::start_translation_timestep () #include "translator.icc" ADD_TRANSLATOR (Timing_translator, - "This engraver adds the alias " - "@code{Timing} to its containing context." - "Responsible for synchronizing timing information from staves. " - "Normally in @code{Score}. In order to create polyrhythmic music, " - "this engraver should be removed from @code{Score} and placed in " - "@code{Staff}. " - "\n\nThis engraver adds the alias @code{Timing} to its containing context.", - + /* doc */ + "This engraver adds the alias @code{Timing} to its containing " + "context. Responsible for synchronizing timing information " + "from staves. Normally in @code{Score}. In order to create " + "polyrhythmic music, this engraver should be removed from " + "@code{Score} and placed in @code{Staff}.", + + /* create */ "", + /* read */ "internalBarNumber " "currentBarNumber " "measureLength " "measurePosition ", + /* write */ "internalBarNumber " "currentBarNumber " "measurePosition " diff --git a/lily/translator.cc b/lily/translator.cc index d0ed1e5213..e4cb27d3b7 100644 --- a/lily/translator.cc +++ b/lily/translator.cc @@ -356,7 +356,15 @@ internal_event_assignment (Stream_event **old_ev, Stream_event *new_ev, const ch } ADD_TRANSLATOR (Translator, - "Base class. Not instantiated.", + /* doc */ + "Base class. Not instantiated.", + + /* create */ "", + + /* read */ "", - ""); + + /* write */ + "" + ); diff --git a/lily/trill-spanner-engraver.cc b/lily/trill-spanner-engraver.cc index 1f9d4cf0dc..6f5f28beb7 100644 --- a/lily/trill-spanner-engraver.cc +++ b/lily/trill-spanner-engraver.cc @@ -148,8 +148,15 @@ Trill_spanner_engraver::finalize () ADD_ACKNOWLEDGER (Trill_spanner_engraver, note_column); ADD_TRANSLATOR (Trill_spanner_engraver, - /* doc */ "Create trill spanner from an event.", + /* doc */ + "Create trill spanner from an event.", + /* create */ "TrillSpanner ", - /* read */ "", - /* write */ ""); + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/tuplet-engraver.cc b/lily/tuplet-engraver.cc index 7d97443e1d..478469a1e2 100644 --- a/lily/tuplet-engraver.cc +++ b/lily/tuplet-engraver.cc @@ -219,14 +219,17 @@ Tuplet_engraver::Tuplet_engraver () ADD_ACKNOWLEDGER (Tuplet_engraver, note_column); ADD_TRANSLATOR (Tuplet_engraver, - /* doc */ "Catch tuplet events and generate appropriate bracket.", /* create */ "TupletBracket " "TupletNumber ", + /* read */ "tupletFullLength " "tupletFullLengthNote ", - /* write */ ""); + + /* write */ + "" + ); diff --git a/lily/tweak-engraver.cc b/lily/tweak-engraver.cc index e520f7d7c4..d5b44b3d97 100644 --- a/lily/tweak-engraver.cc +++ b/lily/tweak-engraver.cc @@ -40,8 +40,16 @@ Tweak_engraver::acknowledge_grob (Grob_info info) ADD_ACKNOWLEDGER (Tweak_engraver, grob); ADD_TRANSLATOR (Tweak_engraver, - /* doc */ "Read the @code{tweaks} property from the originating event, and set properties." , + /* doc */ + "Read the @code{tweaks} property from the originating event, " + "and set properties.", - /* create */ "", - /* read */ "", - /* write */ ""); + /* create */ + "", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/type-swallow-translator.cc b/lily/type-swallow-translator.cc index 87510de0d4..7b66eaf302 100644 --- a/lily/type-swallow-translator.cc +++ b/lily/type-swallow-translator.cc @@ -34,18 +34,34 @@ Skip_event_swallow_translator::Skip_event_swallow_translator () } ADD_TRANSLATOR (Skip_event_swallow_translator, - "Swallow \\skip.", + /* doc */ + "Swallow @code{\\skip}.", + + /* create */ "", + + /* read */ "", - ""); + + /* write */ + "" + ); Rest_swallow_translator::Rest_swallow_translator (){} ADD_TRANSLATOR (Rest_swallow_translator, - "Swallow rest", + /* doc */ + "Swallow rest.", + + /* create */ "", + + /* read */ "", - ""); + + /* write */ + "" + ); class Note_swallow_translator : public Translator { @@ -61,9 +77,16 @@ Note_swallow_translator::Note_swallow_translator () } ADD_TRANSLATOR (Note_swallow_translator, - "Swallow notes", + /* doc */ + "Swallow notes.", + + /* create */ "", + + /* read */ "", - ""); + /* write */ + "" + ); diff --git a/lily/vaticana-ligature-engraver.cc b/lily/vaticana-ligature-engraver.cc index b0f09c236e..ea13929e73 100644 --- a/lily/vaticana-ligature-engraver.cc +++ b/lily/vaticana-ligature-engraver.cc @@ -726,7 +726,16 @@ Vaticana_ligature_engraver::transform_heads (Spanner *ligature, ADD_ACKNOWLEDGER (Vaticana_ligature_engraver, rest); ADD_ACKNOWLEDGER (Vaticana_ligature_engraver, note_head); ADD_TRANSLATOR (Vaticana_ligature_engraver, - /* doc */ "Handles ligatures by glueing special ligature heads together.", - /* create */ "VaticanaLigature DotColumn", - /* read */ "", - /* write */ ""); + /* doc */ + "Handle ligatures by glueing special ligature heads together.", + + /* create */ + "VaticanaLigature " + "DotColumn ", + + /* read */ + "", + + /* write */ + "" + ); diff --git a/lily/vertical-align-engraver.cc b/lily/vertical-align-engraver.cc index f3cc50d6cf..347b982b18 100644 --- a/lily/vertical-align-engraver.cc +++ b/lily/vertical-align-engraver.cc @@ -37,14 +37,20 @@ protected: ADD_ACKNOWLEDGER (Vertical_align_engraver, axis_group); ADD_TRANSLATOR (Vertical_align_engraver, - "Catch groups (staves, lyrics lines, etc.) and stack " - "them vertically.", - /* create */ "VerticalAlignment", + /* doc */ + "Catch groups (staves, lyrics lines, etc.) and stack them " + "vertically.", + + /* create */ + "VerticalAlignment ", + /* read */ "alignAboveContext " "alignBelowContext ", - /* write */ ""); + /* write */ + "" + ); Vertical_align_engraver::Vertical_align_engraver () { diff --git a/lily/vertically-spaced-context-engraver.cc b/lily/vertically-spaced-context-engraver.cc index 2912c0a479..8a4b206329 100644 --- a/lily/vertically-spaced-context-engraver.cc +++ b/lily/vertically-spaced-context-engraver.cc @@ -56,7 +56,15 @@ Vertically_spaced_contexts_engraver::acknowledge_vertically_spaceable (Grob_info ADD_ACKNOWLEDGER (Vertically_spaced_contexts_engraver, vertically_spaceable); ADD_TRANSLATOR (Vertically_spaced_contexts_engraver, - /* doc */ "", - /* create */ "", - /* read */ "verticallySpacedContexts", - /* write */ "verticallySpacedContexts"); + /* doc */ + "", + + /* create */ + "", + + /* read */ + "verticallySpacedContexts ", + + /* write */ + "verticallySpacedContexts " + ); diff --git a/lily/volta-engraver.cc b/lily/volta-engraver.cc index 279eb5eb64..708b535d26 100644 --- a/lily/volta-engraver.cc +++ b/lily/volta-engraver.cc @@ -181,7 +181,18 @@ Volta_engraver::stop_translation_timestep () */ ADD_ACKNOWLEDGER (Volta_engraver, bar_line); ADD_TRANSLATOR (Volta_engraver, - /* doc */ "Make volta brackets.", - /* create */ "VoltaBracket VoltaBracketSpanner", - /* read */ "repeatCommands voltaSpannerDuration stavesFound", - /* write */ ""); + /* doc */ + "Make volta brackets.", + + /* create */ + "VoltaBracket " + "VoltaBracketSpanner ", + + /* read */ + "repeatCommands " + "voltaSpannerDuration " + "stavesFound ", + + /* write */ + "" + ); -- 2.39.2