]> git.donarmstrong.com Git - lilypond.git/commitdiff
ADD_TRANSLATOR: Formatting, fix typos, add some doc strings.
authorWerner Lemberg <wl@gnu.org>
Fri, 14 Mar 2008 07:57:30 +0000 (08:57 +0100)
committerWerner Lemberg <wl@gnu.org>
Fri, 14 Mar 2008 07:57:30 +0000 (08:57 +0100)
127 files changed:
lily/ambitus-engraver.cc
lily/arpeggio-engraver.cc
lily/auto-beam-engraver.cc
lily/axis-group-engraver.cc
lily/balloon-engraver.cc
lily/bar-engraver.cc
lily/bar-number-engraver.cc
lily/beam-engraver.cc
lily/beam-performer.cc
lily/bend-engraver.cc
lily/break-align-engraver.cc
lily/breathing-sign-engraver.cc
lily/chord-name-engraver.cc
lily/chord-tremolo-engraver.cc
lily/clef-engraver.cc
lily/cluster-engraver.cc
lily/collision-engraver.cc
lily/completion-note-heads-engraver.cc
lily/control-track-performer.cc
lily/custos-engraver.cc
lily/default-bar-line-engraver.cc
lily/dot-column-engraver.cc
lily/dots-engraver.cc
lily/drum-note-engraver.cc
lily/drum-note-performer.cc
lily/dynamic-engraver.cc
lily/dynamic-performer.cc
lily/engraver-group.cc
lily/engraver.cc
lily/extender-engraver.cc
lily/figured-bass-engraver.cc
lily/figured-bass-position-engraver.cc
lily/fingering-engraver.cc
lily/font-size-engraver.cc
lily/forbid-break-engraver.cc
lily/fretboard-engraver.cc
lily/glissando-engraver.cc
lily/grace-engraver.cc
lily/grace-spacing-engraver.cc
lily/grid-line-span-engraver.cc
lily/grid-point-engraver.cc
lily/grob-pq-engraver.cc
lily/hara-kiri-engraver.cc
lily/horizontal-bracket-engraver.cc
lily/hyphen-engraver.cc
lily/instrument-name-engraver.cc
lily/instrument-switch-engraver.cc
lily/key-engraver.cc
lily/key-performer.cc
lily/laissez-vibrer-engraver.cc
lily/ledger-line-engraver.cc
lily/ligature-bracket-engraver.cc
lily/lyric-engraver.cc
lily/lyric-performer.cc
lily/mark-engraver.cc
lily/measure-grouping-engraver.cc
lily/melody-engraver.cc
lily/mensural-ligature-engraver.cc
lily/metronome-engraver.cc
lily/multi-measure-rest-engraver.cc
lily/new-fingering-engraver.cc
lily/note-head-line-engraver.cc
lily/note-heads-engraver.cc
lily/note-name-engraver.cc
lily/note-performer.cc
lily/note-spacing-engraver.cc
lily/ottava-engraver.cc
lily/output-property-engraver.cc
lily/page-turn-engraver.cc
lily/paper-column-engraver.cc
lily/parenthesis-engraver.cc
lily/part-combine-engraver.cc
lily/performer-group.cc
lily/phrasing-slur-engraver.cc
lily/piano-pedal-align-engraver.cc
lily/piano-pedal-engraver.cc
lily/piano-pedal-performer.cc
lily/pitch-squash-engraver.cc
lily/pitched-trill-engraver.cc
lily/repeat-acknowledge-engraver.cc
lily/repeat-tie-engraver.cc
lily/rest-collision-engraver.cc
lily/rest-engraver.cc
lily/rhythmic-column-engraver.cc
lily/score-engraver.cc
lily/score-performer.cc
lily/script-column-engraver.cc
lily/script-engraver.cc
lily/script-row-engraver.cc
lily/separating-line-group-engraver.cc
lily/slash-repeat-engraver.cc
lily/slur-engraver.cc
lily/slur-performer.cc
lily/spacing-engraver.cc
lily/span-arpeggio-engraver.cc
lily/span-bar-engraver.cc
lily/spanner-break-forbid-engraver.cc
lily/staff-collecting-engraver.cc
lily/staff-performer.cc
lily/staff-symbol-engraver.cc
lily/stanza-number-align-engraver.cc
lily/stanza-number-engraver.cc
lily/stem-engraver.cc
lily/string-number-engraver.cc
lily/swallow-engraver.cc
lily/swallow-perf.cc
lily/system-start-delimiter-engraver.cc
lily/tab-harmonic-engraver.cc
lily/tab-note-heads-engraver.cc
lily/tab-staff-symbol-engraver.cc
lily/tempo-performer.cc
lily/text-engraver.cc
lily/text-spanner-engraver.cc
lily/tie-engraver.cc
lily/tie-performer.cc
lily/time-signature-engraver.cc
lily/time-signature-performer.cc
lily/timing-translator.cc
lily/translator.cc
lily/trill-spanner-engraver.cc
lily/tuplet-engraver.cc
lily/tweak-engraver.cc
lily/type-swallow-translator.cc
lily/vaticana-ligature-engraver.cc
lily/vertical-align-engraver.cc
lily/vertically-spaced-context-engraver.cc
lily/volta-engraver.cc

