> Thanks. I'll add this information to the NR.
>
>
> Right now, the NR says the following
> (https://lilypond.org/doc/v2.24/Documentation/notation/the-midi-block.html).
> What
> do you think needs to be clarified?
>
> To create a MIDI output file from a LilyPond input file, insert
> a\midi block, which can be empty, within the \score block;
>
> \score {
> … music …
> \layout { }
> \midi { }
> }
Since it is often not necessary to use `\score` for printed output
explicitly I would like to add the patch below to make it clear that
for MIDI output a `\score` block is mandatory.
Werner
======================================================================
diff --git a/Documentation/en/notation/input.itely
b/Documentation/en/notation/input.itely
index 02621905aa..e6e26f8967 100644
--- a/Documentation/en/notation/input.itely
+++ b/Documentation/en/notation/input.itely
@@ -3830,7 +3830,10 @@ To create a MIDI output file from a LilyPond input file,
insert a
@warning{A @code{@bs{}score} block that, as well as the music, contains
only a @code{@bs{}midi} block (i.e., @emph{without} the
@code{@bs{}layout} block), will only produce MIDI output files. No
-notation will be printed.}
+notation will be printed.
+
+A @code{@bs{}midi} block outside of @code{@bs{}score} does
+@emph{not} create a MIDI file.}
The default output file extension (@code{.midi}) can be changed by using
the @code{-dmidi-extension} option with the @code{lilypond} command:
