[frogs] Regression in docs: Output-suffix does not work as documented in AU 3.2.1

[Ian Hulin <ian@xxxxxxxxxxxx>]

This is AU section 3.2.1

3.2.1 Invoking lilypond

The lilypond executable may be called as follows from the command line.

lilypond [option]… file…
  

When invoked with a filename that has no extension, the ‘.ly’ extension is tried first. To read input from stdin, use a dash (-) for file.

When ‘filename.ly’ is processed it will produce ‘filename.ps’ and ‘filename.pdf’ as output. Several files can be specified; they will each be processed independently. ¹

If ‘filename.ly’ contains more than one \score block, then the rest of the scores will be output in numbered files, starting with ‘filename-1.pdf’. In addition, the value of output-suffix will be inserted between the basename and the number. An input file containing

#(define output-suffix "violin")
\score { … }
#(define output-suffix "cello")
\score { … }
  

will output base‘-violin.pdf’ and base‘-cello-1.pdf’.

____________________________________________________________________________________________________________________________

This is a regression:  you need to use \book instead of \score for the compilation to produce two files.

E.g.

#(define output-suffix "violin")
\book { … }
#(define output-suffix "cello")
\book { … }
  

Here's my (not-so) minimal version, if you change the \book to a \bookpart or \score you only get an output file using the last setting of output-suffix in the score,

\version "2.12.1"
\header {
  title = "Exsultate, Jubilate"
  subtitle = "Motet"
  subsubtitle = "K. 165"
  instrument = "Soprano Solo and Orchestra"
  composer = "W. A. Mozart"
  opus = "KV 165"
}
movonesettings = {
 \key f \major
 \time 4/4
 \tempo "Allegro" 4=128
  
 }
movtwosettings = {
 \key a \major
 \time 3/4
 \tempo "Andante" 4=72
 }
BCmovoneMusic = \relative c {
  \movonesettings
  \clef bass f8 f f f f f f f |
}
BCmovtwoMusic = \relative c {
\movtwosettings
  \clef bass
  \partial 8 r8
  r4 a'4 a, |
}
#(define output-suffix "Allegro")
\book {
\header {
        subtitle = "I Allegro"
    }
\score {
   
    \BCmovoneMusic
}
}
#(define output-suffix "Andante")
\book {
\header {
    subtitle = "II. Andante"
}
\score {
    \BCmovtwoMusic
}
}