index e00ea133dddac7055db68426c2a0a0fe9ffc8d5f..c316716a8b01c90cd4bc647e1655ad15b8fd3c03 100644 (file)
@@ -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 */
+               ""
+               );
index 399823408f88d501a246a97a3ae5cd54fa321ce2..6fa2f79c9d437d01d366f00118bbdf4938c7c2be 100644 (file)
@@ -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 */
+               ""
+               );
index a98b05f48d953384474d5e5996fb023062b02eb1..db6ef1baa06a35d65e70d51b20eb4fa5a9d5d61c 100644 (file)
@@ -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 */
+               ""
+               );
index 3d83349526d399449ec06cf26ff6e5024fab8730..15e26309ceb7db1b1b8ec73f7a272698ab68e08c 100644 (file)
@@ -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 */
+               ""
+               );
index b1497ef4038341109283bcd980ea8e4ab82f477e..27be4605310b3115030db608b5271ba6ce04becc 100644 (file)
@@ -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*/
+              ""
               );
index 2357c087b5dc425a3faa839c629cd6c4f9d9aee5..ac0afa37f2c8f0f086ce69ae552e48cb07a14fe1 100644 (file)
@@ -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 "
+               );
index 3693f97b3e286095f23a10cb94a38334d486432c..5c4bf82ab376f7ae607f18a344019de66ef5d196 100644 (file)
@@ -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 */
+               ""
+               );
index 90357c5264f0929718127e52518240d3597ac580..724485a3e036c257a1c630122042cd71dea64362 100644 (file)
@@ -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 */
+               ""
+               );
 
index 544dbfb3b128e6bad82de4c3d86bf1341d62f928..34a1a86482d89386f87337da7ca740bd5f0ebd3a 100644 (file)
@@ -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 */
+                ""
+                );
 
index 4f243dfc7371bbcb7f5447ea7f5fadd3a4a955c4..9f5602fef096ccde37a9a10fedb01aeb5116c0ab 100644 (file)
@@ -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 */
+               ""
+               );
index 8059200849770fcccc83500b5a00b35be19d9232..c02c298330d1040d316b897f33517bd5b0e96596 100644 (file)
@@ -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 */
+               ""
+               );
index 02d4c0942db29e882b9a8c543d01c3250241e1b3..9108be2a2feea4a6fe75906609b64423412c0af5 100644 (file)
@@ -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 */
+               ""
+               );
index 274e3ec3904cc71810bf2ba4bbe343d37d8c1296..649c1455be7fa2df1212fed7c8a5e9d6d481ae0a 100644 (file)
@@ -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 */
+               ""
+               );
index 805cb52554a864eb5e50bb8a71085314e492883d..10a47074ca57e48b0a37cc03835abcac6fd62f68 100644 (file)
@@ -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 */
+               ""
+               );
index 74992be97612d9373bd81c89063e05bb26503525..415fed1bf264ca92ee22ba40a2eed06ff2098318 100644 (file)
@@ -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 */
+               ""
+               );
index 898846e2d8db20e40be284aabfd1718f5e646992..ea40ba22858dbd61f1048ce2d44365710934915c 100644 (file)
@@ -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 */
+               ""
+               );
 
index 7bff5a8cd4a9d0cebbfddb04d17ba89b7efb9c82..79d66f6c127bd6c41da73cbbc7146fdaab3e0270 100644 (file)
@@ -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 */
+               ""
+               );
index cbee0b2f5d3b8c88dc00ce45ae31fd6b0f23a2bc..bba68859e0de837be701241578bb81d3e6965ca5 100644 (file)
@@ -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 */
+               ""
+               );
index 3275b467d531006f06bec4223b46aa1e9bc3211d..d1e677db63149a0cafca4b20c39483f444bc1a28 100644 (file)
@@ -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 */
+               ""
+               );
index 94bc4910ce24336c5260a91afea5a4edf57d8e3c..d0546bf65e3ee2749f4a6e0c240afd8088f9ab2d 100644 (file)
@@ -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 */
+               ""
+               );
index d96110e87bee5ad2bb2ff2a4c73012fe9fa87e79..5710b186f5b5f3d214fa1a43f210a2b36b4f44e1 100644 (file)
@@ -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 ()
 {
index 3f2982df746607dfc7d0a10aad4a4fecf0d5f676..2b50a738d4fde426bb5711668e396aeb94e9a1bd 100644 (file)
@@ -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 */
+               ""
+               );
index b59a8d9a41d65dc3a5c1d288c8f9f310b2eb0cf6..09b61310d2cc4e227ff6297694398795de7709c2 100644 (file)
@@ -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 */
+               ""
+               );
index 1db3e611f9c2f447a24e500fce59be412331b9a3..630c718ed670bf6960bfda3e72a036e38d877d52 100644 (file)
@@ -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 */
+               ""
+               );
 
index bb55ac2ef6a417c2eae20c369aa19b965ae0409c..b31727ebc7d528508863f5c970ae87c2e4cd5557 100644 (file)
@@ -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 */
+               ""
+               );
index f6e5911f2bf264e7d7efb941a1945f63eede0a45..e3171756eeca8bc2a59067415fb52f8610e34bf8 100644 (file)
@@ -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 */
+               ""
+               );
index 9b8f366843404336f72ea36da38b1714f85c28f1..e5a7f20069847c3f09b5127640ff7b8beb2b9ef1 100644 (file)
@@ -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 */
+               ""
+               );
index aaa2ed76250b50c2a8a0a7c9ad6859a3c37d4c9b..eaa025dd174517e2b9ed8d30162ee6ee0aaa3f02 100644 (file)
@@ -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
index 70a8bf512fb51ae71e1a3e05627c1b00e04027a7..c749be110a169b2319d68059070dbb7f5f2bf1de 100644 (file)
@@ -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 */
+               ""
+               );
 
index ced1f123ce2b0fd9ebefc5b62ada4b974d88d52c..77a9f7c9520f50f1c2f46c80586d03a866fde169 100644 (file)
@@ -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 */
+               ""
+               );
index a73cdf6bd8b845eacf044368c1c9e7f175a08252..32ad86a9eb7592fa42c428ee857f4a6d8399802c 100644 (file)
@@ -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 */
-               "");
+               ""
+               );
index ced3f7ef6e97787e445bd68e082d7dca2cec2003..8043640a2f5c91ed2d148bc1b861cf477dcc99bb 100644 (file)
@@ -145,5 +145,8 @@ ADD_TRANSLATOR (Figured_bass_position_engraver,
                "BassFigureAlignmentPositioning ",
 
                /* read */
-               " ",
-               /* write */ "");
+               "",
+
+               /* write */
+               ""
+               );
index 874771f77485b86ddf036f0426f6ef7ba512a19e..0c9426f0956b8b36ea4d1f3e1a04f5e329510200 100644 (file)
@@ -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 */
+               ""
+               );
index 39b36586bad1c58ef3c7efd25b3974f79cd7fdf5..d554545e2d8bcf6f3108e3766ee9699df25d2b3d 100644 (file)
@@ -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 */
+               ""
+               );
index c44bbb6012f300f058754c84e8ad50729f72c525..68bfbb6bb810d5c486769311124e5de13eb24a6a 100644 (file)
@@ -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 "
+               );
index d0ad15050f8d1b650df67bcbe47d0ae4592c84eb..71b7351bdae7de5fd788fe6f55e16c836d45d204 100644 (file)
@@ -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 */
+               ""
+               );
 
