Doc: improve NR 1.6.3 Instrument names (better to use \with )

[Xavier Scheuer]

Dear bug squad, could you add this doc improvement request to the
tracker, as asked by James in this thread?  Thanks!
http://lists.gnu.org/archive/html/lilypond-devel/2011-12/msg00041.html

In NR 1.6.3 Writing parts > Instrument names , it should be recommended
to use

 \new Staff \with {
   instrumentName = #"Bassoon"
 }

and _not_ (advise against)

 \set Staff.instrumentName = #"Violin "

for the following reason: one _must_ use  \with {…}  to avoid the
instrument name _not to be printed!_ if a parallel voice starts with a
\grace .

This is not an "hypothetical issue", we got at least half a dozen
messages from users experiencing this "issue" (although they did
exactly what is said in the documentation) on the French users mailing
list.

Could you please change the doc, NR 1.6.3 Writing parts > Instrument
names , accordingly?

Thanks in advance.

Here is a snippet showing the relevance of this issue (typically what
a lambda user would encounter).

%%%%

\version "2.15.20"

\score {
 <<
   \new Staff \with {
     instrumentName = #"OK"
   } {
     c'1
   }
   \new Staff \with {
     instrumentName = #"OK"
   } {
     \grace b8 c'1
   }
 >>
}

\score {
 <<
   \new Staff {
     \set Staff.instrumentName = #"NOT PRINTED!!"
     c'1
   }
   \new Staff {
     \set Staff.instrumentName = #"NOT OK"
     \grace b8 c'1
   }
 >>
}

%%%%

Cheers,
Xavier

-- 
Xavier Scheuer <address@hidden>