[Xcb] xid

[Jeremy A. Kolb]

On Thu, 12 Oct 2006, Jamey Sharp wrote:

> On Thu, Oct 12, 2006 at 08:15:20AM -0400, Jeremy Kolb wrote:
> > I think this is why we shouldn't use xcb_generate_id() because there's
> > nothing that explicitly tells us these are xids. It's going to be
> > confusing to people without an explicit generate/new.
> 
> Ah, *this* argument I think I can understand. You're just worried that
> people won't be able to tell the difference between an xcb_window_t and
> an xcb_visualid_t, in terms of how to get one?
> 
> I think you're arguing that xcb_window_new was useful as documentation.
> I suspect we should address your concern with *actual* documentation.
> I'd welcome patches for that.
> 
> --Jamey
> 

That's really my main point (sorry I suck at articulating ;)).  Actual 
documentation is really good and eventually I hope to get around to it, 
but self-documenting code is even better ;)

Jeremy