index 3a88ef888cda5a8d30c3bd782e7f3fb0701f582b..66afed64034ed9ca01d54f9dc76bb0074d3b4971 100644 (file)
@@ -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 */
+               ""
+               );
index 5be9307f08fe11dd8e967d334b5f7a68422ca8ed..2b02020f62314526d4b93ddec861cf3f5fd91622 100644 (file)
@@ -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 */
+               ""
+               );
index 689f76212f28e1e3b3c612e019352f9c760c3e11..d5ccc67a65628bd3d72eab0dd95b6443053afebb 100644 (file)
@@ -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 */
+               ""
+               );
index ede6afdf424337f1fd6645a8a939484e21de4cba..0026572c5795b7deed157c26c807837590c15a47 100644 (file)
@@ -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 */
+               ""
+               );
index 1a3641717b0d62e186f9e3436f25be08429ff4b8..ab4b6f6279398ffa4896e351759b86f75040b78e 100644 (file)
@@ -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 */
+               ""
+               );
 
index 7265d4634784033d37db85251d0858f11e8a52a9..0dd0d6e53381d2327ba081bde3a1e2c73d26aaeb 100644 (file)
@@ -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 "
+               );
index 79fbd11f9d74f3d8442a6b043c7a1f5ffeed235f..0661bf7e640ed124de4ff84127c231931f7a24b1 100644 (file)
@@ -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 */
+               ""
+               );
 
index d7e453da1f1323d8777ab649418c9bb00484f654..2dea7624545c0a308648a8cc1f8493052a36ff6c 100644 (file)
@@ -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 ()
 {
index 3e03d9b8e04199cd8fb42420ff23740282d081e9..a9ea53054e7e4b96f356bdc95a8b9c3f411dd97e 100644 (file)
@@ -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 */
+               ""
+               );
index d280913e53941da4a8c33486e373b71d79c12556..d35e065afb7459bf691acec9a7fcf4a9d0e4bc0a 100644 (file)
@@ -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 */
+               ""
+               );
index 2637fba441db31118cf194815415a7c430bc126c..91072976771a04263005314e29bdd6ca636aec2c 100644 (file)
@@ -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 */
+               ""
+               );
index 0b0a282064ec3b6bdb1dd03449f6507344b068ee..d3b7eb01ddada1c2d00b7888fef88ee16ed88eb7 100644 (file)
@@ -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 "
+               );
index 32f94a632ed1356aaa48394432237f901ce9d28c..8a12e9bcf5f00b325f3dca5945b56ebba346b6ee 100644 (file)
@@ -96,7 +96,15 @@ Key_performer::listen_key_change (Stream_event *ev)
 }
 
 ADD_TRANSLATOR (Key_performer,
+               /* doc */
                "",
+
+               /* create */
                "",
+
+               /* read */
                "",
-               "");
+
+               /* write */
+               ""
+               );
index a6a4bd0e2b98ed3ca226e43d3e144b966a854e46..efb0afbaa4315328708fa1bbf965195e3726fa67 100644 (file)
@@ -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 */
+               ""
+               );
index ecff48a7b86bcc457c9f41725a6b61caacd5126c..ea06ac0e19b701bf794a0d957a2bfff5c3522c12 100644 (file)
@@ -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 */
+               ""
+               );
index 9a4374f2caf198a769fe55c93dfd5b51cd90b20a..69c51dfb74f11948c07a6edc11d2fdf1e8b03368 100644 (file)
@@ -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 */
+               ""
+               );
index ce138390890eac3900854c84b0891f4fd98ce0a4..0aa5fe3c97baa474ef7156c9e041fbe5bd57e169 100644 (file)
@@ -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 */
+               ""
+               );
index 0d14a737d2b6bfa80cd3247a19f9f93338479187..d759d4603ab9a6adf7e23e0db8a107d7088c3722 100644 (file)
@@ -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 */
+               ""
+               );
index 8c0233c9095b6b93cdd3ca4186daad873682f024..1b7ed78c42f7354fbb818df46f43e578ec2cc15e 100644 (file)
@@ -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 */
+               ""
+               );
index 311448302ca8c2b5e549caca88c5dbf6cfbcf789..81d3c5584e7297b28938099c22710c6559f9d331 100644 (file)
@@ -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 */
-               "");
+               ""
+               );
index 9c0cb1d5fa86cb14c5a5f0269e26ed443a687d61..a39dda1c847d7a0d6d07972d7231c64e4f5a7e5e 100644 (file)
@@ -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 */
+               ""
+               );
                
index d45c90c7dc6f7f04d364c0301200f0abaad12b71..9271013d6ce915c45445e149dc55b014c9fe5e45 100644 (file)
@@ -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 */
+               ""
+               );
index 26f1ec9b910d49f1b5ce240c210ee6fb1c4b040c..b30fea183a5132dde6a9fc9e7e51049ef50e6c5c 100644 (file)
@@ -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 */
+               ""
+               );
index cf5f25a613f6099d70f76d91182a7b140694e5f1..d621652247d0dc5633ac1e586fb0b04c5928663c 100644 (file)
@@ -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 */
+               ""
+               );
index 1aaa6a04eb791b9ca3b925177eae53d2305ed6ef..546fa8d3f6c5f51f393a25037bf82297aed2f7f4 100644 (file)
@@ -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 */
+               ""
+               );
index aaf1304d29b4a2660c7e653ff10de2576f74027a..35698563a752877afb5d79237d6bed0234a63c85 100644 (file)
@@ -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 */
+               ""
+               );
index 7240d61d51e267ca9ad56a2976ba47cfd7e9ec90..173961cb08d73b4a4e22183877478c034e02d688 100644 (file)
@@ -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 */
+               ""
+               );
index 1aebfd3d84ade98ffc3f46cc634a799ebf2be3ab..1cf78ba5e9632e1b2419a2329c6b5d3c1e0df011 100644 (file)
@@ -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 */
+               ""
+               );
index 776061f6c6f1690ec9fc38eac13624b3c85effe3..435575da604b1b66eecf109cc0df4cf452c9e221 100644 (file)
@@ -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 ()
 {
index f1a8cbbf235e94940519126a42ad7233c2fcd914..23b0fcd79718e906f0967bf9a9b3d4b378891bd2 100644 (file)
@@ -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 */
+               ""
+               );
index 01bf1d85c6f4a38e1d9ef26e6925124b95ef6a6b..f1042877963d6b3eba29f0973cdb9f2b7f90b843 100644 (file)
@@ -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 */
+               ""
+               );
index e66faba789def2cd683e250bff19444ec82604f2..cbef4235a16da1ca50f9c75625c9ecd129146c4e 100644 (file)
@@ -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 */
-               "");
+               ""
+               );
index fbd7370bcc79fc945b6949301355e642b77e9900..02a437d863a60a366b9e2ce0875f31fd30878d12 100644 (file)
@@ -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 */
+                ""
                );
index 481ffd14645b049bb523a3d04d02b99f08282791..58fd467ae6422bbc25446f038d96ad47dd19412e 100644 (file)
@@ -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 "
index 10e3be740e8f55156af9cb877883d346cfd79ea0..5cfa3adb71de246aafe94286c522309759cd14dd 100644 (file)
@@ -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 */
+               ""
+               );
index b12eb19a5fe7a1aac6d29d2542a58428e7d75cfb..178a9176e40ab0dd7c88a774db01deea2138b93d 100644 (file)
@@ -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 */
+               ""
+               );
index 4b3270f4ee3ccb1b755310efdec79d9b70e1139c..32c22d13dacb5a638d9fd0d93968c83e85f1bfe6 100644 (file)
 #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)
