Doc -- clarify instrumentName change example

diff --git a/Documentation/notation/staff.itely b/Documentation/notation/staff.itely
index 6adb5ffce89b78b08560f974e754cfad2ae89310..6ae5c61347d08785fc67cec25aca66ad6cb8a8ff 100644 (file)
--- a/Documentation/notation/staff.itely
+++ b/Documentation/notation/staff.itely
@@ -979,7 +979,10 @@ For details, see @ref{Modifying context plug-ins}.
 @cindex instrument names, changing
 @cindex changing instrument names
 
-Instrument names may be changed in the middle of a piece:
+Instrument names may be changed in the middle of a piece.
+However, remember that @code{instrumentName} will not be
+displayed in the middle of the piece, as it only appears
+on the first staff:
 
 @lilypond[verbatim,quote,ragged-right,relative=1]
 \set Staff.instrumentName = #"First"