Re: [BINFO] Followup reworking patch

[Mark Mitchell <mark at codesourcery dot com>]

Nathan Sidwell wrote:

> Mark Mitchell wrote:
>
> > Nathan Sidwell wrote:
>
>
> > > a vector of binfos directly.  The FIXME added to the documentation
> > > is to alert people that the docs don't match the code right now, and
> > > so I can be taken to task if I neglect to update that when the redesign
> > > is fixed :)
> >
> >
> >
> > Would it much effort to keep the docs in synch as you go?  I 
> > understand that this is in flux, but if someone were to look at this 
> > in the next few days, it would be nicer if they had accurate 
> > documentation.
>
> I don't know what the exact shape of the new binfos will be.  I'd prefer
> to write the docs once I know that.  Why would someone want to know now?
> (a) they're using binfo stuff - better to liase with me so they can avoid
> chasing a moving target. (b) they're changing binfo stuff -- better
> to liase with me so we don't tangle each other up. (c) they're working
> on some older version -- better pick up the correct docs for that
> version.

OK.

But, please make sure that you either (a) finish the job, or (b) adjust 
the docs to match current reality within a few days.  Otherwise, people 
will be accusing me of playing favorites; I've argued pretty strongly 
that patches should be complete when committed. :-)

--
Mark Mitchell
CodeSourcery, LLC
(916) 791-8304
mark@codesourcery.com