index 10b767d615e17bf332b1e6fe7161a51d4177e9c6..b0ef2b2d74ab69a63aca41b1dc3e49692bbdf85e 100644 (file)
@@ -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 */
+               ""
+               );
index a7031fbb018cb1592cbc3d8d4c9a903cb0f0671b..c05f7fdc6e2327bb439d101c9d1565fd61b29202 100644 (file)
@@ -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 */
+               ""
+               );
index 703183b3c6d046c77f7431995318b01f0f9630b2..141ae8e3af4a1312f039d319592e89b57c3e4084 100644 (file)
@@ -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 */
+               ""
+               );
index 0c52377670e0e5efa8ee1ff5d0c089a7b464b5f1..323ee40cd372b450724c466498e0b12a8f0ef80a 100644 (file)
@@ -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 */
+               ""
+               );
index 8fd4d4e26d213f2eb6d4d6e9cadc4ddcf1432bcf..3a8cb7ea2947978fef4145208955d2a9fdb118b4 100644 (file)
@@ -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 */
+               ""
+               );
index daa3bee42c772b37f6e4e53f90fbd3e4e42b68a6..3104b48ce02b1ba3ad1b0224eb5de04edf2c3d79 100644 (file)
@@ -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 */
+               ""
+               );
index 3e3025556f88b31d9784a8c112db9a6bc1aca204..209c7d501731f791d9121338c9b2db9fabfc204f 100644 (file)
@@ -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 */
+               ""
+               );
index 1285848a32446b0417fdb79c5e60fdea28a56efa..832a584d41214805a67c5972d34cf2c75e6081ab 100644 (file)
@@ -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 */
+               ""
+               );
index d0704a10b50c28a04b57da7dcbd5908a86b4a169..ecc3164c7c5d8d4f6e2f5a7cb439b5aa1dd3b891 100644 (file)
@@ -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 */
+               ""
+               );
index e6e7ecb7dea588df79f98712c2d07f4bff58a3fc..13f8d70a89c646137cc311486d8e96cfa38847bd 100644 (file)
@@ -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 */
+               ""
+               );
index 827a6fb94ff2a621c6685d050a070085126f613b..b80f0de61bdaf8e650cc58752d3409136a45731a 100644 (file)
@@ -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 */
+               ""
+               );
index 8d66adf0dda003a785d0f101004e5fb41fcba728..746701722f28f5d281bd7082b59c5e3bb7b7203b 100644 (file)
@@ -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 */
-                     "");
+                     ""
+                     );
index 99d2f84967ee74f366ab5e0db653b199415bc99d..58043e06442845228728499339551706d86f10ea 100644 (file)
 #include "audio-item.hh"
 
 ADD_TRANSLATOR_GROUP (Score_performer,
-                     /* doc */ "",
-                     /* create */ "",
-                     /* read */ "",
-                     /* write */ "");
+                     /* doc */
+                     "",
+
+                     /* create */
+                     "",
+
+                     /* read */
+                     "",
+
+                     /* write */
+                     ""
+                     );
 
 Score_performer::Score_performer ()
 {
index 6a0211530de10dacd425f2776c61fb82f02bb69f..8a3a54327d2b0335a15b5fef2c8944a67a9d0fee 100644 (file)
@@ -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 */
+               ""
+               );
index 72359defcfe991be36187adcf5f99d591a6666d7..d0d713bfc495c4b2b6965e2ce04e4a78a4274717 100644 (file)
@@ -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 */
+               ""
+               );
index 0e08362c589725c774b33dce654d88f6c0d8ca54..38bf0bdf7ceec4136fdffe607781c8d93f9ccd39 100644 (file)
@@ -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 */
+               ""
+               );
index aafb49399e57c68e9ee2ad843536293296aedcba..954c5834d4ed22413a17205ac8653807777abacb 100644 (file)
@@ -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 "
                );
