Re: Various updates to reduce make doc output (issue 5727055)

[Phil Holmes]

----- Original Message ----- 
From: "Trevor Daniels" <address@hidden>
To: "Phil Holmes" <address@hidden>
Cc: "Lily-Devel List" <address@hidden>
Sent: Wednesday, March 14, 2012 4:28 PM
Subject: Re: Various updates to reduce make doc output (issue 5727055)


> Phil Holmes wrote Wednesday, March 14, 2012 12:00 PM
>
>
> > From: "Trevor Daniels" <address@hidden>
> > To: "Julien Rioux" <address@hidden>; "Phil Holmes" 
> > <address@hidden>
> > Cc: <address@hidden>; <address@hidden>
> > Sent: Wednesday, March 14, 2012 11:41 AM
> > Subject: Re: Various updates to reduce make doc output (issue 5727055)
> >
> >
> > > Julien Rioux wrote Wednesday, March 14, 2012 10:37 AM
> > >
> > >
> > > > On Wed, Mar 14, 2012 at 9:56 AM, Phil Holmes <address@hidden> 
> > > > wrote:
> > > >
> > > > > ----- Original Message ----- From: "Julien Rioux" 
> > > > > <address@hidden>
> > > > > To: "Phil Holmes" <address@hidden>
> > > > >
> > > > > The problem with this one is that Lilypond (like Sibelius...) only 
> > > > > provides
> > > > > 4 voices to allow notes to avoid colliding on a stave.
> > >
> > > Not true.  See Single-staff polyphony in
> > > http://www.lilypond.org/doc/v2.15/Documentation/notation/multiple-voices
> > >
> > > > I'm fine with either
> > > > 1) Leave the warning there (it's only one line of `make doc' output), 
> > > > or
> > >
> > > Strongly preferred - hiding this warning would be
> > > wrong until it is properly understood.
> >
> > I think it is understood.  Lilypond has a maximum of 4 voices.  The midi 
> > file has 5.  They won't all fit into the 4 maximum.  midi2ly warns the 
> > user that the output won't look great.  But we know that for this midi 
> > file and don't need to be told every time it's compiled.
>
> Please keep your replies on the list.

Apologies.  Was in a hurry and had finger trouble.

> Didn't you see what I wrote before?  There is no restriction to
> 4 voices in LilyPond, as is shown in the NR.  See Single-staff polyphony 
> in 
> http://www.lilypond.org/doc/v2.15/Documentation/notation/multiple-voices
>
> So it seems unlikely this is the cause of the warning, hence it is
> not understood.  So hiding this warning would be wrong.
>
> Trevor

I've looked at midi2ly and it uses explicit instantiation of voices, which 
is what we normally advise.  My understanding is that there are only 4 
explicit voices - voiceFive does not exist, AFAIK.  The warning message 
comes from midi2ly stating that it has no more explicit voice names left, 
and therefore layout is likely to be poor.  We don't need to see this during 
make doc.

I would have no problem with a request to add an issue suggesting an 
enhancement to midi2ly that it only uses implicit voices where it encounters 
more than 4 channels on a track, and therefore to lose the error message 
completely, but I remain firmly of the opinion that we don't need this 
warning repeated every time we make doc.

--
Phil Holmes