Octave checks make octave errors easier to correct. The syntax is
\octave pitch
This checks that pitch (without octave) yields pitch (with octave) in \relative mode. If not, a warning is printed, and the octave is corrected, for example, the first check is passed successfully. The second check fails with an error message. The octave is adjusted so the following notes are in the correct octave once again.
\relative c' { e \octave a' \octave b' }
The octave of a note following an octave check is determined with
respect to the note preceding it. In the next fragment, the last note
is a a'
, above central C. Hence, the \octave
check may
be deleted without changing the meaning of the piece.
\relative c' { e \octave b a }
This page is for LilyPond-2.0.1 (stable-branch).