index f772e876fb508016c733726449b74812b957c508..62f80c1619c19616854952f678ea398815cf501e 100644 (file)
@@ -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 */
+               ""
+               );
index 57068e6225945da903f2a264840bc7124ded6f2a..fae0aa3db4ded54decb4656b70ed47b9dadebd77 100644 (file)
@@ -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 */
+               ""
+               );
index 20d5d5a4fc8b6ff3194493637960a67da84904e9..01fdb326153e0caf27c35da33e4dddb68fe304c4 100644 (file)
@@ -85,5 +85,15 @@ Slur_performer::listen_slur (Stream_event *ev)
 }
 
 ADD_TRANSLATOR (Slur_performer,
-               "", "",
-               "", "");
+               /* doc */
+               "",
+
+               /* create */
+               "",
+
+               /* read */
+               "",
+
+               /* write */
+               ""
+               );
index fae9a120c7b404d4511e27cb581d936b4d136724..6c79a92980471f0639ca16054315fefe2ce710b0 100644 (file)
@@ -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 */
+               ""
+               );
index fa2e91eec363d3c3b437ad2c20da41378bd22ed2..3188e83e286871814b806c006a577acde06bc1d6 100644 (file)
@@ -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 */
+               ""
+               );
index a1618a27567b863b6f65d4bfc73a02bc41ea25f0..a135e6abb1e60d0813faee57cd69838f3332d86b 100644 (file)
@@ -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 */
+               ""
+               );
index 41d061c058ce646c9c362584ab7de9795116c16d..cd81a8d147312247515c3738072a46b773763d4b 100644 (file)
@@ -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 */
+               ""
+               );
index 72b1bf51cd5a5d7cb95502e470e1e65da331faa6..6e4c5ad8098892e9f1a5bc936d67e52ce5e10d0b 100644 (file)
@@ -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 "
+               );
index d0ad8e1e05f1fca07b50ac20bf5f83da33d2f8ce..0b138701c391d30fb5ac89e63885bcfc4f9e6128 100644 (file)
@@ -42,8 +42,18 @@ private:
 
 #include "translator.icc"
 
-ADD_TRANSLATOR (Staff_performer, "", "",
-               "", "");
+ADD_TRANSLATOR (Staff_performer,
+               /* doc */
+               "",
+
+               /* create */
+               "",
+
+               /* read */
+               "",
+
+               /* write */
+               "");
 
 Staff_performer::Staff_performer ()
 {
index 0b0d212a90502006e121fca8c19d0b66d60002c5..5d5acd9a4285addc9213e70fe4b9d63c98d1394c 100644 (file)
@@ -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 */
+               ""
+               );
index 2e862dc269854da93dcdefc37cb12617b3efc820..e2b5f4100c78fc34e9864b6817c415fc96a4ee43 100644 (file)
@@ -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 */
                "");
 
index 41759ff12a90ac358a76effbbd6f2065326e3ff3..78476d9cc6da8aaeeba3162798e6b4fc59ddd488 100644 (file)
@@ -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 */
+               ""
+               );
index 164bedff3638676fc1a4d0e8eef8c3de1ca2ab7d..0e52e18a942032f0e1a836c7c3f757dd722ab7c6 100644 (file)
@@ -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 */
+               ""
+               );
index 9164fe74bfb22de6657cd86581200ab9c5ddfcf9..4b3c39e590c5ddeced04e77ee8f38d184b89b5ff 100644 (file)
@@ -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 */
+               ""
+               );
index 7d0c851ab0627d80090556a7c024725b3582238c..cb42085950a1b3d10c801c4035a191398bf27dfb 100644 (file)
@@ -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 */
+               ""
+               );
index 2bd42dfa5cb44ea8cb69098b2895d7e98cc36dd8..907b41de171e75e701fa1f1289f7c62441278af4 100644 (file)
@@ -32,7 +32,15 @@ Swallow_performer::Swallow_performer ()
 #include "translator.icc"
 
 ADD_TRANSLATOR (Swallow_performer,
-               /* doc */ "",
-               /* create */ "",
-               /* read */ "",
-               /* write */ "");
+               /* doc */
+               "",
+
+               /* create */
+               "",
+
+               /* read */
+               "",
+
+               /* write */
+               ""
+               );
index ee4bf6ef114a5265cbb595e91361c6c09647988b..0eebd7f15e044a6c2e63722d04f8f800fc0d2a6a 100644 (file)
@@ -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 */
+               ""
+               );
index 1faa1141444fe76e00e128ee6bd93579151890fc..10fc13f57964f20bc867b562fd4345ff20d533da 100644 (file)
@@ -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 */
+               ""
+               );
index 045e3f3b6dfabb45c5c42ac349777f5311fdfe19..4c6443275760d84fd2b307f727fada980202a2df 100644 (file)
@@ -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 */ ""
+               );
 
