1 /* -*- mode: c++; c-file-style: "linux"; indent-tabs-mode: t -*- */
3 This file is part of LilyPond, the GNU music typesetter.
5 Copyright (C) 1997--2015 Han-Wen Nienhuys <hanwen@xs4all.nl>
6 Jan Nieuwenhuizen <janneke@gnu.org>
8 LilyPond is free software: you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation, either version 3 of the License, or
11 (at your option) any later version.
13 LilyPond is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with LilyPond. If not, see <http://www.gnu.org/licenses/>.
22 /* Mode and indentation are at best a rough approximation based on TAB
23 * formatting (reasonable for compatibility with unspecific editor
24 * modes as Bison modes are hard to find) and need manual correction
25 * frequently. Without a reasonably dependable way of formatting a
26 * Bison file sensibly, there is little point in trying to fix the
27 * inconsistent state of indentation.
32 #define yyerror Lily_parser::parser_error
34 /* We use custom location type: Input objects */
37 #define YYLLOC_DEFAULT(Current,Rhs,N) \
38 ((Current).set_location ((Rhs)[1], (Rhs)[N]))
40 #define YYPRINT(file, type, value) \
42 if (scm_is_eq (value, SCM_UNSPECIFIED)) \
44 SCM s = Display::value_to_lily_string (value); \
45 char *p = scm_to_locale_string (s); \
52 %parse-param {Lily_parser *parser}
53 %parse-param {SCM *retval}
54 %lex-param {Lily_parser *parser}
58 /* We use SCMs to do strings, because it saves us the trouble of
59 deleting them. Let's hope that a stack overflow doesn't trigger a move
60 of the parse stack onto the heap. */
66 /* The above precedences tackle the shift/reduce problem
69 \repeat .. \alternative
71 \repeat { \repeat .. \alternative }
75 \repeat { \repeat } \alternative
81 %right ':' UNSIGNED REAL E_UNSIGNED EVENT_IDENTIFIER EVENT_FUNCTION '^' '_'
82 HYPHEN EXTENDER DURATION_IDENTIFIER '!'
84 /* The above are needed for collecting tremoli and other items (that
85 could otherwise be interpreted as belonging to the next function
86 argument) greedily, and together with the next rule will serve to
87 join numbers and units greedily instead of allowing them into
88 separate function arguments
91 %nonassoc NUMBER_IDENTIFIER
103 %{ // -*-Fundamental-*-
108 * The rules for who is protecting what are very shady. Uniformise
111 * There are too many lexical modes?
122 #include "context.hh"
123 #include "context-def.hh"
124 #include "context-mod.hh"
125 #include "dimensions.hh"
126 #include "file-path.hh"
128 #include "international.hh"
129 #include "lily-guile.hh"
130 #include "lily-lexer.hh"
131 #include "lily-parser.hh"
132 #include "ly-module.hh"
136 #include "output-def.hh"
137 #include "paper-book.hh"
138 #include "scm-hash.hh"
140 #include "text-interface.hh"
142 #include "lily-imports.hh"
145 Lily_parser::parser_error (Input const *i, Lily_parser *parser, SCM *, const string &s)
147 parser->parser_error (*i, s);
150 // The following are somewhat precarious constructs as they may change
151 // the value of the lookahead token. That implies that the lookahead
152 // token must not yet have made an impact on the state stack other
153 // than causing the reduction of the current rule, or switching the
154 // lookahead token while Bison is mulling it over will cause trouble.
156 #define MYBACKUP(Token, Value, Location) \
158 if (yychar != YYEMPTY) \
159 parser->lexer_->push_extra_token \
160 (yylloc, yychar, yylval); \
162 parser->lexer_->push_extra_token \
163 (Location, Token, Value); \
164 parser->lexer_->push_extra_token (Location, BACKUP); \
169 #define MYREPARSE(Location, Pred, Token, Value) \
171 if (yychar != YYEMPTY) \
172 parser->lexer_->push_extra_token \
173 (yylloc, yychar, yylval); \
174 parser->lexer_->push_extra_token \
175 (Location, Token, Value); \
176 parser->lexer_->push_extra_token \
177 (Location, REPARSE, Pred); \
186 #define MY_MAKE_MUSIC(x, spot) \
187 make_music_with_input (ly_symbol2scm (x), \
188 parser->lexer_->override_input (spot))
191 - delay application of the function
194 #define LOWLEVEL_MAKE_SYNTAX(location, proc, ...) \
196 (parser->lexer_->override_input (location).smobbed_copy (), \
200 /* Syntactic Sugar. */
201 #define MAKE_SYNTAX(name, location, ...) \
202 LOWLEVEL_MAKE_SYNTAX (location, Syntax::name, ##__VA_ARGS__)
204 #define START_MAKE_SYNTAX(name, ...) \
205 scm_list_n (Syntax::name, ##__VA_ARGS__, SCM_UNDEFINED)
207 #define FINISH_MAKE_SYNTAX(start, location, ...) \
208 LOWLEVEL_MAKE_SYNTAX \
213 (scm_list_2 (scm_cdr (start), \
214 scm_list_n (__VA_ARGS__, SCM_UNDEFINED))))
216 SCM get_next_unique_context_id ();
217 SCM get_next_unique_lyrics_context_id ();
224 #define _(x) gettext (x)
228 static Music *make_music_with_input (SCM name, Input where);
229 SCM check_scheme_arg (Lily_parser *parser, Input loc,
230 SCM arg, SCM args, SCM pred, SCM disp = SCM_UNDEFINED);
231 SCM make_music_from_simple (Lily_parser *parser, Input loc, SCM pitch);
232 SCM loc_on_copy (Lily_parser *parser, Input loc, SCM arg);
233 SCM make_chord_elements (Input loc, SCM pitch, SCM dur, SCM modification_list);
234 SCM make_chord_step (SCM step, Rational alter);
235 SCM make_simple_markup (SCM a);
236 SCM make_duration (SCM t, int dots = 0, SCM factor = SCM_UNDEFINED);
237 bool is_regular_identifier (SCM id, bool multiple=false);
238 SCM make_reverse_key_list (SCM keys);
239 SCM try_word_variants (SCM pred, SCM str);
240 SCM try_string_variants (SCM pred, SCM str);
241 int yylex (YYSTYPE *s, YYLTYPE *loc, Lily_parser *parser);
245 /* The third option is an alias that will be used to display the
246 syntax error. Bison CVS now correctly handles backslash escapes.
248 FIXME: Bison needs to translate some of these, eg, STRING.
252 /* Keyword tokens with plain escaped name. */
253 %token END_OF_FILE 0 "end of input"
254 %token ACCEPTS "\\accepts"
255 %token ADDLYRICS "\\addlyrics"
256 %token ALIAS "\\alias"
257 %token ALTERNATIVE "\\alternative"
259 %token BOOKPART "\\bookpart"
260 %token CHANGE "\\change"
261 %token CHORDMODE "\\chordmode"
262 %token CHORDS "\\chords"
263 %token CONSISTS "\\consists"
264 %token CONTEXT "\\context"
265 %token DEFAULT "\\default"
266 %token DEFAULTCHILD "\\defaultchild"
267 %token DENIES "\\denies"
268 %token DESCRIPTION "\\description"
269 %token DRUMMODE "\\drummode"
270 %token DRUMS "\\drums"
272 %token FIGUREMODE "\\figuremode"
273 %token FIGURES "\\figures"
274 %token HEADER "\\header"
275 %token INVALID "\\version-error"
276 %token LAYOUT "\\layout"
277 %token LYRICMODE "\\lyricmode"
278 %token LYRICS "\\lyrics"
279 %token LYRICSTO "\\lyricsto"
280 %token MARKUP "\\markup"
281 %token MARKUPLIST "\\markuplist"
284 %token NOTEMODE "\\notemode"
285 %token OVERRIDE "\\override"
286 %token PAPER "\\paper"
287 %token REMOVE "\\remove"
288 %token REPEAT "\\repeat"
290 %token REVERT "\\revert"
291 %token SCORE "\\score"
292 %token SCORELINES "\\score-lines"
293 %token SEQUENTIAL "\\sequential"
295 %token SIMULTANEOUS "\\simultaneous"
296 %token TEMPO "\\tempo"
298 %token UNSET "\\unset"
301 /* Keyword token exceptions. */
302 %token NEWCONTEXT "\\new"
305 /* Other string tokens. */
307 %token CHORD_BASS "/+"
308 %token CHORD_CARET "^"
309 %token CHORD_COLON ":"
310 %token CHORD_MINUS "-"
311 %token CHORD_SLASH "/"
312 %token ANGLE_OPEN "<"
313 %token ANGLE_CLOSE ">"
314 %token DOUBLE_ANGLE_OPEN "<<"
315 %token DOUBLE_ANGLE_CLOSE ">>"
316 %token E_BACKSLASH "\\"
317 %token E_EXCLAMATION "\\!"
322 If we give names, Bison complains.
324 %token FIGURE_CLOSE /* "\\>" */
325 %token FIGURE_OPEN /* "\\<" */
326 %token FIGURE_SPACE "_"
329 %token MULTI_MEASURE_REST
335 /* Artificial tokens, for more generic function syntax */
336 %token EXPECT_MARKUP "markup?"
337 %token EXPECT_SCM "scheme?"
338 %token BACKUP "(backed-up?)"
339 %token REPARSE "(reparsed?)"
340 %token EXPECT_MARKUP_LIST "markup-list?"
341 %token EXPECT_OPTIONAL "optional?"
342 /* After the last argument. */
343 %token EXPECT_NO_MORE_ARGS;
345 /* An artificial token for parsing embedded Lilypond */
346 %token EMBEDDED_LILY "#{"
348 %token BOOK_IDENTIFIER
349 %token CHORD_MODIFIER
350 %token CHORD_REPETITION
352 /* Artificial token for durations in argument lists */
354 %token DURATION_IDENTIFIER
355 %token EVENT_IDENTIFIER
356 %token EVENT_FUNCTION
358 %token LOOKUP_IDENTIFIER
360 %token MARKUP_FUNCTION
361 %token MARKUP_LIST_FUNCTION
362 %token MARKUP_IDENTIFIER
363 %token MARKUPLIST_IDENTIFIER
364 %token MUSIC_FUNCTION
365 %token MUSIC_IDENTIFIER
366 %token NOTENAME_PITCH
367 %token NUMBER_IDENTIFIER
368 %token PITCH_IDENTIFIER
373 %token SCM_IDENTIFIER
377 %token TONICNAME_PITCH
382 /* We don't assign precedence to / and *, because we might need varied
383 prec levels in different prods */
392 parser->lexer_->push_note_state (Lily::pitchnames);
393 } embedded_lilypond {
394 parser->lexer_->pop_state ();
399 lilypond: /* empty */ { $$ = SCM_UNSPECIFIED; }
400 | lilypond toplevel_expression {
402 | lilypond assignment {
405 parser->error_level_ = 1;
408 parser->error_level_ = 1;
415 parser->lexer_->set_identifier (ly_symbol2scm ("$defaultheader"), $1);
418 SCM proc = parser->lexer_->lookup_identifier ("toplevel-book-handler");
419 scm_call_1 (proc, $1);
422 SCM proc = parser->lexer_->lookup_identifier ("toplevel-bookpart-handler");
423 scm_call_1 (proc, $1);
426 SCM proc = parser->lexer_->lookup_identifier
427 (unsmob<Book>($1)->paper_
428 ? "toplevel-book-handler"
429 : "toplevel-bookpart-handler");
430 scm_call_1 (proc, $1);
433 SCM proc = parser->lexer_->lookup_identifier ("toplevel-score-handler");
434 scm_call_1 (proc, $1);
437 SCM proc = parser->lexer_->lookup_identifier ("toplevel-music-handler");
438 scm_call_1 (proc, $1);
441 SCM proc = parser->lexer_->lookup_identifier ("toplevel-text-handler");
442 scm_call_1 (proc, scm_list_1 ($1));
445 SCM proc = parser->lexer_->lookup_identifier ("toplevel-text-handler");
446 scm_call_1 (proc, $1);
449 // Evaluate and ignore #xxx, as opposed to \xxx
450 parser->lexer_->eval_scm_token ($1, @1);
452 | embedded_scm_active
454 SCM out = SCM_UNDEFINED;
455 if (Text_interface::is_markup ($1))
456 out = scm_list_1 ($1);
457 else if (Text_interface::is_markup_list ($1))
459 if (scm_is_pair (out))
461 SCM proc = parser->lexer_->lookup_identifier ("toplevel-text-handler");
462 scm_call_1 (proc, out);
463 } else if (unsmob<Score> ($1))
465 SCM proc = parser->lexer_->lookup_identifier ("toplevel-score-handler");
466 scm_call_1 (proc, $1);
467 } else if (Output_def * od = unsmob<Output_def> ($1)) {
470 if (to_boolean (od->c_variable ("is-paper")))
471 id = ly_symbol2scm ("$defaultpaper");
472 else if (to_boolean (od->c_variable ("is-midi")))
473 id = ly_symbol2scm ("$defaultmidi");
474 else if (to_boolean (od->c_variable ("is-layout")))
475 id = ly_symbol2scm ("$defaultlayout");
477 parser->lexer_->set_identifier (id, $1);
478 } else if (ly_is_module ($1))
480 SCM module = get_header (parser);
481 ly_module_copy (module, $1);
482 parser->lexer_->set_identifier
483 (ly_symbol2scm ("$defaultheader"), module);
484 } else if (!scm_is_eq ($1, SCM_UNSPECIFIED))
485 parser->parser_error (@1, _("bad expression type"));
489 Output_def * od = unsmob<Output_def> ($1);
491 if (to_boolean (od->c_variable ("is-paper")))
492 id = ly_symbol2scm ("$defaultpaper");
493 else if (to_boolean (od->c_variable ("is-midi")))
494 id = ly_symbol2scm ("$defaultmidi");
495 else if (to_boolean (od->c_variable ("is-layout")))
496 id = ly_symbol2scm ("$defaultlayout");
498 parser->lexer_->set_identifier (id, $1);
504 | LOOKUP_IDENTIFIER '.' symbol_list_rev
506 $$ = loc_on_copy (parser, @$,
507 nested_property ($1, scm_reverse_x ($3, SCM_EOL)));
514 $$ = parser->lexer_->eval_scm_token ($1, @1);
525 embedded_scm_bare_arg:
529 $$ = parser->lexer_->eval_scm_token ($1, @1);
534 | context_modification
537 | context_def_spec_block
544 /* The generic version may end in music, or not */
552 /* embedded_scm_arg is _not_ casting pitches to music by default, this
553 * has to be done by the function itself. Note that this may cause
554 * the results of scm_function_call or embedded_scm_bare_arg to be
555 * turned into music from pitches as well. Note that this creates a
556 * distinctly awkward situation for calculated drum pitches. Those
557 * are at the current point of time rejected as music constituents as
558 * they can't be distinguished from "proper" symbols.
562 embedded_scm_bare_arg
568 SCM_FUNCTION function_arglist {
569 $$ = MAKE_SYNTAX (music_function, @$,
574 embedded_lilypond_number:
575 '-' embedded_lilypond_number
577 $$ = scm_difference ($2, SCM_UNDEFINED);
580 | UNSIGNED NUMBER_IDENTIFIER
582 $$ = scm_product ($1, $2);
589 // FIXME: @$ does not contain a useful source location
590 // for empty rules, and the only token in the whole
591 // production, EMBEDDED_LILY, is synthetic and also
592 // contains no source location.
593 $$ = MAKE_SYNTAX (void_music, @$);
595 | identifier_init_nonumber
596 | embedded_lilypond_number
597 | post_event post_events
599 $$ = scm_reverse_x ($2, SCM_EOL);
600 if (Music *m = unsmob<Music> ($1))
602 if (m->is_mus_type ("post-event-wrapper"))
604 (scm_list_2 (m->get_property ("elements"),
607 $$ = scm_cons ($1, $$);
610 && scm_is_null (scm_cdr ($$)))
614 Music * m = MY_MAKE_MUSIC ("PostEvents", @$);
615 m->set_property ("elements", $$);
616 $$ = m->unprotect ();
619 | multiplied_duration
620 | music_embedded music_embedded music_list {
621 $3 = scm_reverse_x ($3, SCM_EOL);
622 if (unsmob<Music> ($2))
623 $3 = scm_cons ($2, $3);
624 if (unsmob<Music> ($1))
625 $3 = scm_cons ($1, $3);
626 $$ = MAKE_SYNTAX (sequential_music, @$, $3);
629 parser->error_level_ = 1;
630 $$ = SCM_UNSPECIFIED;
632 | INVALID embedded_lilypond {
633 parser->error_level_ = 1;
639 lilypond_header_body:
640 /* empty */ { $$ = SCM_UNSPECIFIED; }
641 | lilypond_header_body assignment {
644 | lilypond_header_body SCM_TOKEN {
645 // Evaluate and ignore #xxx, as opposed to \xxx
646 parser->lexer_->eval_scm_token ($2, @2);
648 | lilypond_header_body embedded_scm_active {
649 if (ly_is_module ($2))
650 ly_module_copy (scm_current_module (), $2);
651 else if (!scm_is_eq ($2, SCM_UNSPECIFIED))
652 parser->parser_error (@2, _("bad expression type"));
657 HEADER '{' lilypond_header_body '}' {
658 $$ = parser->lexer_->remove_scope ();
664 parser->lexer_->add_scope (get_header (parser));
676 $$ = scm_string_to_symbol ($1);
680 $$ = scm_string_to_symbol ($1);
685 assignment_id '=' identifier_init {
686 parser->lexer_->set_identifier ($1, $3);
687 $$ = SCM_UNSPECIFIED;
689 | assignment_id '.' property_path '=' identifier_init {
690 SCM path = scm_cons ($1, $3);
691 parser->lexer_->set_identifier (path, $5);
692 $$ = SCM_UNSPECIFIED;
694 | assignment_id ',' property_path '=' identifier_init {
695 SCM path = scm_cons ($1, $3);
696 parser->lexer_->set_identifier (path, $5);
697 $$ = SCM_UNSPECIFIED;
699 | markup_mode_word '=' identifier_init
701 if (scm_is_false (Lily::markup_function_p ($3)))
703 parser->parser_error (@3, _ ("Not a markup function"));
707 (Lily::define_markup_command,
708 scm_string_to_symbol ($1),
711 $$ = SCM_UNSPECIFIED;
717 identifier_init_nonumber
719 | symbol_list_part_bare '.' property_path
721 $$ = scm_reverse_x ($1, $3);
723 | symbol_list_part_bare ',' property_path
725 $$ = scm_reverse_x ($1, $3);
727 | post_event_nofinger post_events
729 $$ = scm_reverse_x ($2, SCM_EOL);
730 if (Music *m = unsmob<Music> ($1))
732 if (m->is_mus_type ("post-event-wrapper"))
734 (scm_list_2 (m->get_property ("elements"),
737 $$ = scm_cons ($1, $$);
740 && scm_is_null (scm_cdr ($$)))
744 Music * m = MY_MAKE_MUSIC ("PostEvents", @$);
745 m->set_property ("elements", $$);
746 $$ = m->unprotect ();
751 identifier_init_nonumber:
757 | context_def_spec_block
765 | context_modification
766 | partial_function ETC
768 $$ = MAKE_SYNTAX (partial_music_function, @$,
769 scm_reverse_x ($1, SCM_EOL));
775 MUSIC_FUNCTION function_arglist_partial
777 $$ = scm_acons ($1, $2, SCM_EOL);
779 | EVENT_FUNCTION function_arglist_partial
781 $$ = scm_acons ($1, $2, SCM_EOL);
783 | SCM_FUNCTION function_arglist_partial
785 $$ = scm_acons ($1, $2, SCM_EOL);
787 | OVERRIDE grob_prop_path '='
790 $$ = scm_list_1 (SCM_BOOL_F);
793 (scm_list_3 (Syntax::property_override_function,
794 scm_cdr ($2), scm_car ($2)),
797 | SET context_prop_spec '='
800 $$ = scm_list_1 (SCM_BOOL_F);
803 (scm_list_3 (Syntax::property_set_function,
804 scm_cadr ($2), scm_car ($2)),
807 | MUSIC_FUNCTION EXPECT_SCM function_arglist_optional partial_function
809 $$ = scm_acons ($1, $3, $4);
811 | EVENT_FUNCTION EXPECT_SCM function_arglist_optional partial_function
813 $$ = scm_acons ($1, $3, $4);
815 | SCM_FUNCTION EXPECT_SCM function_arglist_optional partial_function
817 $$ = scm_acons ($1, $3, $4);
819 | OVERRIDE grob_prop_path '=' partial_function
822 $$ = scm_list_1 (SCM_BOOL_F);
825 (scm_list_3 (Syntax::property_override_function,
826 scm_cdr ($2), scm_car ($2)),
829 | SET context_prop_spec '=' partial_function
832 $$ = scm_list_1 (SCM_BOOL_F);
835 (scm_list_3 (Syntax::property_set_function,
836 scm_cadr ($2), scm_car ($2)),
839 | MUSIC_FUNCTION EXPECT_OPTIONAL EXPECT_SCM function_arglist_nonbackup partial_function
841 $$ = scm_acons ($1, $4, $5);
843 | EVENT_FUNCTION EXPECT_OPTIONAL EXPECT_SCM function_arglist_nonbackup partial_function
845 $$ = scm_acons ($1, $4, $5);
847 | SCM_FUNCTION EXPECT_OPTIONAL EXPECT_SCM function_arglist_nonbackup partial_function
849 $$ = scm_acons ($1, $4, $5);
853 context_def_spec_block:
854 CONTEXT '{' context_def_spec_body '}'
857 Context_def *td = unsmob<Context_def> ($$);
859 $$ = Context_def::make_scm ();
860 td = unsmob<Context_def> ($$);
862 td->origin ()->set_spot (@$);
870 parser->lexer_->push_note_state (Lily::pitchnames);
874 parser->lexer_->pop_state ();
880 context_def_spec_body:
882 $$ = SCM_UNSPECIFIED;
884 | context_def_spec_body context_mod {
885 if (!SCM_UNBNDP ($2)) {
886 Context_def *td = unsmob<Context_def> ($$);
888 $$ = Context_def::make_scm ();
889 td = unsmob<Context_def> ($$);
891 unsmob<Context_def> ($$)->add_context_mod ($2);
894 | context_def_spec_body context_modification {
895 Context_def *td = unsmob<Context_def> ($$);
897 $$ = Context_def::make_scm ();
898 td = unsmob<Context_def> ($$);
900 SCM new_mods = unsmob<Context_mod> ($2)->get_mods ();
901 for (SCM m = new_mods; scm_is_pair (m); m = scm_cdr (m)) {
902 td->add_context_mod (scm_car (m));
905 | context_def_spec_body context_mod_arg {
906 Context_def *td = unsmob<Context_def> ($1);
907 if (scm_is_eq ($2, SCM_UNSPECIFIED))
909 else if (!td && unsmob<Context_def> ($2))
913 $$ = Context_def::make_scm ();
914 td = unsmob<Context_def> ($$);
916 if (unsmob<Music> ($2)) {
917 SCM proc = parser->lexer_->lookup_identifier ("context-mod-music-handler");
918 $2 = scm_call_1 (proc, $2);
920 if (Context_mod *cm = unsmob<Context_mod> ($2)) {
921 for (SCM m = cm->get_mods (); scm_is_pair (m); m = scm_cdr (m)) {
922 td->add_context_mod (scm_car (m));
925 parser->parser_error (@2, _ ("not a context mod"));
933 BOOK '{' book_body '}' {
935 unsmob<Book> ($$)->origin ()->set_spot (@$);
937 parser->lexer_->set_identifier (ly_symbol2scm ("$current-book"), SCM_BOOL_F);
942 * Use 'handlers' like for toplevel-* stuff?
943 * grok \layout and \midi? */
946 Book *book = new Book;
947 init_papers (parser);
948 book->paper_ = dynamic_cast<Output_def*> (unsmob<Output_def> (parser->lexer_->lookup_identifier ("$defaultpaper"))->clone ());
949 book->paper_->unprotect ();
950 push_paper (parser, book->paper_);
951 book->header_ = get_header (parser);
952 $$ = book->unprotect ();
953 parser->lexer_->set_identifier (ly_symbol2scm ("$current-book"), $$);
956 parser->lexer_->set_identifier (ly_symbol2scm ("$current-book"), $1);
958 | book_body paper_block {
959 unsmob<Book> ($1)->paper_ = unsmob<Output_def> ($2);
960 set_paper (parser, unsmob<Output_def> ($2));
962 | book_body bookpart_block {
963 SCM proc = parser->lexer_->lookup_identifier ("book-bookpart-handler");
964 scm_call_2 (proc, $1, $2);
966 | book_body score_block {
967 SCM proc = parser->lexer_->lookup_identifier ("book-score-handler");
968 scm_call_2 (proc, $1, $2);
970 | book_body composite_music {
971 SCM proc = parser->lexer_->lookup_identifier ("book-music-handler");
972 scm_call_2 (proc, $1, $2);
974 | book_body full_markup {
975 SCM proc = parser->lexer_->lookup_identifier ("book-text-handler");
976 scm_call_2 (proc, $1, scm_list_1 ($2));
978 | book_body full_markup_list {
979 SCM proc = parser->lexer_->lookup_identifier ("book-text-handler");
980 scm_call_2 (proc, $1, $2);
982 | book_body SCM_TOKEN {
983 // Evaluate and ignore #xxx, as opposed to \xxx
984 parser->lexer_->eval_scm_token ($2, @2);
986 | book_body embedded_scm_active
988 SCM out = SCM_UNDEFINED;
989 if (Text_interface::is_markup ($2))
990 out = scm_list_1 ($2);
991 else if (Text_interface::is_markup_list ($2))
993 if (scm_is_pair (out))
995 SCM proc = parser->lexer_->lookup_identifier ("book-text-handler");
996 scm_call_2 (proc, $1, out);
997 } else if (unsmob<Score> ($2))
999 SCM proc = parser->lexer_->lookup_identifier ("book-score-handler");
1000 scm_call_2 (proc, $1, $2);
1001 } else if (Output_def *od = unsmob<Output_def> ($2)) {
1002 if (to_boolean (od->lookup_variable (ly_symbol2scm ("is-paper")))) {
1003 unsmob<Book> ($1)->paper_ = od;
1004 set_paper (parser, od);
1006 parser->parser_error (@2, _ ("need \\paper for paper block"));
1008 } else if (ly_is_module ($2))
1010 ly_module_copy (unsmob<Book> ($1)->header_, $2);
1011 } else if (!scm_is_eq ($2, SCM_UNSPECIFIED))
1012 parser->parser_error (@2, _("bad expression type"));
1016 parser->lexer_->add_scope (unsmob<Book> ($1)->header_);
1019 Book *book = unsmob<Book> ($1);
1021 book->scores_ = SCM_EOL;
1022 book->bookparts_ = SCM_EOL;
1027 BOOKPART '{' bookpart_body '}' {
1029 unsmob<Book> ($$)->origin ()->set_spot (@$);
1030 parser->lexer_->set_identifier (ly_symbol2scm ("$current-bookpart"), SCM_BOOL_F);
1036 Book *book = new Book;
1037 $$ = book->unprotect ();
1038 parser->lexer_->set_identifier (ly_symbol2scm ("$current-bookpart"), $$);
1041 parser->lexer_->set_identifier (ly_symbol2scm ("$current-bookpart"), $1);
1043 | bookpart_body paper_block {
1044 unsmob<Book> ($$)->paper_ = unsmob<Output_def> ($2);
1046 | bookpart_body score_block {
1047 SCM proc = parser->lexer_->lookup_identifier ("bookpart-score-handler");
1048 scm_call_2 (proc, $1, $2);
1050 | bookpart_body composite_music {
1051 SCM proc = parser->lexer_->lookup_identifier ("bookpart-music-handler");
1052 scm_call_2 (proc, $1, $2);
1054 | bookpart_body full_markup {
1055 SCM proc = parser->lexer_->lookup_identifier ("bookpart-text-handler");
1056 scm_call_2 (proc, $1, scm_list_1 ($2));
1058 | bookpart_body full_markup_list {
1059 SCM proc = parser->lexer_->lookup_identifier ("bookpart-text-handler");
1060 scm_call_2 (proc, $1, $2);
1062 | bookpart_body SCM_TOKEN {
1063 // Evaluate and ignore #xxx, as opposed to \xxx
1064 parser->lexer_->eval_scm_token ($2, @2);
1066 | bookpart_body embedded_scm_active
1068 SCM out = SCM_UNDEFINED;
1069 if (Text_interface::is_markup ($2))
1070 out = scm_list_1 ($2);
1071 else if (Text_interface::is_markup_list ($2))
1073 if (scm_is_pair (out))
1075 SCM proc = parser->lexer_->lookup_identifier ("bookpart-text-handler");
1076 scm_call_2 (proc, $1, out);
1077 } else if (unsmob<Score> ($2))
1079 SCM proc = parser->lexer_->lookup_identifier ("bookpart-score-handler");
1080 scm_call_2 (proc, $1, $2);
1081 } else if (Output_def *od = unsmob<Output_def> ($2)) {
1082 if (to_boolean (od->lookup_variable (ly_symbol2scm ("is-paper")))) {
1083 unsmob<Book> ($1)->paper_ = od;
1085 parser->parser_error (@2, _ ("need \\paper for paper block"));
1087 } else if (ly_is_module ($2)) {
1088 Book *book = unsmob<Book> ($1);
1089 if (!ly_is_module (book->header_))
1090 book->header_ = ly_make_module (false);
1091 ly_module_copy (book->header_, $2);
1092 } else if (!scm_is_eq ($2, SCM_UNSPECIFIED))
1093 parser->parser_error (@2, _("bad expression type"));
1097 Book *book = unsmob<Book> ($1);
1098 if (!ly_is_module (book->header_))
1099 book->header_ = ly_make_module (false);
1100 parser->lexer_->add_scope (book->header_);
1102 | bookpart_body error {
1103 Book *book = unsmob<Book> ($1);
1105 book->scores_ = SCM_EOL;
1110 SCORE '{' score_body '}' {
1111 unsmob<Score> ($3)->origin ()->set_spot (@$);
1118 if (!unsmob<Score> ($1)) {
1119 parser->parser_error (@1, _("Missing music in \\score"));
1120 $$ = (new Score)->unprotect ();
1121 if (scm_is_pair ($1) && ly_is_module (scm_car ($1)))
1123 unsmob<Score> ($$)->set_header (scm_car ($1));
1126 for (SCM p = scm_reverse_x ($1, SCM_EOL);
1127 scm_is_pair (p); p = scm_cdr (p))
1129 unsmob<Score> ($$)->
1130 add_output_def (unsmob<Output_def> (scm_car (p)));
1134 | score_body error {
1135 unsmob<Score> ($$)->error_found_ = true;
1150 | score_items score_item
1152 Output_def *od = unsmob<Output_def> ($2);
1154 if (to_boolean (od->lookup_variable (ly_symbol2scm ("is-paper"))))
1156 parser->parser_error (@2, _("\\paper cannot be used in \\score, use \\layout instead"));
1158 $2 = SCM_UNSPECIFIED;
1160 } else if (!unsmob<Score> ($$)) {
1161 if (unsmob<Music> ($2)) {
1162 $2 = Lily::scorify_music ($2);
1164 if (unsmob<Score> ($2))
1167 $2 = SCM_UNSPECIFIED;
1170 Score *score = unsmob<Score> ($$);
1171 if (score && scm_is_pair ($1)) {
1172 if (ly_is_module (scm_car ($1)))
1174 score->set_header (scm_car ($1));
1177 for (SCM p = scm_reverse_x ($1, SCM_EOL);
1178 scm_is_pair (p); p = scm_cdr (p))
1180 score->add_output_def (unsmob<Output_def> (scm_car (p)));
1185 score->add_output_def (od);
1186 else if (scm_is_pair ($$) && ly_is_module (scm_car ($$)))
1187 scm_set_cdr_x ($$, scm_cons ($2, scm_cdr ($$)));
1189 $$ = scm_cons ($2, $$);
1190 } else if (ly_is_module ($2)) {
1191 SCM module = SCM_UNSPECIFIED;
1193 module = score->get_header ();
1194 if (!ly_is_module (module))
1196 module = ly_make_module (false);
1197 score->set_header (module);
1199 } else if (scm_is_pair ($$) && ly_is_module (scm_car ($$)))
1200 module = scm_car ($$);
1202 module = ly_make_module (false);
1203 $$ = scm_cons (module, $$);
1205 ly_module_copy (module, $2);
1206 } else if (!scm_is_eq ($2, SCM_UNSPECIFIED))
1207 parser->parser_error (@2, _("Spurious expression in \\score"));
1211 if (Score *score = unsmob<Score> ($1)) {
1212 if (!ly_is_module (score->get_header ()))
1213 score->set_header (ly_make_module (false));
1214 parser->lexer_->add_scope (score->get_header ());
1216 if (!scm_is_pair ($1) || !ly_is_module (scm_car ($1)))
1217 $1 = scm_cons (ly_make_module (false), $1);
1218 parser->lexer_->add_scope (scm_car ($1));
1233 Output_def *od = unsmob<Output_def> ($1);
1235 if (!to_boolean (od->lookup_variable (ly_symbol2scm ("is-paper"))))
1237 parser->parser_error (@1, _ ("need \\paper for paper block"));
1238 $$ = get_paper (parser)->unprotect ();
1245 output_def_body '}' {
1246 if (scm_is_pair ($1))
1249 parser->lexer_->remove_scope ();
1250 parser->lexer_->pop_state ();
1256 Output_def *p = get_paper (parser);
1257 p->input_origin_ = @$;
1258 parser->lexer_->add_scope (p->scope_);
1259 $$ = p->unprotect ();
1262 Output_def *p = get_midi (parser);
1263 $$ = p->unprotect ();
1264 parser->lexer_->add_scope (p->scope_);
1267 Output_def *p = get_layout (parser);
1269 parser->lexer_->add_scope (p->scope_);
1270 $$ = p->unprotect ();
1274 output_def_head_with_mode_switch:
1276 parser->lexer_->push_initial_state ();
1281 // We need this weird nonterminal because both music as well as a
1282 // context definition can start with \context and the difference is
1283 // only apparent after looking at the next token. If it is '{', there
1284 // is still time to escape from notes mode.
1286 music_or_context_def:
1288 | context_def_spec_block
1292 output_def_head_with_mode_switch '{' {
1293 unsmob<Output_def> ($1)->input_origin_.set_spot (@$);
1294 // This is a stupid trick to mark the beginning of the
1295 // body for deciding whether to allow
1296 // embedded_scm_active to have an output definition
1297 $$ = scm_list_1 ($1);
1299 | output_def_body assignment {
1300 if (scm_is_pair ($1))
1303 | output_def_body embedded_scm_active
1305 // We don't switch into note mode for Scheme functions
1306 // here. Does not seem warranted/required in output
1308 if (scm_is_pair ($1))
1310 Output_def *o = unsmob<Output_def> ($2);
1312 o->input_origin_.set_spot (@$);
1313 $1 = o->self_scm ();
1314 parser->lexer_->remove_scope ();
1315 parser->lexer_->add_scope (o->scope_);
1316 $2 = SCM_UNSPECIFIED;
1320 if (unsmob<Context_def> ($2))
1321 assign_context_def (unsmob<Output_def> ($1), $2);
1322 // Seems unlikely, but let's be complete:
1323 else if (unsmob<Music> ($2))
1325 SCM proc = parser->lexer_->lookup_identifier
1326 ("output-def-music-handler");
1327 scm_call_2 (proc, $1, $2);
1328 } else if (!scm_is_eq ($2, SCM_UNSPECIFIED))
1329 parser->parser_error (@2, _("bad expression type"));
1332 | output_def_body SCM_TOKEN {
1333 if (scm_is_pair ($1))
1335 // Evaluate and ignore #xxx, as opposed to \xxx
1336 parser->lexer_->eval_scm_token ($2, @2);
1340 if (scm_is_pair ($1))
1342 parser->lexer_->push_note_state (Lily::pitchnames);
1343 } music_or_context_def
1345 parser->lexer_->pop_state ();
1346 if (unsmob<Context_def> ($3))
1347 assign_context_def (unsmob<Output_def> ($1), $3);
1350 SCM proc = parser->lexer_->lookup_identifier
1351 ("output-def-music-handler");
1352 scm_call_2 (proc, $1, $3);
1356 | output_def_body error {
1362 TEMPO steno_duration '=' tempo_range {
1363 $$ = MAKE_SYNTAX (tempo, @$, SCM_EOL, $2, $4);
1365 | TEMPO text steno_duration '=' tempo_range {
1366 $$ = MAKE_SYNTAX (tempo, @$, $2, $3, $5);
1369 $$ = MAKE_SYNTAX (tempo, @$, $2);
1374 The representation of a list is reversed to have efficient append. */
1380 | music_list music_embedded {
1381 if (unsmob<Music> ($2))
1382 $$ = scm_cons ($2, $1);
1384 | music_list error {
1385 Music *m = MY_MAKE_MUSIC("Music", @$);
1387 m->set_property ("error-found", SCM_BOOL_T);
1388 $$ = scm_cons (m->self_scm (), $1);
1389 m->unprotect (); /* UGH */
1396 $$ = scm_reverse_x ($2, SCM_EOL);
1401 | lyric_element_music
1408 $$ = make_music_from_simple (parser, @1, $1);
1409 if (!unsmob<Music> ($$))
1411 parser->parser_error (@1, _ ("music expected"));
1412 $$ = MAKE_SYNTAX (void_music, @$);
1420 if (unsmob<Music> ($1)->is_mus_type ("post-event")) {
1421 parser->parser_error (@1, _ ("unexpected post-event"));
1422 $$ = SCM_UNSPECIFIED;
1425 | music_embedded_backup
1429 | music_embedded_backup BACKUP lyric_element_music
1433 | multiplied_duration post_events
1435 Music *n = MY_MAKE_MUSIC ("NoteEvent", @$);
1437 parser->default_duration_ = *unsmob<Duration> ($1);
1438 n->set_property ("duration", $1);
1440 if (scm_is_pair ($2))
1441 n->set_property ("articulations",
1442 scm_reverse_x ($2, SCM_EOL));
1443 $$ = n->unprotect ();
1447 music_embedded_backup:
1450 if (scm_is_eq ($1, SCM_UNSPECIFIED))
1452 else if (Music *m = unsmob<Music> ($1)) {
1453 if (m->is_mus_type ("post-event")) {
1454 parser->parser_error
1455 (@1, _ ("unexpected post-event"));
1456 $$ = SCM_UNSPECIFIED;
1459 } else if (parser->lexer_->is_lyric_state ()
1460 && Text_interface::is_markup ($1))
1461 MYBACKUP (LYRIC_ELEMENT, $1, @1);
1463 @$.warning (_ ("Ignoring non-music expression"));
1469 // music_assign does not need to contain lyrics: there are no
1470 // assignments in lyricmode.
1473 | composite_music %prec COMPOSITE
1477 REPEAT simple_string unsigned_number music
1479 $$ = MAKE_SYNTAX (repeat, @$, $2, $3, $4, SCM_EOL);
1481 | REPEAT simple_string unsigned_number music ALTERNATIVE braced_music_list
1483 $$ = MAKE_SYNTAX (repeat, @$, $2, $3, $4, $6);
1488 SEQUENTIAL braced_music_list {
1489 $$ = MAKE_SYNTAX (sequential_music, @$, $2);
1491 | braced_music_list {
1492 $$ = MAKE_SYNTAX (sequential_music, @$, $1);
1497 SIMULTANEOUS braced_music_list {
1498 $$ = MAKE_SYNTAX (simultaneous_music, @$, $2);
1500 | DOUBLE_ANGLE_OPEN music_list DOUBLE_ANGLE_CLOSE {
1501 $$ = MAKE_SYNTAX (simultaneous_music, @$, scm_reverse_x ($2, SCM_EOL));
1507 | music_property_def
1511 context_modification:
1514 parser->lexer_->push_note_state (Lily::pitchnames);
1515 } '{' context_mod_list '}'
1517 parser->lexer_->pop_state ();
1520 | WITH context_modification_arg
1522 if (unsmob<Music> ($2)) {
1523 SCM proc = parser->lexer_->lookup_identifier ("context-mod-music-handler");
1524 $2 = scm_call_1 (proc, $2);
1526 if (unsmob<Context_mod> ($2))
1529 // let's permit \with #*unspecified* to go for
1530 // an empty context mod
1531 if (!scm_is_eq ($2, SCM_UNSPECIFIED))
1532 parser->parser_error (@2, _ ("not a context mod"));
1533 $$ = Context_mod ().smobbed_copy ();
1538 context_modification_arg:
1543 /* A list of single mods collected from a (possibly empty) sequence of
1544 * context modifications, usually written as \with ... \with ...
1547 optional_context_mods:
1548 context_modification_mods_list
1550 if (scm_is_pair ($1))
1551 $$ = scm_append_x (scm_reverse_x ($1, SCM_EOL));
1555 /* The worker for optional_context_mods conses a (reversed) list where
1556 * each element contains the list of single context mods from one
1557 * context modification block. Context_mod::get_mods creates fresh
1558 * copies, so it's okay to use append! on them.
1561 context_modification_mods_list:
1565 | context_modification_mods_list context_modification
1567 if (Context_mod *m = unsmob<Context_mod> ($2))
1568 $$ = scm_cons (m->get_mods (), $1);
1572 /* A Context_mod is a container for a list of context mods like
1573 * \consists ... \override ... . context_mod_list produces a
1574 * Context_mod from the inside of a \with { ... } statement.
1579 $$ = Context_mod ().smobbed_copy ();
1581 | context_mod_list context_mod {
1582 if (!SCM_UNBNDP ($2))
1583 unsmob<Context_mod> ($1)->add_context_mod ($2);
1585 | context_mod_list context_mod_arg {
1586 if (unsmob<Music> ($2)) {
1587 SCM proc = parser->lexer_->lookup_identifier ("context-mod-music-handler");
1588 $2 = scm_call_1 (proc, $2);
1590 if (unsmob<Context_mod> ($2))
1591 unsmob<Context_mod> ($$)->add_context_mods
1592 (unsmob<Context_mod> ($2)->get_mods ());
1593 else if (!scm_is_eq ($2, SCM_UNSPECIFIED))
1594 parser->parser_error (@2, _ ("not a context mod"));
1599 CONTEXT symbol optional_id optional_context_mods {
1600 $$ = START_MAKE_SYNTAX (context_specification, $2, $3, $4, SCM_BOOL_F);
1602 | NEWCONTEXT symbol optional_id optional_context_mods {
1603 $$ = START_MAKE_SYNTAX (context_specification, $2, $3, $4, SCM_BOOL_T);
1608 ADDLYRICS optional_context_mods lyric_mode_music {
1609 $$ = scm_acons ($3, $2, SCM_EOL);
1611 | new_lyrics ADDLYRICS optional_context_mods lyric_mode_music {
1612 $$ = scm_acons ($4, $3, $1);
1616 /* basic_music is basically the same as composite_music but with
1617 * context-prefixed music and lyricized music explicitly removed. The
1618 * reason is that in a sequence
1620 * \new Staff \new Voice { ... } \addlyrics { ... } \addlyrics { ... }
1622 * we need to group both \addlyrics together (as they go with the same
1623 * voice) but then combine them with \new Voice { ... }, meaning that
1624 * combining \new Voice { ... } needs higher priority than
1625 * { ... } \addlyrics, and *not* have \new Staff \new Voice { ... }
1626 * combine before combining \new Voice { ... } \addlyrics: only one
1627 * layer of context-prefixed music should assemble before \addlyrics
1628 * is integrated. Total mess, and we sort this mess out with explicit
1629 * rules preferring a single context-prefix.
1636 | LYRICSTO simple_string lyric_mode_music {
1637 $$ = MAKE_SYNTAX (lyric_combine, @$, $2, SCM_EOL, $3);
1639 | LYRICSTO symbol '=' simple_string lyric_mode_music
1641 $$ = MAKE_SYNTAX (lyric_combine, @$, $4, $2, $5);
1651 contexted_basic_music:
1652 context_prefix contextable_music new_lyrics
1655 i.set_location (@1, @2);
1656 $$ = FINISH_MAKE_SYNTAX ($1, i, $2);
1657 $$ = MAKE_SYNTAX (add_lyrics, @$, $$, scm_reverse_x ($3, SCM_EOL));
1659 | context_prefix contextable_music
1661 $$ = FINISH_MAKE_SYNTAX ($1, @$, $2);
1663 | context_prefix contexted_basic_music
1665 $$ = FINISH_MAKE_SYNTAX ($1, @$, $2);
1670 basic_music %prec COMPOSITE
1671 | contexted_basic_music
1672 | basic_music new_lyrics
1674 $$ = MAKE_SYNTAX (add_lyrics, @$, $1, scm_reverse_x ($2, SCM_EOL));
1681 | grouped_music_list
1685 simultaneous_music { $$ = $1; }
1686 | sequential_music { $$ = $1; }
1689 /* Function argument lists are arguably the most complex part in the
1690 * parser. They are pretty tricky to understand because of the way
1691 * they are processed, and because of optional arguments that can be
1692 * omitted. When there are several optional arguments in a row,
1693 * omitting one automatically omits all following arguments. Optional
1694 * arguments can only be omitted when either
1696 * a) the omission is explicitly started with \default
1697 * b) the omission is implicitly started by an argument not matching
1698 * its predicate, and there is a mandatory argument later that can
1699 * "catch" the argument that does not fit.
1701 * When argument parsing starts, the lexer pushes EXPECT_SCM tokens
1702 * (corresponding to mandatory arguments and having a predicate
1703 * function as semantic value) or EXPECT_OPTIONAL EXPECT_SCM (where
1704 * the semantic value of the EXPECT_OPTIONAL token is the default to
1705 * use when the optional argument is omitted, and EXPECT_SCM again has
1706 * the argument predicate as semantic value) in reverse order to the
1707 * parser, followed by EXPECT_NO_MORE_ARGS. The argument list is then
1708 * processed inside-out while actual tokens are consumed.
1710 * This means that the argument list tokens determine the actions
1711 * taken as they arrive. The structure of the argument list is known
1712 * to the parser and stored in its parse stack when the first argument
1713 * is being parsed. What the parser does not know is which predicates
1714 * will match and whether or not \default will be appearing in the
1715 * argument list, and where.
1717 * Sequences of 0 or more optional arguments are scanned using either
1718 * function_arglist_backup or function_arglist_nonbackup. The first
1719 * is used when optional arguments are followed by at least one
1720 * mandatory argument: in that case optional arguments may be skipped
1721 * by either a false predicate (in which case the expression will be
1722 * pushed back as one or more tokens, preceded by a BACKUP token) or
1723 * by using \default.
1725 * If optional arguments are at the end of the argument list, they are
1726 * instead scanned using function_arglist_nonbackup: here the only
1727 * manner to enter into skipping of optional arguments is the use of
1730 * The argument list of a normal function call is parsed using
1731 * function_arglist. The part of an argument list before a mandatory
1732 * argument is parsed using function_arglist_optional.
1734 * The difference is that leading optional arguments are scanned using
1735 * function_arglist_nonbackup and function_arglist_backup,
1738 * Most other details are obvious in the rules themselves.
1744 | SYMBOL_LIST '.' symbol_list_rev
1746 $$ = scm_append (scm_list_2 ($1, scm_reverse_x ($3, SCM_EOL)));
1748 | SYMBOL_LIST ',' symbol_list_rev
1750 $$ = scm_append (scm_list_2 ($1, scm_reverse_x ($3, SCM_EOL)));
1756 | symbol_list_rev '.' symbol_list_part
1758 $$ = scm_append_x (scm_list_2 ($3, $1));
1760 | symbol_list_rev ',' symbol_list_part
1762 $$ = scm_append_x (scm_list_2 ($3, $1));
1766 // symbol_list_part delivers elements in reverse copy, no lookahead
1769 symbol_list_part_bare
1772 $$ = make_reverse_key_list ($1);
1773 if (SCM_UNBNDP ($$)) {
1774 parser->parser_error (@1, _("not a key"));
1781 symbol_list_element:
1784 $$ = scm_string_to_symbol ($1);
1790 symbol_list_part_bare:
1793 $$ = try_word_variants (Lily::key_list_p, $1);
1794 if (SCM_UNBNDP ($$)) {
1795 parser->parser_error (@1, _("not a key"));
1798 $$ = scm_reverse ($$);
1800 | symbol_list_element
1802 $$ = scm_list_1 ($1);
1806 function_arglist_nonbackup:
1807 function_arglist_common
1808 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_nonbackup post_event_nofinger
1810 $$ = check_scheme_arg (parser, @4, $4, $3, $2);
1812 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_nonbackup '-' UNSIGNED
1814 SCM n = scm_difference ($5, SCM_UNDEFINED);
1815 if (scm_is_true (scm_call_1 ($2, n)))
1816 $$ = scm_cons (n, $3);
1818 Music *t = MY_MAKE_MUSIC ("FingeringEvent", @5);
1819 t->set_property ("digit", $5);
1820 $$ = check_scheme_arg (parser, @4, t->unprotect (),
1824 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_nonbackup '-' REAL
1826 $$ = check_scheme_arg (parser, @4,
1827 scm_difference ($5, SCM_UNDEFINED),
1830 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_nonbackup '-' NUMBER_IDENTIFIER
1832 $$ = check_scheme_arg (parser, @4,
1833 scm_difference ($5, SCM_UNDEFINED),
1836 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_nonbackup embedded_scm_arg
1838 if (scm_is_true (scm_call_1 ($2, $4)))
1839 $$ = scm_cons ($4, $3);
1841 $$ = check_scheme_arg (parser, @4,
1842 make_music_from_simple
1846 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_nonbackup bare_number_common
1848 $$ = check_scheme_arg (parser, @4, $4, $3, $2);
1850 | function_arglist_nonbackup_reparse REPARSE pitch_or_music
1852 if (scm_is_true (scm_call_1 ($2, $3)))
1853 $$ = scm_cons ($3, $1);
1855 $$ = check_scheme_arg (parser, @3,
1856 make_music_from_simple
1860 | function_arglist_nonbackup_reparse REPARSE multiplied_duration
1862 $$ = check_scheme_arg (parser, @3, $3, $1, $2);
1864 | function_arglist_nonbackup_reparse REPARSE reparsed_rhythm
1866 $$ = check_scheme_arg (parser, @3, $3, $1, $2);
1868 | function_arglist_nonbackup_reparse REPARSE bare_number_common
1870 $$ = check_scheme_arg (parser, @3, $3, $1, $2);
1872 | function_arglist_nonbackup_reparse REPARSE SCM_ARG
1874 $$ = check_scheme_arg (parser, @3, $3, $1, $2);
1876 | function_arglist_nonbackup_reparse REPARSE lyric_element_music
1878 $$ = check_scheme_arg (parser, @3, $3, $1, $2);
1880 | function_arglist_nonbackup_reparse REPARSE symbol_list_arg
1882 $$ = check_scheme_arg (parser, @3, $3, $1, $2);
1888 DURATION_ARG dots multipliers post_events
1890 $$ = make_music_from_simple (parser, @$,
1891 make_duration ($1, scm_to_int ($2), $3));
1892 Music *m = unsmob<Music> ($$);
1894 if (scm_is_pair ($4))
1895 m->set_property ("articulations",
1896 scm_reverse_x ($4, SCM_EOL));
1900 function_arglist_nonbackup_reparse:
1901 EXPECT_OPTIONAL EXPECT_SCM function_arglist_nonbackup SCM_IDENTIFIER
1904 SCM res = try_string_variants ($2, $4);
1905 if (!SCM_UNBNDP (res))
1906 if (scm_is_pair (res))
1907 MYREPARSE (@4, $2, SYMBOL_LIST, res);
1909 MYREPARSE (@4, $2, SCM_ARG, res);
1910 else if (scm_is_true
1912 ($2, make_music_from_simple
1914 MYREPARSE (@4, $2, STRING, $4);
1916 MYREPARSE (@4, $2, SCM_ARG, $4);
1918 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_nonbackup pitch
1923 ($2, make_music_from_simple
1925 MYREPARSE (@4, $2, PITCH_IDENTIFIER, $4);
1927 MYREPARSE (@4, $2, SCM_ARG, $4);
1929 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_nonbackup steno_tonic_pitch
1934 ($2, make_music_from_simple
1936 MYREPARSE (@4, $2, TONICNAME_PITCH, $4);
1938 MYREPARSE (@4, $2, SCM_ARG, $4);
1940 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_nonbackup STRING
1943 SCM res = try_string_variants ($2, $4);
1944 if (!SCM_UNBNDP (res))
1945 if (scm_is_pair (res))
1946 MYREPARSE (@4, $2, SYMBOL_LIST, res);
1948 MYREPARSE (@4, $2, SCM_ARG, res);
1949 else if (scm_is_true
1951 ($2, make_music_from_simple
1953 MYREPARSE (@4, $2, STRING, $4);
1955 MYREPARSE (@4, $2, SCM_ARG, $4);
1957 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_nonbackup SYMBOL
1960 SCM res = try_word_variants ($2, $4);
1961 if (!SCM_UNBNDP (res))
1962 if (scm_is_pair (res))
1963 MYREPARSE (@4, $2, SYMBOL_LIST, res);
1965 MYREPARSE (@4, $2, SCM_ARG, res);
1966 else if (scm_is_true
1968 ($2, make_music_from_simple
1970 MYREPARSE (@4, $2, STRING, $4);
1972 MYREPARSE (@4, $2, SCM_ARG, $4);
1974 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_nonbackup full_markup
1977 if (scm_is_true (scm_call_1 ($2, $4)))
1978 MYREPARSE (@4, $2, SCM_ARG, $4);
1979 else if (scm_is_true
1981 ($2, make_music_from_simple
1983 MYREPARSE (@4, $2, STRING, $4);
1985 MYREPARSE (@4, $2, SCM_ARG, $4);
1987 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_nonbackup UNSIGNED
1990 if (scm_is_true (scm_call_1 ($2, $4)))
1991 // May be 3 \cm or similar
1992 MYREPARSE (@4, $2, REAL, $4);
1993 else if (scm_is_true (scm_call_1 ($2, scm_list_1 ($4))))
1994 MYREPARSE (@4, $2, SYMBOL_LIST, scm_list_1 ($4));
1996 SCM d = make_duration ($4);
1997 if (!SCM_UNBNDP (d)) {
1998 if (scm_is_true (scm_call_1 ($2, d)))
1999 MYREPARSE (@4, $2, DURATION_IDENTIFIER, d);
2000 else if (scm_is_true
2002 ($2, make_music_from_simple (parser, @4, d))))
2003 MYREPARSE (@4, $2, DURATION_ARG, d);
2005 MYREPARSE (@4, $2, SCM_ARG, $4); // trigger error
2007 MYREPARSE (@4, $2, SCM_ARG, $4); // trigger error
2010 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_nonbackup DURATION_IDENTIFIER
2013 if (scm_is_true (scm_call_1 ($2, $4)))
2014 MYREPARSE (@4, $2, DURATION_IDENTIFIER, $4);
2015 else if (scm_is_true
2017 ($2, make_music_from_simple (parser, @4, $4))))
2018 MYREPARSE (@4, $2, DURATION_ARG, $4);
2020 MYREPARSE (@4, $2, SCM_ARG, $4); // trigger error
2025 // function_arglist_backup can't occur at the end of an argument
2027 function_arglist_backup:
2028 function_arglist_common
2029 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_backup embedded_scm_arg
2031 if (scm_is_true (scm_call_1 ($2, $4)))
2032 $$ = scm_cons ($4, $3);
2034 $$ = make_music_from_simple (parser, @4, $4);
2035 if (scm_is_true (scm_call_1 ($2, $$)))
2036 $$ = scm_cons ($$, $3);
2039 $$ = scm_cons (loc_on_copy (parser, @3, $1), $3);
2040 MYBACKUP (SCM_ARG, $4, @4);
2044 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_backup post_event_nofinger
2046 if (scm_is_true (scm_call_1 ($2, $4)))
2048 $$ = scm_cons ($4, $3);
2050 $$ = scm_cons (loc_on_copy (parser, @3, $1), $3);
2051 MYBACKUP (EVENT_IDENTIFIER, $4, @4);
2054 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_backup pitch
2058 ($2, make_music_from_simple
2062 MYREPARSE (@4, $2, PITCH_IDENTIFIER, $4);
2063 } else if (scm_is_true (scm_call_1 ($2, $4)))
2064 $$ = scm_cons ($4, $3);
2066 $$ = scm_cons (loc_on_copy (parser, @3, $1), $3);
2067 MYBACKUP (PITCH_IDENTIFIER, $4, @4);
2070 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_backup steno_tonic_pitch
2074 ($2, make_music_from_simple
2078 MYREPARSE (@4, $2, TONICNAME_PITCH, $4);
2079 } else if (scm_is_true (scm_call_1 ($2, $4)))
2080 $$ = scm_cons ($4, $3);
2082 $$ = scm_cons (loc_on_copy (parser, @3, $1), $3);
2083 MYBACKUP (TONICNAME_PITCH, $4, @4);
2086 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_backup full_markup
2088 if (scm_is_true (scm_call_1 ($2, $4)))
2089 $$ = scm_cons ($4, $3);
2091 $$ = scm_cons (loc_on_copy (parser, @3, $1), $3);
2092 MYBACKUP (SCM_IDENTIFIER, $4, @4);
2095 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_backup UNSIGNED
2098 if (scm_is_true (scm_call_1 ($2, $4)))
2099 // May be 3 \cm or similar
2100 MYREPARSE (@4, $2, REAL, $4);
2101 else if (scm_is_true (scm_call_1 ($2, scm_list_1 ($4))))
2102 MYREPARSE (@4, $2, SYMBOL_LIST, scm_list_1 ($4));
2104 SCM d = make_duration ($4);
2105 if (!SCM_UNBNDP (d)) {
2106 if (scm_is_true (scm_call_1 ($2, d)))
2107 MYREPARSE (@4, $2, DURATION_IDENTIFIER, d);
2108 else if (scm_is_true
2110 ($2, make_music_from_simple (parser, @4, d))))
2111 MYREPARSE (@4, $2, DURATION_ARG, d);
2113 $$ = scm_cons (loc_on_copy (parser, @3, $1), $3);
2114 MYBACKUP (UNSIGNED, $4, @4);
2117 $$ = scm_cons (loc_on_copy (parser, @3, $1), $3);
2118 MYBACKUP (UNSIGNED, $4, @4);
2122 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_backup REAL
2124 if (scm_is_true (scm_call_1 ($2, $4)))
2127 MYREPARSE (@4, $2, REAL, $4);
2129 $$ = scm_cons (loc_on_copy (parser, @3, $1), $3);
2130 MYBACKUP (REAL, $4, @4);
2133 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_backup NUMBER_IDENTIFIER
2135 if (scm_is_true (scm_call_1 ($2, $4)))
2137 $$ = scm_cons ($4, $3);
2139 $$ = scm_cons (loc_on_copy (parser, @3, $1), $3);
2140 MYBACKUP (NUMBER_IDENTIFIER, $4, @4);
2143 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_backup '-' UNSIGNED
2145 SCM n = scm_difference ($5, SCM_UNDEFINED);
2146 if (scm_is_true (scm_call_1 ($2, n))) {
2148 MYREPARSE (@5, $2, REAL, n);
2150 Music *t = MY_MAKE_MUSIC ("FingeringEvent", @5);
2151 t->set_property ("digit", $5);
2152 $$ = t->unprotect ();
2153 if (scm_is_true (scm_call_1 ($2, $$)))
2154 $$ = scm_cons ($$, $3);
2156 $$ = scm_cons (loc_on_copy (parser, @3, $1), $3);
2157 MYBACKUP (UNSIGNED, $5, @5);
2158 parser->lexer_->push_extra_token (@4, '-');
2162 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_backup '-' REAL
2164 SCM n = scm_difference ($5, SCM_UNDEFINED);
2165 if (scm_is_true (scm_call_1 ($2, n))) {
2166 MYREPARSE (@5, $2, REAL, n);
2169 $$ = scm_cons (loc_on_copy (parser, @3, $1), $3);
2170 MYBACKUP (REAL, n, @5);
2173 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_backup '-' NUMBER_IDENTIFIER
2175 SCM n = scm_difference ($5, SCM_UNDEFINED);
2176 if (scm_is_true (scm_call_1 ($2, n))) {
2177 $$ = scm_cons (n, $3);
2179 $$ = scm_cons (loc_on_copy (parser, @3, $1), $3);
2180 MYBACKUP (NUMBER_IDENTIFIER, n, @5);
2183 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_backup DURATION_IDENTIFIER
2186 if (scm_is_true (scm_call_1 ($2, $4)))
2187 MYREPARSE (@4, $2, DURATION_IDENTIFIER, $4);
2188 else if (scm_is_true
2190 ($2, make_music_from_simple (parser, @4, $4))))
2191 MYREPARSE (@4, $2, DURATION_ARG, $4);
2193 $$ = scm_cons (loc_on_copy (parser, @3, $1), $3);
2194 MYBACKUP (DURATION_IDENTIFIER, $4, @4);
2197 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_backup SCM_IDENTIFIER
2199 SCM res = try_string_variants ($2, $4);
2200 if (!SCM_UNBNDP (res))
2201 if (scm_is_pair (res)) {
2203 MYREPARSE (@4, $2, SYMBOL_LIST, res);
2206 $$ = scm_cons (res, $3);
2208 $$ = scm_cons (loc_on_copy (parser, @3, $1), $3);
2209 MYBACKUP (SCM_IDENTIFIER, $4, @4);
2212 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_backup STRING
2214 SCM res = try_string_variants ($2, $4);
2215 if (!SCM_UNBNDP (res))
2216 if (scm_is_pair (res)) {
2218 MYREPARSE (@4, $2, SYMBOL_LIST, res);
2221 $$ = scm_cons (res, $3);
2223 $$ = scm_cons (loc_on_copy (parser, @3, $1), $3);
2224 MYBACKUP (STRING, $4, @4);
2227 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_backup SYMBOL
2229 SCM res = try_word_variants ($2, $4);
2230 if (!SCM_UNBNDP (res))
2231 if (scm_is_pair (res)) {
2233 MYREPARSE (@4, $2, SYMBOL_LIST, res);
2236 $$ = scm_cons (res, $3);
2238 $$ = scm_cons (loc_on_copy (parser, @3, $1), $3);
2239 MYBACKUP (STRING, $4, @4);
2242 | function_arglist_backup REPARSE pitch_or_music
2244 if (scm_is_true (scm_call_1 ($2, $3)))
2245 $$ = scm_cons ($3, $1);
2247 $$ = check_scheme_arg (parser, @3,
2248 make_music_from_simple
2252 | function_arglist_backup REPARSE bare_number_common
2254 $$ = check_scheme_arg (parser, @3,
2257 | function_arglist_backup REPARSE multiplied_duration
2259 $$ = check_scheme_arg (parser, @3,
2262 | function_arglist_backup REPARSE reparsed_rhythm
2264 $$ = check_scheme_arg (parser, @3,
2267 | function_arglist_backup REPARSE symbol_list_arg
2269 $$ = check_scheme_arg (parser, @3, $3, $1, $2);
2274 function_arglist_nonbackup
2275 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_skip_nonbackup DEFAULT
2277 $$ = scm_cons (loc_on_copy (parser, @4, $1), $3);
2281 function_arglist_skip_nonbackup:
2282 function_arglist_nonbackup
2283 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_skip_nonbackup
2285 $$ = scm_cons (loc_on_copy (parser, @3, $1), $3);
2289 // Partial function arglists are returned just in their incomplete
2290 // state: when combined with the music function, the missing parts of
2291 // the signature can be reconstructed
2293 // To serve as a partial arglist, the argument list must absolutely
2294 // _not_ be in "skipping optional arguments" mode since then there is
2295 // some backup token that has nowhere to go before \etc.
2297 // So we can skim off an arbitrary number of arguments from the end of
2298 // the argument list. The argument list remaining afterwards has to
2299 // be in not-skipping-optional-arguments mode.
2301 function_arglist_partial:
2302 EXPECT_SCM function_arglist_optional
2306 | EXPECT_SCM function_arglist_partial_optional
2310 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_nonbackup
2314 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_partial
2320 function_arglist_partial_optional:
2321 EXPECT_SCM function_arglist_optional
2325 | EXPECT_SCM function_arglist_partial_optional
2329 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_backup
2333 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_partial_optional
2339 function_arglist_common:
2340 EXPECT_NO_MORE_ARGS {
2343 | EXPECT_SCM function_arglist_optional embedded_scm_arg
2345 if (scm_is_true (scm_call_1 ($1, $3)))
2346 $$ = scm_cons ($3, $2);
2348 $$ = check_scheme_arg (parser, @3,
2349 make_music_from_simple
2353 | EXPECT_SCM function_arglist_optional bare_number_common
2355 $$ = check_scheme_arg (parser, @3,
2358 | EXPECT_SCM function_arglist_optional post_event_nofinger
2360 $$ = check_scheme_arg (parser, @3,
2363 | EXPECT_SCM function_arglist_optional '-' NUMBER_IDENTIFIER
2365 SCM n = scm_difference ($4, SCM_UNDEFINED);
2366 $$ = check_scheme_arg (parser, @4, n, $2, $1);
2368 | function_arglist_common_reparse REPARSE SCM_ARG
2370 $$ = check_scheme_arg (parser, @3,
2373 | function_arglist_common_reparse REPARSE lyric_element_music
2375 $$ = check_scheme_arg (parser, @3,
2378 | function_arglist_common_reparse REPARSE pitch_or_music
2380 if (scm_is_true (scm_call_1 ($2, $3)))
2381 $$ = scm_cons ($3, $1);
2383 $$ = check_scheme_arg (parser, @3,
2384 make_music_from_simple
2388 | function_arglist_common_reparse REPARSE bare_number_common
2390 $$ = check_scheme_arg (parser, @3,
2393 | function_arglist_common_reparse REPARSE multiplied_duration
2395 $$ = check_scheme_arg (parser, @3,
2398 | function_arglist_common_reparse REPARSE reparsed_rhythm
2400 $$ = check_scheme_arg (parser, @3,
2403 | function_arglist_common_reparse REPARSE symbol_list_arg
2405 $$ = check_scheme_arg (parser, @3, $3, $1, $2);
2409 function_arglist_common_reparse:
2410 EXPECT_SCM function_arglist_optional SCM_IDENTIFIER
2413 SCM res = try_string_variants ($1, $3);
2414 if (!SCM_UNBNDP (res))
2415 if (scm_is_pair (res))
2416 MYREPARSE (@3, $1, SYMBOL_LIST, res);
2418 MYREPARSE (@3, $1, SCM_ARG, res);
2419 else if (scm_is_true
2421 ($1, make_music_from_simple (parser, @3, $3))))
2422 MYREPARSE (@3, $1, LYRIC_ELEMENT, $3);
2424 // This is going to flag a syntax error, we
2425 // know the predicate to be false.
2426 MYREPARSE (@3, $1, SCM_ARG, $3);
2428 | EXPECT_SCM function_arglist_optional pitch
2433 ($1, make_music_from_simple
2435 MYREPARSE (@3, $1, PITCH_IDENTIFIER, $3);
2437 MYREPARSE (@3, $1, SCM_ARG, $3);
2439 | EXPECT_SCM function_arglist_optional steno_tonic_pitch
2444 ($1, make_music_from_simple
2446 MYREPARSE (@3, $1, TONICNAME_PITCH, $3);
2448 MYREPARSE (@3, $1, SCM_ARG, $3);
2450 | EXPECT_SCM function_arglist_optional STRING
2453 SCM res = try_string_variants ($1, $3);
2454 if (!SCM_UNBNDP (res))
2455 if (scm_is_pair (res))
2456 MYREPARSE (@3, $1, SYMBOL_LIST, res);
2458 MYREPARSE (@3, $1, SCM_ARG, res);
2459 else if (scm_is_true
2461 ($1, make_music_from_simple (parser, @3, $3))))
2462 MYREPARSE (@3, $1, LYRIC_ELEMENT, $3);
2464 // This is going to flag a syntax error, we
2465 // know the predicate to be false.
2466 MYREPARSE (@3, $1, SCM_ARG, $3);
2468 | EXPECT_SCM function_arglist_optional SYMBOL
2471 SCM res = try_word_variants ($1, $3);
2472 if (!SCM_UNBNDP (res))
2473 if (scm_is_pair (res))
2474 MYREPARSE (@3, $1, SYMBOL_LIST, res);
2476 MYREPARSE (@3, $1, SCM_ARG, res);
2477 else if (scm_is_true
2479 ($1, make_music_from_simple (parser, @3, $3))))
2480 MYREPARSE (@3, $1, LYRIC_ELEMENT, $3);
2482 // This is going to flag a syntax error, we
2483 // know the predicate to be false.
2484 MYREPARSE (@3, $1, SCM_ARG, $3);
2486 | EXPECT_SCM function_arglist_optional full_markup
2489 if (scm_is_true (scm_call_1 ($1, $3)))
2490 MYREPARSE (@3, $1, SCM_ARG, $3);
2491 else if (scm_is_true
2493 ($1, make_music_from_simple (parser, @3, $3))))
2494 MYREPARSE (@3, $1, LYRIC_ELEMENT, $3);
2496 // This is going to flag a syntax error, we
2497 // know the predicate to be false.
2498 MYREPARSE (@3, $1, SCM_ARG, $3);
2500 | EXPECT_SCM function_arglist_optional UNSIGNED
2503 if (scm_is_true (scm_call_1 ($1, $3)))
2504 // May be 3 \cm or similar
2505 MYREPARSE (@3, $1, REAL, $3);
2506 else if (scm_is_true (scm_call_1 ($1, scm_list_1 ($3))))
2507 MYREPARSE (@3, $1, SYMBOL_LIST, scm_list_1 ($3));
2509 SCM d = make_duration ($3);
2510 if (!SCM_UNBNDP (d)) {
2511 if (scm_is_true (scm_call_1 ($1, d)))
2512 MYREPARSE (@3, $1, DURATION_IDENTIFIER, d);
2513 else if (scm_is_true
2515 ($1, make_music_from_simple (parser, @3, d))))
2516 MYREPARSE (@3, $1, DURATION_ARG, d);
2518 MYREPARSE (@3, $1, SCM_ARG, $3); // trigger error
2520 MYREPARSE (@3, $1, SCM_ARG, $3); // trigger error
2523 | EXPECT_SCM function_arglist_optional DURATION_IDENTIFIER
2526 if (scm_is_true (scm_call_1 ($1, $3)))
2527 MYREPARSE (@3, $1, DURATION_IDENTIFIER, $3);
2528 else if (scm_is_true
2530 ($1, make_music_from_simple (parser, @3, $3))))
2531 MYREPARSE (@3, $1, DURATION_ARG, $3);
2533 MYREPARSE (@3, $1, SCM_ARG, $3); // trigger error
2535 | EXPECT_SCM function_arglist_optional '-' UNSIGNED
2538 SCM n = scm_difference ($4, SCM_UNDEFINED);
2539 if (scm_is_true (scm_call_1 ($1, n)))
2540 MYREPARSE (@4, $1, REAL, n);
2542 Music *t = MY_MAKE_MUSIC ("FingeringEvent", @4);
2543 t->set_property ("digit", $4);
2544 SCM m = t->unprotect ();
2545 if (scm_is_true (scm_call_1 ($1, m)))
2546 MYREPARSE (@4, $1, SCM_ARG, m);
2548 MYREPARSE (@4, $1, SCM_ARG, $4);
2551 | EXPECT_SCM function_arglist_optional '-' REAL
2554 SCM n = scm_difference ($4, SCM_UNDEFINED);
2555 MYREPARSE (@4, $1, REAL, n);
2559 function_arglist_optional:
2560 function_arglist_backup
2561 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_skip_backup DEFAULT
2563 $$ = scm_cons (loc_on_copy (parser, @4, $1), $3);
2565 | function_arglist_skip_backup BACKUP
2568 function_arglist_skip_backup:
2569 function_arglist_backup
2570 | EXPECT_OPTIONAL EXPECT_SCM function_arglist_skip_backup
2572 $$ = scm_cons (loc_on_copy (parser, @3, $1), $3);
2576 music_function_call:
2577 MUSIC_FUNCTION function_arglist {
2578 $$ = MAKE_SYNTAX (music_function, @$,
2585 /**/ { $$ = SCM_EOL; }
2586 | '=' simple_string {
2591 // We must not have lookahead tokens parsed in lyric mode. In order
2592 // to save confusion, we take almost the same set as permitted with
2593 // \lyricmode and/or \lyrics. However, music identifiers are also
2594 // allowed, and they obviously do not require switching into lyrics
2595 // mode for parsing.
2599 parser->lexer_->push_lyric_state ();
2600 } grouped_music_list
2602 parser->lexer_->pop_state ();
2609 mode_changing_head grouped_music_list {
2610 if (scm_is_eq ($1, ly_symbol2scm ("chords")))
2612 $$ = MAKE_SYNTAX (unrelativable_music, @$, $2);
2618 parser->lexer_->pop_state ();
2620 | mode_changing_head_with_context optional_context_mods grouped_music_list {
2621 $$ = MAKE_SYNTAX (context_specification, @$, $1, SCM_EOL, $2, SCM_BOOL_T, $3);
2622 if (scm_is_eq ($1, ly_symbol2scm ("ChordNames")))
2624 $$ = MAKE_SYNTAX (unrelativable_music, @$, $$);
2626 parser->lexer_->pop_state ();
2632 parser->lexer_->push_note_state (Lily::pitchnames);
2634 $$ = ly_symbol2scm ("notes");
2638 parser->lexer_->push_note_state (Lily::drum_pitch_names);
2640 $$ = ly_symbol2scm ("drums");
2643 parser->lexer_->push_figuredbass_state ();
2645 $$ = ly_symbol2scm ("figures");
2648 parser->lexer_->chordmodifier_tab_ =
2649 alist_to_hashq (Lily::chordmodifiers);
2650 parser->lexer_->push_chord_state (Lily::pitchnames);
2651 $$ = ly_symbol2scm ("chords");
2655 { parser->lexer_->push_lyric_state ();
2656 $$ = ly_symbol2scm ("lyrics");
2660 mode_changing_head_with_context:
2662 parser->lexer_->push_note_state (Lily::drum_pitch_names);
2664 $$ = ly_symbol2scm ("DrumStaff");
2667 parser->lexer_->push_figuredbass_state ();
2669 $$ = ly_symbol2scm ("FiguredBass");
2672 parser->lexer_->chordmodifier_tab_ =
2673 alist_to_hashq (Lily::chordmodifiers);
2674 parser->lexer_->push_chord_state (Lily::pitchnames);
2675 $$ = ly_symbol2scm ("ChordNames");
2678 { parser->lexer_->push_lyric_state ();
2679 $$ = ly_symbol2scm ("Lyrics");
2684 CHANGE symbol '=' simple_string {
2685 $$ = MAKE_SYNTAX (context_change, @$, $2, $4);
2692 $$ = scm_reverse_x ($1, SCM_EOL);
2698 $$ = scm_list_3 (ly_symbol2scm ("assign"), $1, $3);
2701 $$ = scm_list_2 (ly_symbol2scm ("unset"), $2);
2703 | OVERRIDE revert_arg '=' scalar {
2704 if (scm_ilength ($2) < 2) {
2705 parser->parser_error (@2, _("bad grob property path"));
2708 $$ = scm_cons (ly_symbol2scm ("push"),
2709 scm_cons2 (scm_car ($2),
2714 | REVERT revert_arg {
2715 $$ = scm_cons (ly_symbol2scm ("pop"), $2);
2719 // This is all quite awkward for the sake of substantial backward
2720 // compatibility while at the same time allowing a more "natural" form
2721 // of specification not separating grob specification from grob
2722 // property path. The purpose of this definition of revert_arg is to
2723 // allow the symbol list which specifies grob and property to revert
2724 // to be optionally be split into two parts after the grob (which in
2725 // this case is just the first element of the list). symbol_list_part
2726 // is only one path component, but it can be parsed without lookahead,
2727 // so we can follow it with a synthetic BACKUP token when needed. If
2728 // the first symbol_list_part already contains multiple elements (only
2729 // possible if a Scheme expression provides them), we just parse for
2730 // additional elements introduced by '.', which is what the
2731 // SYMBOL_LIST backup in connection with the immediately following
2732 // rule using symbol_list_arg does.
2734 // As long as we don't have our coffers filled with both grob and at
2735 // least one grob property specification, the rest of the required
2736 // symbol list chain may be provided either with or without a leading
2737 // dot. This is for both allowing the traditional
2738 // \revert Accidental #'color
2739 // as well as well as the "naive" form
2740 // \revert Accidental.color
2743 revert_arg_backup BACKUP symbol_list_arg
2752 if (scm_is_null ($1)
2753 || scm_is_null (scm_cdr ($1)))
2754 MYBACKUP (SCM_ARG, $1, @1);
2756 MYBACKUP (SYMBOL_LIST, scm_reverse_x ($1, SCM_EOL), @1);
2760 // revert_arg_part delivers results in reverse
2763 | revert_arg_backup BACKUP SCM_ARG '.' symbol_list_part
2765 $$ = scm_append_x (scm_list_2 ($5, $3));
2767 | revert_arg_backup BACKUP SCM_ARG ',' symbol_list_part
2769 $$ = scm_append_x (scm_list_2 ($5, $3));
2771 | revert_arg_backup BACKUP SCM_ARG symbol_list_part
2773 $$ = scm_append_x (scm_list_2 ($4, $3));
2778 CONSISTS { $$ = ly_symbol2scm ("consists"); }
2779 | REMOVE { $$ = ly_symbol2scm ("remove"); }
2781 | ACCEPTS { $$ = ly_symbol2scm ("accepts"); }
2782 | DEFAULTCHILD { $$ = ly_symbol2scm ("default-child"); }
2783 | DENIES { $$ = ly_symbol2scm ("denies"); }
2785 | ALIAS { $$ = ly_symbol2scm ("alias"); }
2786 | TYPE { $$ = ly_symbol2scm ("translator-type"); }
2787 | DESCRIPTION { $$ = ly_symbol2scm ("description"); }
2788 | NAME { $$ = ly_symbol2scm ("context-name"); }
2792 property_operation { $$ = $1; }
2793 | context_def_mod STRING {
2794 $$ = scm_list_2 ($1, $2);
2796 | context_def_mod SYMBOL {
2797 $$ = scm_list_2 ($1, $2);
2799 | context_def_mod embedded_scm
2801 if (!scm_is_string ($2)
2802 && !scm_is_eq ($1, ly_symbol2scm ("consists"))
2803 && !scm_is_eq ($1, ly_symbol2scm ("remove")))
2806 parser->parser_error (@1, _ ("only \\consists and \\remove take non-string argument."));
2810 $$ = scm_list_2 ($1, $2);
2815 // If defined, at least two members.
2819 SCM l = scm_reverse_x ($1, SCM_EOL);
2822 (scm_object_property (scm_car (l),
2823 ly_symbol2scm ("is-grob?"))))
2824 l = scm_cons (ly_symbol2scm ("Bottom"), l);
2825 if (scm_is_null (l) || scm_is_null (scm_cdr (l))) {
2826 parser->parser_error (@1, _ ("bad grob property path"));
2833 // If defined, at least three members
2837 if (!SCM_UNBNDP ($1) && scm_is_null (scm_cddr ($1)))
2839 parser->parser_error (@1, _ ("bad grob property path"));
2843 | grob_prop_spec property_path
2845 if (!SCM_UNBNDP ($1)) {
2846 $$ = scm_append_x (scm_list_2 ($1, $2));
2847 if (scm_is_null (scm_cddr ($$))) {
2848 parser->parser_error (@$, _ ("bad grob property path"));
2856 // Exactly two elements or undefined
2860 SCM l = scm_reverse_x ($1, SCM_EOL);
2861 switch (scm_ilength (l)) {
2863 l = scm_cons (ly_symbol2scm ("Bottom"), l);
2867 parser->parser_error (@1, _ ("bad context property path"));
2875 // This is all quite awkward for the sake of substantial backward
2876 // compatibility while at the same time allowing a more "natural" form
2877 // of specification not separating grob specification from grob
2878 // property path. The purpose of this definition of
2879 // simple_revert_context is to allow the symbol list which specifies
2880 // grob and property to revert to be optionally be split into two
2881 // parts after the grob (which may be preceded by a context
2882 // specification, a case which we distinguish by checking whether the
2883 // first symbol is a valid grob symbol instead).
2885 // See revert_arg above for the main work horse of this arrangement.
2886 // simple_revert_context just caters for the context and delegates the
2887 // rest of the job to revert_arg.
2889 simple_revert_context:
2892 $1 = scm_reverse_x ($1, SCM_EOL);
2893 if (scm_is_null ($1)
2895 (scm_object_property (scm_car ($1),
2896 ly_symbol2scm ("is-grob?")))) {
2897 $$ = ly_symbol2scm ("Bottom");
2898 parser->lexer_->push_extra_token (@1, SCM_IDENTIFIER, $1);
2901 parser->lexer_->push_extra_token (@1, SCM_IDENTIFIER,
2908 OVERRIDE grob_prop_path '=' scalar {
2909 if (SCM_UNBNDP ($2))
2910 $$ = MAKE_SYNTAX (void_music, @$);
2912 $$ = MAKE_SYNTAX (property_override, @$,
2917 | REVERT simple_revert_context revert_arg {
2918 $$ = MAKE_SYNTAX (property_revert, @$, $2, $3);
2920 | SET context_prop_spec '=' scalar {
2921 if (SCM_UNBNDP ($2))
2922 $$ = MAKE_SYNTAX (void_music, @$);
2924 $$ = MAKE_SYNTAX (property_set, @$,
2929 | UNSET context_prop_spec {
2930 if (SCM_UNBNDP ($2))
2931 $$ = MAKE_SYNTAX (void_music, @$);
2933 $$ = MAKE_SYNTAX (property_unset, @$,
2951 if (Text_interface::is_markup ($1)) {
2954 parser->parser_error (@1, (_ ("markup expected")));
2955 $$ = scm_string (SCM_EOL);
2960 simple_string: STRING
2964 if (scm_is_string ($1)) {
2967 parser->parser_error (@1, (_ ("simple string expected")));
2968 $$ = scm_string (SCM_EOL);
2975 $$ = scm_string_to_symbol ($1);
2979 if (!is_regular_identifier ($1, false))
2980 parser->parser_error (@1, (_ ("symbol expected")));
2981 $$ = scm_string_to_symbol ($1);
2985 // This is a bit of overkill but makes the same
2986 // routine responsible for all symbol interpretations.
2987 $$ = try_string_variants (Guile_user::symbol_p, $1);
2988 if (SCM_UNBNDP ($$))
2990 parser->parser_error (@1, (_ ("symbol expected")));
2991 // Generate a unique symbol in case it is used
2992 // for an assignment or similar
2993 $$ = scm_make_symbol (ly_string2scm ("undefined"));
3003 // The following is a rather defensive variant of admitting
3004 // negative numbers: the grammar would permit number_factor or
3005 // even number_expression. However, function arguments allow
3006 // only this simple kind of negative number, so to have things
3007 // like \tweak and \override behave reasonably similar, it
3008 // makes sense to rule out things like -- which are rather an
3009 // accent in function argument contexts.
3012 $$ = scm_difference ($2, SCM_UNDEFINED);
3015 | symbol_list_part_bare '.' property_path
3017 $$ = scm_reverse_x ($1, $3);
3019 | symbol_list_part_bare ',' property_path
3021 $$ = scm_reverse_x ($1, $3);
3026 simple_element post_events {
3027 // Let the rhythmic music iterator sort this mess out.
3028 if (scm_is_pair ($2)) {
3029 unsmob<Music> ($$)->set_property ("articulations",
3030 scm_reverse_x ($2, SCM_EOL));
3033 | CHORD_REPETITION optional_notemode_duration post_events {
3034 $$ = MAKE_SYNTAX (repetition_chord, @$,
3035 $2, scm_reverse_x ($3, SCM_EOL));
3037 | MULTI_MEASURE_REST optional_notemode_duration post_events {
3038 $$ = MAKE_SYNTAX (multi_measure_rest, @$, $2,
3039 scm_reverse_x ($3, SCM_EOL));
3042 | note_chord_element
3047 chord_body optional_notemode_duration post_events
3049 Music *m = unsmob<Music> ($1);
3050 SCM dur = unsmob<Duration> ($2)->smobbed_copy ();
3051 SCM es = m->get_property ("elements");
3052 SCM postevs = scm_reverse_x ($3, SCM_EOL);
3054 for (SCM s = es; scm_is_pair (s); s = scm_cdr (s))
3055 unsmob<Music> (scm_car (s))->set_property ("duration", dur);
3056 es = ly_append2 (es, postevs);
3058 m->set_property ("elements", es);
3059 m->set_spot (parser->lexer_->override_input (@$));
3060 $$ = m->self_scm ();
3065 ANGLE_OPEN chord_body_elements ANGLE_CLOSE
3067 $$ = MAKE_SYNTAX (event_chord, @$, scm_reverse_x ($2, SCM_EOL));
3069 | FIGURE_OPEN figure_list FIGURE_CLOSE
3071 $$ = MAKE_SYNTAX (event_chord, @$, scm_reverse_x ($2, SCM_EOL));
3075 chord_body_elements:
3076 /* empty */ { $$ = SCM_EOL; }
3077 | chord_body_elements chord_body_element {
3078 if (!SCM_UNBNDP ($2))
3079 $$ = scm_cons ($2, $1);
3084 pitch_or_tonic_pitch exclamations questions octave_check post_events
3086 bool q = to_boolean ($3);
3087 bool ex = to_boolean ($2);
3091 Music *n = MY_MAKE_MUSIC ("NoteEvent", @$);
3092 n->set_property ("pitch", $1);
3094 n->set_property ("cautionary", SCM_BOOL_T);
3096 n->set_property ("force-accidental", SCM_BOOL_T);
3098 if (scm_is_pair (post)) {
3099 SCM arts = scm_reverse_x (post, SCM_EOL);
3100 n->set_property ("articulations", arts);
3102 if (scm_is_number (check))
3104 int q = scm_to_int (check);
3105 n->set_property ("absolute-octave", scm_from_int (q-1));
3108 $$ = n->unprotect ();
3110 | DRUM_PITCH post_events {
3111 Music *n = MY_MAKE_MUSIC ("NoteEvent", @$);
3112 n->set_property ("drum-type", $1);
3114 if (scm_is_pair ($2)) {
3115 SCM arts = scm_reverse_x ($2, SCM_EOL);
3116 n->set_property ("articulations", arts);
3118 $$ = n->unprotect ();
3120 | music_function_chord_body
3122 Music *m = unsmob<Music> ($1);
3124 while (m && m->is_mus_type ("music-wrapper-music")) {
3125 $$ = m->get_property ("element");
3126 m = unsmob<Music> ($$);
3129 if (!(m && m->is_mus_type ("rhythmic-event"))) {
3130 parser->parser_error (@$, _ ("not a rhythmic event"));
3136 music_function_chord_body:
3142 event_function_event:
3143 EVENT_FUNCTION function_arglist {
3144 $$ = MAKE_SYNTAX (music_function, @$,
3153 | post_events post_event {
3155 if (Music *m = unsmob<Music> ($2))
3157 if (m->is_mus_type ("post-event-wrapper"))
3159 for (SCM p = m->get_property ("elements");
3163 $$ = scm_cons (scm_car (p), $$);
3166 m->set_spot (parser->lexer_->override_input (@2));
3167 $$ = scm_cons ($2, $$);
3173 post_event_nofinger:
3174 direction_less_event {
3177 | script_dir music_function_call {
3179 if (!unsmob<Music> ($2)->is_mus_type ("post-event")) {
3180 parser->parser_error (@2, _ ("post-event expected"));
3181 $$ = SCM_UNSPECIFIED;
3182 } else if (!SCM_UNBNDP ($1))
3184 unsmob<Music> ($$)->set_property ("direction", $1);
3188 if (!parser->lexer_->is_lyric_state ())
3189 parser->parser_error (@1, _ ("have to be in Lyric mode for lyrics"));
3190 $$ = MY_MAKE_MUSIC ("HyphenEvent", @$)->unprotect ();
3193 if (!parser->lexer_->is_lyric_state ())
3194 parser->parser_error (@1, _ ("have to be in Lyric mode for lyrics"));
3195 $$ = MY_MAKE_MUSIC ("ExtenderEvent", @$)->unprotect ();
3197 | script_dir direction_reqd_event {
3198 if (!SCM_UNBNDP ($1))
3200 Music *m = unsmob<Music> ($2);
3201 m->set_property ("direction", $1);
3205 | script_dir direction_less_event {
3206 if (!SCM_UNBNDP ($1))
3208 Music *m = unsmob<Music> ($2);
3209 m->set_property ("direction", $1);
3216 unsmob<Music> ($$)->set_property ("direction", scm_from_int (UP));
3221 unsmob<Music> ($$)->set_property ("direction", scm_from_int (DOWN));
3232 string_number_event:
3234 Music *s = MY_MAKE_MUSIC ("StringNumberEvent", @$);
3235 s->set_property ("string-number", $1);
3236 $$ = s->unprotect ();
3240 direction_less_event:
3242 | EVENT_IDENTIFIER {
3246 Music *a = MY_MAKE_MUSIC ("TremoloEvent", @$);
3247 a->set_property ("tremolo-type", $1);
3248 $$ = a->unprotect ();
3250 | event_function_event
3253 direction_reqd_event:
3257 | script_abbreviation {
3258 SCM s = parser->lexer_->lookup_identifier ("dash" + ly_scm2string ($1));
3259 if (scm_is_string (s)) {
3260 Music *a = MY_MAKE_MUSIC ("ArticulationEvent", @$);
3261 a->set_property ("articulation-type", s);
3262 $$ = a->unprotect ();
3264 Music *original = unsmob<Music> (s);
3265 if (original && original->is_mus_type ("post-event")) {
3266 Music *a = original->clone ();
3267 a->set_spot (parser->lexer_->override_input (@$));
3268 $$ = a->unprotect ();
3270 parser->parser_error (@1, _ ("expecting string or post-event as script definition"));
3271 $$ = MY_MAKE_MUSIC ("PostEvents", @$)->unprotect ();
3278 /**/ { $$ = SCM_EOL; }
3279 | '=' quotes { $$ = $2; }
3293 $$ = scm_from_int (1);
3296 $$ = scm_oneplus ($1);
3302 $$ = scm_from_int (-1);
3305 $$ = scm_oneminus ($1);
3310 NOTENAME_PITCH quotes {
3311 if (!scm_is_eq (SCM_INUM0, $2))
3313 Pitch p = *unsmob<Pitch> ($1);
3314 p = p.transposed (Pitch (scm_to_int ($2), 0));
3315 $$ = p.smobbed_copy ();
3325 TONICNAME_PITCH quotes {
3326 if (!scm_is_eq (SCM_INUM0, $2))
3328 Pitch p = *unsmob<Pitch> ($1);
3329 p = p.transposed (Pitch (scm_to_int ($2), 0));
3330 $$ = p.smobbed_copy ();
3337 | PITCH_IDENTIFIER quotes {
3338 if (!scm_is_eq (SCM_INUM0, $2))
3340 Pitch p = *unsmob<Pitch> ($1);
3341 p = p.transposed (Pitch (scm_to_int ($2), 0));
3342 $$ = p.smobbed_copy ();
3347 pitch_or_tonic_pitch:
3354 Music *t = MY_MAKE_MUSIC ("TextScriptEvent", @$);
3355 t->set_property ("text", $1);
3356 $$ = t->unprotect ();
3359 Music *t = MY_MAKE_MUSIC ("TextScriptEvent", @$);
3360 t->set_property ("text",
3361 make_simple_markup ($1));
3362 $$ = t->unprotect ();
3365 // Flag a warning? could be unintentional
3366 Music *t = MY_MAKE_MUSIC ("TextScriptEvent", @$);
3367 t->set_property ("text",
3368 make_simple_markup ($1));
3369 $$ = t->unprotect ();
3373 Music *m = unsmob<Music> ($1);
3374 if (m && m->is_mus_type ("post-event"))
3376 else if (Text_interface::is_markup ($1)) {
3377 Music *t = MY_MAKE_MUSIC ("TextScriptEvent", @$);
3378 t->set_property ("text", $1);
3379 $$ = t->unprotect ();
3381 parser->parser_error (@1, _ ("not an articulation"));
3387 Music *t = MY_MAKE_MUSIC ("FingeringEvent", @$);
3388 t->set_property ("digit", $1);
3389 $$ = t->unprotect ();
3393 script_abbreviation:
3395 $$ = scm_from_ascii_string ("Hat");
3398 $$ = scm_from_ascii_string ("Plus");
3401 $$ = scm_from_ascii_string ("Dash");
3404 $$ = scm_from_ascii_string ("Bang");
3407 $$ = scm_from_ascii_string ("Larger");
3410 $$ = scm_from_ascii_string ("Dot");
3413 $$ = scm_from_ascii_string ("Underscore");
3418 '_' { $$ = scm_from_int (DOWN); }
3419 | '^' { $$ = scm_from_int (UP); }
3420 | '-' { $$ = SCM_UNDEFINED; }
3423 maybe_notemode_duration:
3427 | multiplied_duration {
3429 parser->default_duration_ = *unsmob<Duration> ($$);
3434 optional_notemode_duration:
3435 maybe_notemode_duration
3437 if (SCM_UNBNDP ($$))
3438 $$ = parser->default_duration_.smobbed_copy ();
3444 $$ = make_duration ($1, scm_to_int ($2));
3445 if (SCM_UNBNDP ($$))
3447 parser->parser_error (@1, _ ("not a duration"));
3448 $$ = Duration ().smobbed_copy ();
3451 | DURATION_IDENTIFIER dots {
3452 $$ = make_duration ($1, scm_to_int ($2));
3456 multiplied_duration:
3457 steno_duration multipliers {
3458 $$ = make_duration ($1, 0, $2);
3467 $$ = scm_oneplus ($1);
3476 | multipliers '*' UNSIGNED
3478 if (!SCM_UNBNDP ($1))
3479 $$ = scm_product ($1, $3);
3483 | multipliers '*' FRACTION
3485 if (!SCM_UNBNDP ($1))
3486 $$ = scm_product ($1, scm_divide (scm_car ($3),
3489 $$ = scm_divide (scm_car ($3), scm_cdr ($3));
3495 $$ = scm_from_int (parser->default_tremolo_type_);
3498 if (SCM_UNBNDP (make_duration ($2))) {
3499 parser->parser_error (@2, _ ("not a duration"));
3500 $$ = scm_from_int (parser->default_tremolo_type_);
3503 parser->default_tremolo_type_ = scm_to_int ($2);
3515 // as an integer, it needs to be non-negative, and otherwise
3516 // it needs to be suitable as a markup.
3517 if (scm_is_integer ($1)
3518 ? scm_is_true (scm_negative_p ($1))
3519 : !Text_interface::is_markup ($1))
3521 parser->parser_error (@1, _ ("bass number expected"));
3527 figured_bass_alteration:
3528 '-' { $$ = ly_rational2scm (FLAT_ALTERATION); }
3529 | '+' { $$ = ly_rational2scm (SHARP_ALTERATION); }
3530 | '!' { $$ = scm_from_int (0); }
3535 Music *bfr = MY_MAKE_MUSIC ("BassFigureEvent", @$);
3536 $$ = bfr->unprotect ();
3539 Music *bfr = MY_MAKE_MUSIC ("BassFigureEvent", @$);
3540 $$ = bfr->self_scm ();
3542 if (scm_is_number ($1))
3543 bfr->set_property ("figure", $1);
3544 else if (Text_interface::is_markup ($1))
3545 bfr->set_property ("text", $1);
3551 unsmob<Music> ($1)->set_property ("bracket-stop", SCM_BOOL_T);
3553 | bass_figure figured_bass_alteration {
3554 Music *m = unsmob<Music> ($1);
3555 if (scm_to_double ($2)) {
3556 SCM salter = m->get_property ("alteration");
3557 SCM alter = scm_is_number (salter) ? salter : scm_from_int (0);
3558 m->set_property ("alteration",
3559 scm_sum (alter, $2));
3561 m->set_property ("alteration", scm_from_int (0));
3564 | bass_figure figured_bass_modification {
3565 Music *m = unsmob<Music> ($1);
3566 m->set_property ($2, SCM_BOOL_T);
3571 figured_bass_modification:
3573 $$ = ly_symbol2scm ("augmented");
3576 $$ = ly_symbol2scm ("no-continuation");
3579 $$ = ly_symbol2scm ("diminished");
3582 $$ = ly_symbol2scm ("augmented-slash");
3592 unsmob<Music> ($$)->set_property ("bracket-start", SCM_BOOL_T);
3600 | figure_list br_bass_figure {
3601 $$ = scm_cons ($2, $1);
3606 /**/ { $$ = SCM_BOOL_F; }
3607 | REST { $$ = SCM_BOOL_T; }
3611 pitch exclamations questions octave_check maybe_notemode_duration optional_rest post_events {
3612 if (!parser->lexer_->is_note_state ())
3613 parser->parser_error (@1, _ ("have to be in Note mode for notes"));
3614 if (!SCM_UNBNDP ($2)
3616 || scm_is_number ($4)
3619 || scm_is_pair ($7))
3622 if (scm_is_true ($6))
3623 n = MY_MAKE_MUSIC ("RestEvent", @$);
3625 n = MY_MAKE_MUSIC ("NoteEvent", @$);
3627 n->set_property ("pitch", $1);
3628 if (SCM_UNBNDP ($5))
3629 n->set_property ("duration",
3630 parser->default_duration_.smobbed_copy ());
3632 n->set_property ("duration", $5);
3634 if (scm_is_number ($4))
3636 int q = scm_to_int ($4);
3637 n->set_property ("absolute-octave", scm_from_int (q-1));
3640 if (to_boolean ($3))
3641 n->set_property ("cautionary", SCM_BOOL_T);
3642 if (to_boolean ($2) || to_boolean ($3))
3643 n->set_property ("force-accidental", SCM_BOOL_T);
3644 if (scm_is_pair ($7))
3645 n->set_property ("articulations",
3646 scm_reverse_x ($7, SCM_EOL));
3647 $$ = n->unprotect ();
3650 | new_chord post_events {
3651 if (!parser->lexer_->is_chord_state ())
3652 parser->parser_error (@1, _ ("have to be in Chord mode for chords"));
3653 if (scm_is_pair ($2)) {
3654 if (unsmob<Pitch> ($1))
3655 $1 = make_chord_elements (@1,
3657 parser->default_duration_.smobbed_copy (),
3660 SCM elts = ly_append2 ($1, scm_reverse_x ($2, SCM_EOL));
3662 $$ = MAKE_SYNTAX (event_chord, @1, elts);
3663 } else if (!unsmob<Pitch> ($1))
3664 $$ = MAKE_SYNTAX (event_chord, @1, $1);
3665 // A mere pitch drops through.
3670 DRUM_PITCH optional_notemode_duration {
3671 Music *n = MY_MAKE_MUSIC ("NoteEvent", @$);
3672 n->set_property ("duration", $2);
3673 n->set_property ("drum-type", $1);
3675 $$ = n->unprotect ();
3677 | RESTNAME optional_notemode_duration {
3679 if (ly_scm2string ($1) == "s") {
3681 ev = MY_MAKE_MUSIC ("SkipEvent", @$);
3684 ev = MY_MAKE_MUSIC ("RestEvent", @$);
3687 ev->set_property ("duration", $2);
3688 $$ = ev->unprotect ();
3694 if (!parser->lexer_->is_lyric_state ())
3695 parser->parser_error (@1, _ ("markup outside of text script or \\lyricmode"));
3699 if (!parser->lexer_->is_lyric_state ())
3700 parser->parser_error (@1, _f ("not a note name: %s", ly_scm2string ($1)));
3704 if (!parser->lexer_->is_lyric_state ())
3705 parser->parser_error (@1, _ ("string outside of text script or \\lyricmode"));
3711 lyric_element_music:
3712 lyric_element optional_notemode_duration post_events {
3713 $$ = MAKE_SYNTAX (lyric_event, @$, $1, $2);
3714 if (scm_is_pair ($3))
3715 unsmob<Music> ($$)->set_property
3716 ("articulations", scm_reverse_x ($3, SCM_EOL));
3720 // Can return a single pitch rather than a list.
3722 steno_tonic_pitch maybe_notemode_duration {
3723 if (SCM_UNBNDP ($2))
3726 $$ = make_chord_elements (@$, $1, $2, SCM_EOL);
3728 | steno_tonic_pitch optional_notemode_duration chord_separator chord_items {
3729 SCM its = scm_reverse_x ($4, SCM_EOL);
3730 $$ = make_chord_elements (@$, $1, $2, scm_cons ($3, its));
3738 | chord_items chord_item {
3739 $$ = scm_cons ($2, $$);
3745 $$ = ly_symbol2scm ("chord-colon");
3748 $$ = ly_symbol2scm ("chord-caret");
3750 | CHORD_SLASH steno_tonic_pitch {
3751 $$ = scm_list_2 (ly_symbol2scm ("chord-slash"), $2);
3753 | CHORD_BASS steno_tonic_pitch {
3754 $$ = scm_list_2 (ly_symbol2scm ("chord-bass"), $2);
3763 $$ = scm_reverse_x ($1, SCM_EOL);
3771 step_number { $$ = scm_cons ($1, SCM_EOL); }
3772 | step_numbers '.' step_number {
3773 $$ = scm_cons ($3, $$);
3779 $$ = make_chord_step ($1, 0);
3782 $$ = make_chord_step ($1, SHARP_ALTERATION);
3784 | UNSIGNED CHORD_MINUS {
3785 $$ = make_chord_step ($1, FLAT_ALTERATION);
3793 | unsigned_number '-' unsigned_number {
3794 $$ = scm_cons ($1, $3);
3801 TODO: should deprecate in favor of Scheme?
3805 number_expression '+' number_term {
3806 $$ = scm_sum ($1, $3);
3808 | number_expression '-' number_term {
3809 $$ = scm_difference ($1, $3);
3818 | number_factor '*' number_factor {
3819 $$ = scm_product ($1, $3);
3821 | number_factor '/' number_factor {
3822 $$ = scm_divide ($1, $3);
3827 '-' number_factor { /* %prec UNARY_MINUS */
3828 $$ = scm_difference ($2, SCM_UNDEFINED);
3836 | REAL NUMBER_IDENTIFIER
3838 $$ = scm_product ($1, $2);
3845 | UNSIGNED NUMBER_IDENTIFIER {
3846 $$ = scm_product ($1, $2);
3854 if (!scm_is_integer ($1)
3855 || scm_is_true (scm_negative_p ($1)))
3857 parser->parser_error (@1, _("not an unsigned integer"));
3863 if (!scm_is_integer ($1)
3864 || scm_is_true (scm_negative_p ($1)))
3866 parser->parser_error (@1, _("not an unsigned integer"));
3873 { $$ = SCM_UNDEFINED; }
3876 if (SCM_UNBNDP ($1))
3884 // This precedence rule is rather weird. It triggers when '!' is
3885 // encountered after a pitch, and is used for deciding whether to save
3886 // this instead for a figure modification. This should not actually
3887 // occur in practice as pitches and figures are generated in different
3888 // modes. Using a greedy (%right) precedence makes sure that we don't
3889 // get stuck in a wrong interpretation.
3890 { $$ = SCM_UNDEFINED; } %prec ':'
3893 if (SCM_UNBNDP ($1))
3902 { parser->lexer_->push_markup_state (); }
3905 parser->lexer_->pop_state ();
3912 parser->lexer_->push_markup_state ();
3916 // Sort-of ugly: We need this as markup of its own as well as in
3917 // markup function assignments, without triggering lookahead or the
3918 // '=' for assignments will be parsed in markup mode and not
3919 // recognized. Worse: the next token following something like
3920 // \markup "string" would be parsed in markup mode as well.
3922 // So we make a single production here that's used either in markup or
3926 markup_mode markup_word
3929 parser->lexer_->pop_state ();
3935 markup_mode markup_top {
3937 parser->lexer_->pop_state ();
3941 $$ = make_simple_markup ($1);
3946 markup_mode markup_partial_function ETC
3948 $$ = MAKE_SYNTAX (partial_markup, @2, $2);
3949 parser->lexer_->pop_state ();
3955 $$ = scm_list_2 (Lily::line_markup, $1);
3957 | markup_head_1_list simple_markup
3959 $$ = scm_car (MAKE_SYNTAX (composed_markup_list,
3960 @2, $1, scm_list_1 ($2)));
3962 | simple_markup_noword {
3970 if (Text_interface::is_markup ($1))
3971 MYBACKUP (MARKUP_IDENTIFIER, $1, @1);
3972 else if (Text_interface::is_markup_list ($1))
3973 MYBACKUP (MARKUPLIST_IDENTIFIER, $1, @1);
3975 parser->parser_error (@1, _ ("not a markup"));
3976 MYBACKUP (MARKUP_IDENTIFIER, scm_string (SCM_EOL), @1);
3983 markup_composed_list {
3986 | markup_uncomposed_list
3989 markup_uncomposed_list:
3990 markup_braced_list {
3993 | markup_command_list {
3994 $$ = scm_list_1 ($1);
3996 | markup_scm MARKUPLIST_IDENTIFIER
4001 parser->lexer_->push_note_state (Lily::pitchnames);
4002 } '{' score_body '}' {
4003 Score *sc = unsmob<Score> ($4);
4004 sc->origin ()->set_spot (@$);
4005 if (sc->defs_.empty ()) {
4006 Output_def *od = get_layout (parser);
4007 sc->add_output_def (od);
4010 $$ = scm_list_1 (scm_list_2 (Lily::score_lines_markup_list, $4));
4011 parser->lexer_->pop_state ();
4015 markup_composed_list:
4016 markup_head_1_list markup_uncomposed_list {
4017 $$ = MAKE_SYNTAX (composed_markup_list,
4023 '{' markup_braced_list_body '}' {
4024 $$ = scm_reverse_x ($2, SCM_EOL);
4028 markup_braced_list_body:
4029 /* empty */ { $$ = SCM_EOL; }
4030 | markup_braced_list_body markup {
4031 $$ = scm_cons ($2, $1);
4033 | markup_braced_list_body markup_list {
4034 $$ = scm_reverse_x ($2, $1);
4038 markup_command_list:
4039 MARKUP_LIST_FUNCTION markup_command_list_arguments {
4040 $$ = scm_cons ($1, scm_reverse_x($2, SCM_EOL));
4044 markup_command_basic_arguments:
4045 EXPECT_MARKUP_LIST markup_command_list_arguments markup_list {
4046 $$ = scm_cons ($3, $2);
4048 | EXPECT_SCM markup_command_list_arguments embedded_scm {
4049 $$ = check_scheme_arg (parser, @3, $3, $2, $1);
4051 | EXPECT_NO_MORE_ARGS {
4056 markup_command_list_arguments:
4057 markup_command_basic_arguments { $$ = $1; }
4058 | EXPECT_MARKUP markup_command_list_arguments markup {
4059 $$ = scm_cons ($3, $2);
4063 markup_partial_function:
4064 MARKUP_FUNCTION markup_arglist_partial
4066 $$ = scm_list_1 (scm_cons ($1, scm_reverse_x ($2, SCM_EOL)));
4068 | markup_head_1_list MARKUP_FUNCTION markup_arglist_partial
4070 $$ = scm_cons (scm_cons ($2, scm_reverse_x ($3, SCM_EOL)),
4075 markup_arglist_partial:
4076 EXPECT_MARKUP markup_arglist_partial
4080 | EXPECT_SCM markup_arglist_partial
4084 | EXPECT_MARKUP markup_command_list_arguments
4088 | EXPECT_SCM markup_command_list_arguments
4095 MARKUP_FUNCTION EXPECT_MARKUP markup_command_list_arguments {
4096 $$ = scm_cons ($1, scm_reverse_x ($3, SCM_EOL));
4101 markup_head_1_item {
4102 $$ = scm_list_1 ($1);
4104 | markup_head_1_list markup_head_1_item {
4105 $$ = scm_cons ($2, $1);
4117 $$ = make_simple_markup ($1);
4119 | simple_markup_noword
4122 simple_markup_noword:
4124 parser->lexer_->push_note_state (Lily::pitchnames);
4125 } '{' score_body '}' {
4126 Score *sc = unsmob<Score> ($4);
4127 sc->origin ()->set_spot (@$);
4128 if (sc->defs_.empty ()) {
4129 Output_def *od = get_layout (parser);
4130 sc->add_output_def (od);
4133 $$ = scm_list_2 (Lily::score_markup, $4);
4134 parser->lexer_->pop_state ();
4136 | MARKUP_FUNCTION markup_command_basic_arguments {
4137 $$ = scm_cons ($1, scm_reverse_x ($2, SCM_EOL));
4139 | markup_scm MARKUP_IDENTIFIER
4146 markup_head_1_list simple_markup
4148 $$ = scm_car (MAKE_SYNTAX (composed_markup_list,
4149 @2, $1, scm_list_1 ($2)));
4159 Lily_parser::set_yydebug (bool x)
4165 Lily_parser::do_yyparse ()
4167 return scm_c_with_fluid (Lily::f_parser,
4169 do_yyparse_trampoline,
4170 static_cast <void *>(this));
4174 Lily_parser::do_yyparse_trampoline (void *parser)
4176 SCM retval = SCM_UNDEFINED;
4177 yyparse (static_cast <Lily_parser *>(parser), &retval);
4185 It is a little strange to have this function in this file, but
4186 otherwise, we have to import music classes into the lexer.
4190 Lily_lexer::try_special_identifiers (SCM *destination, SCM sid)
4192 if (unsmob<Book> (sid)) {
4193 Book *book = unsmob<Book> (sid)->clone ();
4194 *destination = book->self_scm ();
4197 return BOOK_IDENTIFIER;
4198 } else if (scm_is_number (sid)) {
4200 return NUMBER_IDENTIFIER;
4201 } else if (unsmob<Context_def> (sid))
4203 *destination = unsmob<Context_def> (sid)->clone ()->unprotect ();
4204 return SCM_IDENTIFIER;
4205 } else if (unsmob<Context_mod> (sid)) {
4206 *destination = unsmob<Context_mod> (sid)->smobbed_copy ();
4207 return SCM_IDENTIFIER;
4208 } else if (Music *mus = unsmob<Music> (sid)) {
4209 mus = mus->clone ();
4210 *destination = mus->self_scm ();
4211 bool is_event = mus->is_mus_type ("post-event");
4213 return is_event ? EVENT_IDENTIFIER : MUSIC_IDENTIFIER;
4214 } else if (unsmob<Pitch> (sid)) {
4215 *destination = unsmob<Pitch> (sid)->smobbed_copy ();
4216 return PITCH_IDENTIFIER;
4217 } else if (unsmob<Duration> (sid)) {
4218 *destination = unsmob<Duration> (sid)->smobbed_copy ();
4219 return DURATION_IDENTIFIER;
4220 } else if (unsmob<Output_def> (sid)) {
4221 *destination = unsmob<Output_def> (sid)->clone ()->unprotect ();
4222 return SCM_IDENTIFIER;
4223 } else if (unsmob<Score> (sid)) {
4224 *destination = unsmob<Score> (sid)->clone ()->unprotect ();
4225 return SCM_IDENTIFIER;
4226 } else if (scm_is_pair (sid)
4227 && scm_is_pair (scm_car (sid))
4228 && scm_is_true (Lily::key_p (scm_caar (sid)))) {
4230 return LOOKUP_IDENTIFIER;
4236 get_next_unique_context_id ()
4238 return scm_from_ascii_string ("$uniqueContextId");
4243 get_next_unique_lyrics_context_id ()
4245 static int new_context_count;
4247 snprintf (s, sizeof (s)-1, "uniqueContext%d", new_context_count++);
4248 return scm_from_ascii_string (s);
4251 // check_scheme_arg checks one argument with a given predicate for use
4252 // in an argument list and throws a syntax error if it is unusable.
4253 // The argument is prepended to the argument list in any case. After
4254 // throwing a syntax error, the argument list is terminated with #f as
4255 // its last cdr in order to mark it as uncallable while not losing
4256 // track of its total length.
4258 // There are a few special considerations: if optional argument disp
4259 // is given (otherwise it defaults to SCM_UNDEFINED), it will be used
4260 // instead of arg in a prospective error message. This is useful if
4261 // arg is not the actual argument but rather a transformation of it.
4263 // If arg itself is SCM_UNDEFINED, the predicate is considered false
4264 // and an error message using disp is produced unconditionally.
4266 SCM check_scheme_arg (Lily_parser *parser, Input loc,
4267 SCM arg, SCM args, SCM pred, SCM disp)
4269 if (SCM_UNBNDP (arg))
4270 args = scm_cons (disp, args);
4272 args = scm_cons (arg, args);
4273 if (scm_is_true (scm_call_1 (pred, arg)))
4276 scm_set_cdr_x (scm_last_pair (args), SCM_EOL);
4277 MAKE_SYNTAX (argument_error, loc, scm_length (args), pred,
4278 SCM_UNBNDP (disp) ? arg : disp);
4279 scm_set_cdr_x (scm_last_pair (args), SCM_BOOL_F);
4283 SCM loc_on_copy (Lily_parser *parser, Input loc, SCM arg)
4285 if (Music *m = unsmob<Music> (arg))
4288 m->set_spot (parser->lexer_->override_input (loc));
4289 return m->unprotect ();
4291 if (Book *b = unsmob<Book> (arg))
4294 b->origin ()->set_spot (parser->lexer_->override_input (loc));
4295 return b->unprotect ();
4297 if (Context_def *cd = unsmob<Context_def> (arg))
4300 cd->origin ()->set_spot (parser->lexer_->override_input (loc));
4301 return cd->unprotect ();
4303 if (Output_def *od = unsmob<Output_def> (arg))
4306 od->input_origin_ = parser->lexer_->override_input (loc);
4307 return od->unprotect ();
4309 if (Score *s = unsmob<Score> (arg))
4312 s->origin ()->set_spot (parser->lexer_->override_input (loc));
4313 return s->unprotect ();
4315 if (Context_mod *cm = unsmob<Context_mod> (arg))
4317 return cm->smobbed_copy ();
4323 make_reverse_key_list (SCM keys)
4325 if (scm_is_true (Lily::key_p (keys)))
4326 return scm_list_1 (keys);
4327 if (scm_is_string (keys))
4328 return scm_list_1 (scm_string_to_symbol (keys));
4329 if (!ly_is_list (keys))
4330 return SCM_UNDEFINED;
4332 for (; scm_is_pair (keys); keys = scm_cdr (keys))
4334 SCM elt = scm_car (keys);
4335 if (scm_is_true (Lily::key_p (elt)))
4336 res = scm_cons (elt, res);
4337 else if (scm_is_string (elt))
4338 res = scm_cons (scm_string_to_symbol (elt), res);
4339 else return SCM_UNDEFINED;
4345 try_string_variants (SCM pred, SCM str)
4347 // a matching predicate is always ok
4348 if (scm_is_true (scm_call_1 (pred, str)))
4350 // a key may be interpreted as a list of keys if it helps
4351 if (scm_is_true (Lily::key_p (str))) {
4352 str = scm_list_1 (str);
4353 if (scm_is_true (scm_call_1 (pred, str)))
4355 return SCM_UNDEFINED;
4358 if (!scm_is_string (str))
4359 return SCM_UNDEFINED;
4361 // Let's attempt the symbol list interpretation first.
4363 str = scm_string_to_symbol (str);
4365 SCM lst = scm_list_1 (str);
4367 if (scm_is_true (scm_call_1 (pred, lst)))
4370 // Try the single symbol interpretation
4372 if (scm_is_true (scm_call_1 (pred, str)))
4375 return SCM_UNDEFINED;
4379 try_word_variants (SCM pred, SCM str)
4381 // str is always a string when we come here
4383 if (scm_is_true (scm_call_1 (pred, str)))
4386 // If this cannot be a string representation of a symbol list,
4389 if (!is_regular_identifier (str, true))
4390 return SCM_UNDEFINED;
4392 str = scm_string_split (str, SCM_MAKE_CHAR ('.'));
4393 for (SCM p = str; scm_is_pair (p); p = scm_cdr (p))
4394 scm_set_car_x (p, scm_string_split (scm_car (p),
4395 SCM_MAKE_CHAR (',')));
4396 str = scm_append_x (str);
4397 for (SCM p = str; scm_is_pair (p); p = scm_cdr (p))
4398 scm_set_car_x (p, scm_string_to_symbol (scm_car (p)));
4400 // Let's attempt the symbol list interpretation first.
4402 if (scm_is_true (scm_call_1 (pred, str)))
4405 // If there is just one symbol in the list, we might interpret
4406 // it as a single symbol
4408 if (scm_is_null (scm_cdr (str)))
4410 str = scm_car (str);
4411 if (scm_is_true (scm_call_1 (pred, str)))
4415 return SCM_UNDEFINED;
4419 is_regular_identifier (SCM id, bool multiple)
4421 if (!scm_is_string (id))
4424 string str = ly_scm2string (id);
4426 bool middle = false;
4428 for (string::iterator it=str.begin(); it != str.end (); it++)
4431 if ((c >= 'a' && c <= 'z')
4432 || (c >= 'A' && c <= 'Z')
4435 else if (middle && (c == '-' || c == '_' || (multiple &&
4436 (c == '.' || c == ','))))
4445 make_music_from_simple (Lily_parser *parser, Input loc, SCM simple)
4447 if (unsmob<Music> (simple))
4450 if (scm_is_symbol (simple))
4452 SCM out = SCM_UNDEFINED;
4453 switch (parser->lexer_->scan_word (out, simple))
4457 Music *n = MY_MAKE_MUSIC ("NoteEvent", loc);
4458 n->set_property ("duration", parser->default_duration_.smobbed_copy ());
4459 n->set_property ("drum-type", out);
4460 return n->unprotect ();
4462 case NOTENAME_PITCH:
4463 case TONICNAME_PITCH:
4464 // Take the parsed pitch
4467 // Don't scan CHORD_MODIFIER etc.
4471 if (parser->lexer_->is_note_state ()) {
4472 if (unsmob<Pitch> (simple)) {
4473 Music *n = MY_MAKE_MUSIC ("NoteEvent", loc);
4474 n->set_property ("duration", parser->default_duration_.smobbed_copy ());
4475 n->set_property ("pitch", simple);
4476 return n->unprotect ();
4479 if (scm_is_integer (simple))
4480 d = make_duration (simple);
4481 if (unsmob<Duration> (d)) {
4482 Music *n = MY_MAKE_MUSIC ("NoteEvent", loc);
4483 n->set_property ("duration", d);
4484 return n->unprotect ();
4487 } else if (parser->lexer_->is_lyric_state ()) {
4488 if (Text_interface::is_markup (simple))
4489 return MAKE_SYNTAX (lyric_event, loc, simple,
4490 parser->default_duration_.smobbed_copy ());
4491 } else if (parser->lexer_->is_chord_state ()) {
4492 if (unsmob<Pitch> (simple))
4496 make_chord_elements (loc, simple,
4497 parser->default_duration_.smobbed_copy (),
4504 make_music_with_input (SCM name, Input where)
4506 Music *m = make_music_by_name (name);
4507 m->set_spot (where);
4512 make_simple_markup (SCM a)
4518 make_duration (SCM d, int dots, SCM factor)
4522 if (Duration *dur = unsmob<Duration> (d)) {
4523 if (!dots && SCM_UNBNDP (factor))
4527 k = Duration (k.duration_log (), k.dot_count () + dots)
4528 .compressed (k.factor ());
4530 int t = scm_to_int (d);
4531 if (t > 0 && (t & (t-1)) == 0)
4532 k = Duration (intlog2 (t), dots);
4534 return SCM_UNDEFINED;
4537 if (!SCM_UNBNDP (factor))
4538 k = k.compressed (ly_scm2rational (factor));
4540 return k.smobbed_copy ();
4544 make_chord_step (SCM step_scm, Rational alter)
4546 Pitch m (0, scm_to_int (step_scm) - 1, alter);
4548 // Notename/octave are normalized
4549 if (m.get_notename () == 6)
4550 m = m.transposed (Pitch (0, 0, FLAT_ALTERATION));
4552 return m.smobbed_copy ();
4557 make_chord_elements (Input loc, SCM pitch, SCM dur, SCM modification_list)
4559 SCM res = Lily::construct_chord_elements (pitch, dur, modification_list);
4560 for (SCM s = res; scm_is_pair (s); s = scm_cdr (s))
4562 unsmob<Music> (scm_car (s))->set_spot (loc);
4568 yylex (YYSTYPE *s, YYLTYPE *loc, Lily_parser *parser)
4570 Lily_lexer *lex = parser->lexer_;
4574 int tok = lex->pop_extra_token ();
4577 lex->prepare_for_next_token ();
4578 return lex->yylex ();