\book usage

[Gilles]

Hello.

To generate a piece with multiple movements, I'm used to the
following document layout, which compiles fine:

%--- all.ly ---
\version "2.6.0"

\paper {
  raggedbottom = ##f
  raggedlastbottom = ##t
}

\header {
  \include "header.inc.ly"
}

\include "all_allegro.ly"
\include "all_siciliana.ly"
\include "all_bourree.ly"
\include "all_menuet.ly"
\include "all_trio.ly"
%-----

"all_allegro.ly" includes "all_allegro.inc.ly" and contains a \score.
"all_allegro.inc.ly" defines a StaffGroup and includes all the parts
for this movement, e.g. "recorder_allegro.inc.ly" which defines the
a variable ("recorderNotes") containing the note sequence.
[And similarly for the other movements.]

Now, in the documentation for 2.6.3, I read about the \book block;
so, I changed the above into 

%--- all.ly ---
\version "2.6.0"

\paper {
  raggedbottom = ##f
  raggedlastbottom = ##t
}

\book {
  \header {
    \include "header.inc.ly"
  }

  \include "all_allegro.ly"
  \include "all_siciliana.ly"
  \include "all_bourree.ly"
  \include "all_menuet.ly"
  \include "all_trio.ly"
}
%-----

but lilypond doesn't like it:

$ lilypond all.ly
GNU LilyPond 2.6.3
Processing `all.ly'
Parsing...
recorder_allegro.inc.ly:3:0: error: syntax error, unexpected STRING

recorderNotes = \relative c'' {
recorder_allegro.inc.ly:135:0: error: syntax error, unexpected '}'

}
recorder_allegro.inc.ly:146:21: error: unknown escaped string: `\recorderNotes'
    \transpose c c {
                     \recorderNotes }
recorder_allegro.inc.ly:146:21: error: syntax error, unexpected STRING
    \transpose c c {
                     \recorderNotes }
all_allegro.ly:5:7: error: errors found, ignoring music expression
\score
       {
all_allegro.ly:16:2: error: errors found, ignoring music expression

  \unfoldRepeats \staves
all.ly:24:0: error: syntax error, unexpected '}'

}
error: failed files: "all.ly"


Could you explain why it doesn't work?


Thanks,
Gilles