index f103e0f6b40cae754c74f9fc4c4c0acc9344a9aa..1a4ff8a298eb63be53f9872918caec6bf2af3841 100644 (file)
@@ -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 */
+               ""
+               );
index ac537891ef2c1a8b6bfecf2b2d37a87e7f267922..d7975c5719accb301ad3d98f4fd4606520d68df9 100644 (file)
@@ -74,6 +74,16 @@ Tempo_performer::stop_translation_timestep ()
     }
 }
 
-ADD_TRANSLATOR (Tempo_performer, "", "",
+ADD_TRANSLATOR (Tempo_performer,
+               /* doc */
+               "",
+
+               /* create */
+               "",
+
+               /* read */
                "tempoWholesPerMinute ",
-               "");
+
+               /* write */
+               ""
+               );
index 14f519ec85434ad69c8a8234ba7645846ea37cb1..90376d2a62044a589f2be4ecdecb70faa2341dde 100644 (file)
@@ -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 */
+               ""
+               );
index cb7b8500139052cec742aeebfc4116c7f18e85e5..fb6c90d81fd96f9e1bdffd37023a5c74abf86587 100644 (file)
@@ -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 */
                ""
                );
index cf525dc7b967c57d50c562b94b19c87c677e4c4b..123d6aad4f63de6f273f47cd4d00c35136622a6e 100644 (file)
@@ -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 "
+               );
index 2fe3df0733b045eb0e17df0abd0818832d9a145b..d6cd7628a0aa9b588a2b270841030ae9515d8c66 100644 (file)
@@ -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 */
+               ""
+               );
index 5e23c5e3fe434e8d0554b0cfb436ebd806de033f..d72ba64645c65468968bf1b8c50da8fcdc74b09e 100644 (file)
@@ -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 */
+               ""
+               );
index 3e57a2c02c6b35114a5e3fad606da53e5dc89a3d..2401c2f77117e4cb655eee1ee6408936aab48750 100644 (file)
@@ -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 */
+               ""
+               );
index ee609a4db0cfeba7cfb27bbb2c0485fd317f0d11..a813957d04726684ca28b1a7218f436fa2d5eba8 100644 (file)
@@ -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 "
index d0ed1e52137f7990b7e93307b31a7956f5a3ed21..e4cb27d3b716c230a2af889ef55d25b83f7cd71b 100644 (file)
@@ -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 */
+               ""
+               );
index 1f9d4cf0dcf4a319b9ce1ec0441eb056fff66d4b..6f5f28beb7006c31601f4808886760fc71e7c352 100644 (file)
@@ -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 */
+               ""
+               );
index 7d97443e1d3db2ffac3ce03ae60ce2fb602c606f..478469a1e2e5e5dc62bcfd60a6cc5da88fe5904e 100644 (file)
@@ -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 */
+               ""
+               );
index e520f7d7c497367cdf5d8a71d14591473b4ffd76..d5b44b3d9756d08ec319516641fa799aac40bbb3 100644 (file)
@@ -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 */
+               ""
+               );
index 87510de0d4ec67788a8218242311a5784692920c..7b66eaf3022618cb74b5cd903c9e41833c0b4011 100644 (file)
@@ -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 */
+               ""
+               );
 
index b0f09c236ef004069114a790be1c09c3499d64c5..ea13929e73894632f5fc689fa52fa9bfbb67fc6d 100644 (file)
@@ -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 */
+               ""
+               );
index f3cc50d6cfc759ff7c1d313a56e542c8228d4b22..347b982b18093f981addca270a13545e9326cba3 100644 (file)
@@ -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 ()
 {
index 2912c0a479c91c5e75934d41c128e6753b817958..8a4b206329504901f551a8812499a5909f0621b0 100644 (file)
@@ -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 "
+               );
index 279eb5eb64e8fcda6ff56754f1966bc47b0ad873..708b535d260610c207e3d98ba0df287eb91fecec 100644 (file)
@@ -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 */
+               ""
+               );