better docs

1 files changed, 1072 insertions, 706 deletions

diff --git a/nexgb/glx/glx.go b/nexgb/glx/glx.go
index 887d96b..d351137 100644
--- a/nexgb/glx/glx.go
+++ b/nexgb/glx/glx.go
@@ -2,7 +2,7 @@
 package glx
 
 /*
-	This file was generated by glx.xml on May 10 2012 8:04:31pm EDT.
+	This file was generated by glx.xml on May 10 2012 11:56:18pm EDT.
 	This file is automatically generated. Edit at your peril!
 */
 
@@ -40,6 +40,12 @@ func init() {
 	xgb.NewExtErrorFuncs["GLX"] = make(map[int]xgb.NewErrorFun)
 }
 
+// Skipping definition for base type 'Card32'
+
+// Skipping definition for base type 'Double'
+
+// Skipping definition for base type 'Bool'
+
 // Skipping definition for base type 'Float'
 
 // Skipping definition for base type 'Card8'
@@ -58,12 +64,6 @@ func init() {
 
 // Skipping definition for base type 'Char'
 
-// Skipping definition for base type 'Card32'
-
-// Skipping definition for base type 'Double'
-
-// Skipping definition for base type 'Bool'
-
 const (
 	PbcetDamaged = 32791
 	PbcetSaved   = 32792
@@ -172,9 +172,7 @@ type Bool32 uint32
 
 type ContextTag uint32
 
-// Event definition PbufferClobber (0)
-// Size: 32
-
+// PbufferClobber is the event number for a PbufferClobberEvent.
 const PbufferClobber = 0
 
 type PbufferClobberEvent struct {
@@ -193,7 +191,7 @@ type PbufferClobberEvent struct {
 	// padding: 4 bytes
 }
 
-// Event read PbufferClobber
+// PbufferClobberEventNew constructs a PbufferClobberEvent value that implements xgb.Event from a byte slice.
 func PbufferClobberEventNew(buf []byte) xgb.Event {
 	v := PbufferClobberEvent{}
 	b := 1 // don't read event number
@@ -238,7 +236,7 @@ func PbufferClobberEventNew(buf []byte) xgb.Event {
 	return v
 }
 
-// Event write PbufferClobber
+// Bytes writes a PbufferClobberEvent value to a byte slice.
 func (v PbufferClobberEvent) Bytes() []byte {
 	buf := make([]byte, 32)
 	b := 0
@@ -286,12 +284,14 @@ func (v PbufferClobberEvent) Bytes() []byte {
 	return buf
 }
 
-func (v PbufferClobberEvent) ImplementsEvent() {}
-
+// SequenceId returns the sequence id attached to the PbufferClobber event.
+// Events without a sequence number (KeymapNotify) return 0.
+// This is mostly used internally.
 func (v PbufferClobberEvent) SequenceId() uint16 {
 	return v.Sequence
 }
 
+// String is a rudimentary string representation of PbufferClobberEvent.
 func (v PbufferClobberEvent) String() string {
 	fieldVals := make([]string, 0, 12)
 	fieldVals = append(fieldVals, xgb.Sprintf("Sequence: %d", v.Sequence))
@@ -312,9 +312,7 @@ func init() {
 	xgb.NewExtEventFuncs["GLX"][0] = PbufferClobberEventNew
 }
 
-// Error definition Generic (-1)
-// Size: 32
-
+// BadGeneric is the error number for a BadGeneric.
 const BadGeneric = -1
 
 type GenericError struct {
@@ -326,7 +324,7 @@ type GenericError struct {
 	// padding: 21 bytes
 }
 
-// Error read Generic
+// GenericErrorNew constructs a GenericError value that implements xgb.Error from a byte slice.
 func GenericErrorNew(buf []byte) xgb.Error {
 	v := GenericError{}
 	v.NiceName = "Generic"
@@ -351,8 +349,8 @@ func GenericErrorNew(buf []byte) xgb.Error {
 	return v
 }
 
-func (err GenericError) ImplementsError() {}
-
+// SequenceId returns the sequence id attached to the BadGeneric error.
+// This is mostly used internally.
 func (err GenericError) SequenceId() uint16 {
 	return err.Sequence
 }
@@ -375,20 +373,20 @@ func init() {
 	xgb.NewExtErrorFuncs["GLX"][-1] = GenericErrorNew
 }
 
-// ErrorCopy definition BadContext (0)
-
+// BadBadContext is the error number for a BadBadContext.
 const BadBadContext = 0
 
 type BadContextError GenericError
 
+// BadContextErrorNew constructs a BadContextError value that implements xgb.Error from a byte slice.
 func BadContextErrorNew(buf []byte) xgb.Error {
 	v := BadContextError(GenericErrorNew(buf).(GenericError))
 	v.NiceName = "BadContext"
 	return v
 }
 
-func (err BadContextError) ImplementsError() {}
-
+// SequenceId returns the sequence id attached to the BadBadContext error.
+// This is mostly used internally.
 func (err BadContextError) SequenceId() uint16 {
 	return err.Sequence
 }
@@ -411,20 +409,20 @@ func init() {
 	xgb.NewExtErrorFuncs["GLX"][0] = BadContextErrorNew
 }
 
-// ErrorCopy definition BadContextState (1)
-
+// BadBadContextState is the error number for a BadBadContextState.
 const BadBadContextState = 1
 
 type BadContextStateError GenericError
 
+// BadContextStateErrorNew constructs a BadContextStateError value that implements xgb.Error from a byte slice.
 func BadContextStateErrorNew(buf []byte) xgb.Error {
 	v := BadContextStateError(GenericErrorNew(buf).(GenericError))
 	v.NiceName = "BadContextState"
 	return v
 }
 
-func (err BadContextStateError) ImplementsError() {}
-
+// SequenceId returns the sequence id attached to the BadBadContextState error.
+// This is mostly used internally.
 func (err BadContextStateError) SequenceId() uint16 {
 	return err.Sequence
 }
@@ -447,20 +445,20 @@ func init() {
 	xgb.NewExtErrorFuncs["GLX"][1] = BadContextStateErrorNew
 }
 
-// ErrorCopy definition BadDrawable (2)
-
+// BadBadDrawable is the error number for a BadBadDrawable.
 const BadBadDrawable = 2
 
 type BadDrawableError GenericError
 
+// BadDrawableErrorNew constructs a BadDrawableError value that implements xgb.Error from a byte slice.
 func BadDrawableErrorNew(buf []byte) xgb.Error {
 	v := BadDrawableError(GenericErrorNew(buf).(GenericError))
 	v.NiceName = "BadDrawable"
 	return v
 }
 
-func (err BadDrawableError) ImplementsError() {}
-
+// SequenceId returns the sequence id attached to the BadBadDrawable error.
+// This is mostly used internally.
 func (err BadDrawableError) SequenceId() uint16 {
 	return err.Sequence
 }
@@ -483,20 +481,20 @@ func init() {
 	xgb.NewExtErrorFuncs["GLX"][2] = BadDrawableErrorNew
 }
 
-// ErrorCopy definition BadPixmap (3)
-
+// BadBadPixmap is the error number for a BadBadPixmap.
 const BadBadPixmap = 3
 
 type BadPixmapError GenericError
 
+// BadPixmapErrorNew constructs a BadPixmapError value that implements xgb.Error from a byte slice.
 func BadPixmapErrorNew(buf []byte) xgb.Error {
 	v := BadPixmapError(GenericErrorNew(buf).(GenericError))
 	v.NiceName = "BadPixmap"
 	return v
 }
 
-func (err BadPixmapError) ImplementsError() {}
-
+// SequenceId returns the sequence id attached to the BadBadPixmap error.
+// This is mostly used internally.
 func (err BadPixmapError) SequenceId() uint16 {
 	return err.Sequence
 }
@@ -519,20 +517,20 @@ func init() {
 	xgb.NewExtErrorFuncs["GLX"][3] = BadPixmapErrorNew
 }
 
-// ErrorCopy definition BadContextTag (4)
-
+// BadBadContextTag is the error number for a BadBadContextTag.
 const BadBadContextTag = 4
 
 type BadContextTagError GenericError
 
+// BadContextTagErrorNew constructs a BadContextTagError value that implements xgb.Error from a byte slice.
 func BadContextTagErrorNew(buf []byte) xgb.Error {
 	v := BadContextTagError(GenericErrorNew(buf).(GenericError))
 	v.NiceName = "BadContextTag"
 	return v
 }
 
-func (err BadContextTagError) ImplementsError() {}
-
+// SequenceId returns the sequence id attached to the BadBadContextTag error.
+// This is mostly used internally.
 func (err BadContextTagError) SequenceId() uint16 {
 	return err.Sequence
 }
@@ -555,20 +553,20 @@ func init() {
 	xgb.NewExtErrorFuncs["GLX"][4] = BadContextTagErrorNew
 }
 
-// ErrorCopy definition BadCurrentWindow (5)
-
+// BadBadCurrentWindow is the error number for a BadBadCurrentWindow.
 const BadBadCurrentWindow = 5
 
 type BadCurrentWindowError GenericError
 
+// BadCurrentWindowErrorNew constructs a BadCurrentWindowError value that implements xgb.Error from a byte slice.
 func BadCurrentWindowErrorNew(buf []byte) xgb.Error {
 	v := BadCurrentWindowError(GenericErrorNew(buf).(GenericError))
 	v.NiceName = "BadCurrentWindow"
 	return v
 }
 
-func (err BadCurrentWindowError) ImplementsError() {}
-
+// SequenceId returns the sequence id attached to the BadBadCurrentWindow error.
+// This is mostly used internally.
 func (err BadCurrentWindowError) SequenceId() uint16 {
 	return err.Sequence
 }
@@ -591,20 +589,20 @@ func init() {
 	xgb.NewExtErrorFuncs["GLX"][5] = BadCurrentWindowErrorNew
 }
 
-// ErrorCopy definition BadRenderRequest (6)
-
+// BadBadRenderRequest is the error number for a BadBadRenderRequest.
 const BadBadRenderRequest = 6
 
 type BadRenderRequestError GenericError
 
+// BadRenderRequestErrorNew constructs a BadRenderRequestError value that implements xgb.Error from a byte slice.
 func BadRenderRequestErrorNew(buf []byte) xgb.Error {
 	v := BadRenderRequestError(GenericErrorNew(buf).(GenericError))
 	v.NiceName = "BadRenderRequest"
 	return v
 }
 
-func (err BadRenderRequestError) ImplementsError() {}
-
+// SequenceId returns the sequence id attached to the BadBadRenderRequest error.
+// This is mostly used internally.
 func (err BadRenderRequestError) SequenceId() uint16 {
 	return err.Sequence
 }
@@ -627,20 +625,20 @@ func init() {
 	xgb.NewExtErrorFuncs["GLX"][6] = BadRenderRequestErrorNew
 }
 
-// ErrorCopy definition BadLargeRequest (7)
-
+// BadBadLargeRequest is the error number for a BadBadLargeRequest.
 const BadBadLargeRequest = 7
 
 type BadLargeRequestError GenericError
 
+// BadLargeRequestErrorNew constructs a BadLargeRequestError value that implements xgb.Error from a byte slice.
 func BadLargeRequestErrorNew(buf []byte) xgb.Error {
 	v := BadLargeRequestError(GenericErrorNew(buf).(GenericError))
 	v.NiceName = "BadLargeRequest"
 	return v
 }
 
-func (err BadLargeRequestError) ImplementsError() {}
-
+// SequenceId returns the sequence id attached to the BadBadLargeRequest error.
+// This is mostly used internally.
 func (err BadLargeRequestError) SequenceId() uint16 {
 	return err.Sequence
 }
@@ -663,20 +661,20 @@ func init() {
 	xgb.NewExtErrorFuncs["GLX"][7] = BadLargeRequestErrorNew
 }
 
-// ErrorCopy definition UnsupportedPrivateRequest (8)
-
+// BadUnsupportedPrivateRequest is the error number for a BadUnsupportedPrivateRequest.
 const BadUnsupportedPrivateRequest = 8
 
 type UnsupportedPrivateRequestError GenericError
 
+// UnsupportedPrivateRequestErrorNew constructs a UnsupportedPrivateRequestError value that implements xgb.Error from a byte slice.
 func UnsupportedPrivateRequestErrorNew(buf []byte) xgb.Error {
 	v := UnsupportedPrivateRequestError(GenericErrorNew(buf).(GenericError))
 	v.NiceName = "UnsupportedPrivateRequest"
 	return v
 }
 
-func (err UnsupportedPrivateRequestError) ImplementsError() {}
-
+// SequenceId returns the sequence id attached to the BadUnsupportedPrivateRequest error.
+// This is mostly used internally.
 func (err UnsupportedPrivateRequestError) SequenceId() uint16 {
 	return err.Sequence
 }
@@ -699,20 +697,20 @@ func init() {
 	xgb.NewExtErrorFuncs["GLX"][8] = UnsupportedPrivateRequestErrorNew
 }
 
-// ErrorCopy definition BadFBConfig (9)
-
+// BadBadFBConfig is the error number for a BadBadFBConfig.
 const BadBadFBConfig = 9
 
 type BadFBConfigError GenericError
 
+// BadFBConfigErrorNew constructs a BadFBConfigError value that implements xgb.Error from a byte slice.
 func BadFBConfigErrorNew(buf []byte) xgb.Error {
 	v := BadFBConfigError(GenericErrorNew(buf).(GenericError))
 	v.NiceName = "BadFBConfig"
 	return v
 }
 
-func (err BadFBConfigError) ImplementsError() {}
-
+// SequenceId returns the sequence id attached to the BadBadFBConfig error.
+// This is mostly used internally.
 func (err BadFBConfigError) SequenceId() uint16 {
 	return err.Sequence
 }
@@ -735,20 +733,20 @@ func init() {
 	xgb.NewExtErrorFuncs["GLX"][9] = BadFBConfigErrorNew
 }
 
-// ErrorCopy definition BadPbuffer (10)
-
+// BadBadPbuffer is the error number for a BadBadPbuffer.
 const BadBadPbuffer = 10
 
 type BadPbufferError GenericError
 
+// BadPbufferErrorNew constructs a BadPbufferError value that implements xgb.Error from a byte slice.
 func BadPbufferErrorNew(buf []byte) xgb.Error {
 	v := BadPbufferError(GenericErrorNew(buf).(GenericError))
 	v.NiceName = "BadPbuffer"
 	return v
 }
 
-func (err BadPbufferError) ImplementsError() {}
-
+// SequenceId returns the sequence id attached to the BadBadPbuffer error.
+// This is mostly used internally.
 func (err BadPbufferError) SequenceId() uint16 {
 	return err.Sequence
 }
@@ -771,20 +769,20 @@ func init() {
 	xgb.NewExtErrorFuncs["GLX"][10] = BadPbufferErrorNew
 }
 
-// ErrorCopy definition BadCurrentDrawable (11)
-
+// BadBadCurrentDrawable is the error number for a BadBadCurrentDrawable.
 const BadBadCurrentDrawable = 11
 
 type BadCurrentDrawableError GenericError
 
+// BadCurrentDrawableErrorNew constructs a BadCurrentDrawableError value that implements xgb.Error from a byte slice.
 func BadCurrentDrawableErrorNew(buf []byte) xgb.Error {
 	v := BadCurrentDrawableError(GenericErrorNew(buf).(GenericError))
 	v.NiceName = "BadCurrentDrawable"
 	return v
 }
 
-func (err BadCurrentDrawableError) ImplementsError() {}
-
+// SequenceId returns the sequence id attached to the BadBadCurrentDrawable error.
+// This is mostly used internally.
 func (err BadCurrentDrawableError) SequenceId() uint16 {
 	return err.Sequence
 }
@@ -807,20 +805,20 @@ func init() {
 	xgb.NewExtErrorFuncs["GLX"][11] = BadCurrentDrawableErrorNew
 }
 
-// ErrorCopy definition BadWindow (12)
-
+// BadBadWindow is the error number for a BadBadWindow.
 const BadBadWindow = 12
 
 type BadWindowError GenericError
 
+// BadWindowErrorNew constructs a BadWindowError value that implements xgb.Error from a byte slice.
 func BadWindowErrorNew(buf []byte) xgb.Error {
 	v := BadWindowError(GenericErrorNew(buf).(GenericError))
 	v.NiceName = "BadWindow"
 	return v
 }
 
-func (err BadWindowError) ImplementsError() {}
-
+// SequenceId returns the sequence id attached to the BadBadWindow error.
+// This is mostly used internally.
 func (err BadWindowError) SequenceId() uint16 {
 	return err.Sequence
 }
@@ -843,20 +841,20 @@ func init() {
 	xgb.NewExtErrorFuncs["GLX"][12] = BadWindowErrorNew
 }
 
-// ErrorCopy definition GLXBadProfileARB (13)
-
+// BadGLXBadProfileARB is the error number for a BadGLXBadProfileARB.
 const BadGLXBadProfileARB = 13
 
 type GLXBadProfileARBError GenericError
 
+// GLXBadProfileARBErrorNew constructs a GLXBadProfileARBError value that implements xgb.Error from a byte slice.
 func GLXBadProfileARBErrorNew(buf []byte) xgb.Error {
 	v := GLXBadProfileARBError(GenericErrorNew(buf).(GenericError))
 	v.NiceName = "GLXBadProfileARB"
 	return v
 }
 
-func (err GLXBadProfileARBError) ImplementsError() {}
-
+// SequenceId returns the sequence id attached to the BadGLXBadProfileARB error.
+// This is mostly used internally.
 func (err GLXBadProfileARBError) SequenceId() uint16 {
 	return err.Sequence
 }
@@ -879,30 +877,35 @@ func init() {
 	xgb.NewExtErrorFuncs["GLX"][13] = GLXBadProfileARBErrorNew
 }
 
-// Request Render
-// size: xgb.Pad((8 + xgb.Pad((len(Data) * 1))))
+// RenderCookie is a cookie used only for Render requests.
 type RenderCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for Render
+// Render sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func Render(c *xgb.Conn, ContextTag ContextTag, Data []byte) RenderCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(renderRequest(c, ContextTag, Data), cookie)
 	return RenderCookie{cookie}
 }
 
+// RenderChecked sends a checked request.
+// If an error occurs, it can be retrieved using RenderCookie.Check()
 func RenderChecked(c *xgb.Conn, ContextTag ContextTag, Data []byte) RenderCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(renderRequest(c, ContextTag, Data), cookie)
 	return RenderCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook RenderCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for Render
+// renderRequest writes a Render request to a byte slice.
 func renderRequest(c *xgb.Conn, ContextTag ContextTag, Data []byte) []byte {
 	size := xgb.Pad((8 + xgb.Pad((len(Data) * 1))))
 	b := 0
@@ -926,30 +929,35 @@ func renderRequest(c *xgb.Conn, ContextTag ContextTag, Data []byte) []byte {
 	return buf
 }
 
-// Request RenderLarge
-// size: xgb.Pad((16 + xgb.Pad((int(DataLen) * 1))))
+// RenderLargeCookie is a cookie used only for RenderLarge requests.
 type RenderLargeCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for RenderLarge
+// RenderLarge sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func RenderLarge(c *xgb.Conn, ContextTag ContextTag, RequestNum uint16, RequestTotal uint16, DataLen uint32, Data []byte) RenderLargeCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(renderLargeRequest(c, ContextTag, RequestNum, RequestTotal, DataLen, Data), cookie)
 	return RenderLargeCookie{cookie}
 }
 
+// RenderLargeChecked sends a checked request.
+// If an error occurs, it can be retrieved using RenderLargeCookie.Check()
 func RenderLargeChecked(c *xgb.Conn, ContextTag ContextTag, RequestNum uint16, RequestTotal uint16, DataLen uint32, Data []byte) RenderLargeCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(renderLargeRequest(c, ContextTag, RequestNum, RequestTotal, DataLen, Data), cookie)
 	return RenderLargeCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook RenderLargeCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for RenderLarge
+// renderLargeRequest writes a RenderLarge request to a byte slice.
 func renderLargeRequest(c *xgb.Conn, ContextTag ContextTag, RequestNum uint16, RequestTotal uint16, DataLen uint32, Data []byte) []byte {
 	size := xgb.Pad((16 + xgb.Pad((int(DataLen) * 1))))
 	b := 0
@@ -982,30 +990,35 @@ func renderLargeRequest(c *xgb.Conn, ContextTag ContextTag, RequestNum uint16, R
 	return buf
 }
 
-// Request CreateContext
-// size: 24
+// CreateContextCookie is a cookie used only for CreateContext requests.
 type CreateContextCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for CreateContext
+// CreateContext sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func CreateContext(c *xgb.Conn, Context Context, Visual xproto.Visualid, Screen uint32, ShareList Context, IsDirect bool) CreateContextCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(createContextRequest(c, Context, Visual, Screen, ShareList, IsDirect), cookie)
 	return CreateContextCookie{cookie}
 }
 
+// CreateContextChecked sends a checked request.
+// If an error occurs, it can be retrieved using CreateContextCookie.Check()
 func CreateContextChecked(c *xgb.Conn, Context Context, Visual xproto.Visualid, Screen uint32, ShareList Context, IsDirect bool) CreateContextCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(createContextRequest(c, Context, Visual, Screen, ShareList, IsDirect), cookie)
 	return CreateContextCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook CreateContextCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for CreateContext
+// createContextRequest writes a CreateContext request to a byte slice.
 func createContextRequest(c *xgb.Conn, Context Context, Visual xproto.Visualid, Screen uint32, ShareList Context, IsDirect bool) []byte {
 	size := 24
 	b := 0
@@ -1044,30 +1057,35 @@ func createContextRequest(c *xgb.Conn, Context Context, Visual xproto.Visualid,
 	return buf
 }
 
-// Request DestroyContext
-// size: 8
+// DestroyContextCookie is a cookie used only for DestroyContext requests.
 type DestroyContextCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for DestroyContext
+// DestroyContext sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func DestroyContext(c *xgb.Conn, Context Context) DestroyContextCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(destroyContextRequest(c, Context), cookie)
 	return DestroyContextCookie{cookie}
 }
 
+// DestroyContextChecked sends a checked request.
+// If an error occurs, it can be retrieved using DestroyContextCookie.Check()
 func DestroyContextChecked(c *xgb.Conn, Context Context) DestroyContextCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(destroyContextRequest(c, Context), cookie)
 	return DestroyContextCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook DestroyContextCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for DestroyContext
+// destroyContextRequest writes a DestroyContext request to a byte slice.
 func destroyContextRequest(c *xgb.Conn, Context Context) []byte {
 	size := 8
 	b := 0
@@ -1088,35 +1106,37 @@ func destroyContextRequest(c *xgb.Conn, Context Context) []byte {
 	return buf
 }
 
-// Request MakeCurrent
-// size: 16
+// MakeCurrentCookie is a cookie used only for MakeCurrent requests.
 type MakeCurrentCookie struct {
 	*xgb.Cookie
 }
 
+// MakeCurrent sends a checked request.
+// If an error occurs, it will be returned with the reply by calling MakeCurrentCookie.Reply()
 func MakeCurrent(c *xgb.Conn, Drawable Drawable, Context Context, OldContextTag ContextTag) MakeCurrentCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(makeCurrentRequest(c, Drawable, Context, OldContextTag), cookie)
 	return MakeCurrentCookie{cookie}
 }
 
+// MakeCurrentUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func MakeCurrentUnchecked(c *xgb.Conn, Drawable Drawable, Context Context, OldContextTag ContextTag) MakeCurrentCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(makeCurrentRequest(c, Drawable, Context, OldContextTag), cookie)
 	return MakeCurrentCookie{cookie}
 }
 
-// Request reply for MakeCurrent
-// size: 32
+// MakeCurrentReply represents the data returned from a MakeCurrent request.
 type MakeCurrentReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	ContextTag ContextTag
 	// padding: 20 bytes
 }
 
-// Waits and reads reply data from request MakeCurrent
+// Reply blocks and returns the reply data for a MakeCurrent request.
 func (cook MakeCurrentCookie) Reply() (*MakeCurrentReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -1128,7 +1148,7 @@ func (cook MakeCurrentCookie) Reply() (*MakeCurrentReply, error) {
 	return makeCurrentReply(buf), nil
 }
 
-// Read reply into structure from buffer for MakeCurrent
+// makeCurrentReply reads a byte slice into a MakeCurrentReply value.
 func makeCurrentReply(buf []byte) *MakeCurrentReply {
 	v := new(MakeCurrentReply)
 	b := 1 // skip reply determinant
@@ -1150,6 +1170,7 @@ func makeCurrentReply(buf []byte) *MakeCurrentReply {
 }
 
 // Write request to wire for MakeCurrent
+// makeCurrentRequest writes a MakeCurrent request to a byte slice.
 func makeCurrentRequest(c *xgb.Conn, Drawable Drawable, Context Context, OldContextTag ContextTag) []byte {
 	size := 16
 	b := 0
@@ -1176,35 +1197,37 @@ func makeCurrentRequest(c *xgb.Conn, Drawable Drawable, Context Context, OldCont
 	return buf
 }
 
-// Request IsDirect
-// size: 8
+// IsDirectCookie is a cookie used only for IsDirect requests.
 type IsDirectCookie struct {
 	*xgb.Cookie
 }
 
+// IsDirect sends a checked request.
+// If an error occurs, it will be returned with the reply by calling IsDirectCookie.Reply()
 func IsDirect(c *xgb.Conn, Context Context) IsDirectCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(isDirectRequest(c, Context), cookie)
 	return IsDirectCookie{cookie}
 }
 
+// IsDirectUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func IsDirectUnchecked(c *xgb.Conn, Context Context) IsDirectCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(isDirectRequest(c, Context), cookie)
 	return IsDirectCookie{cookie}
 }
 
-// Request reply for IsDirect
-// size: 32
+// IsDirectReply represents the data returned from a IsDirect request.
 type IsDirectReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	IsDirect bool
 	// padding: 23 bytes
 }
 
-// Waits and reads reply data from request IsDirect
+// Reply blocks and returns the reply data for a IsDirect request.
 func (cook IsDirectCookie) Reply() (*IsDirectReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -1216,7 +1239,7 @@ func (cook IsDirectCookie) Reply() (*IsDirectReply, error) {
 	return isDirectReply(buf), nil
 }
 
-// Read reply into structure from buffer for IsDirect
+// isDirectReply reads a byte slice into a IsDirectReply value.
 func isDirectReply(buf []byte) *IsDirectReply {
 	v := new(IsDirectReply)
 	b := 1 // skip reply determinant
@@ -1242,6 +1265,7 @@ func isDirectReply(buf []byte) *IsDirectReply {
 }
 
 // Write request to wire for IsDirect
+// isDirectRequest writes a IsDirect request to a byte slice.
 func isDirectRequest(c *xgb.Conn, Context Context) []byte {
 	size := 8
 	b := 0
@@ -1262,36 +1286,38 @@ func isDirectRequest(c *xgb.Conn, Context Context) []byte {
 	return buf
 }
 
-// Request QueryVersion
-// size: 12
+// QueryVersionCookie is a cookie used only for QueryVersion requests.
 type QueryVersionCookie struct {
 	*xgb.Cookie
 }
 
+// QueryVersion sends a checked request.
+// If an error occurs, it will be returned with the reply by calling QueryVersionCookie.Reply()
 func QueryVersion(c *xgb.Conn, MajorVersion uint32, MinorVersion uint32) QueryVersionCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(queryVersionRequest(c, MajorVersion, MinorVersion), cookie)
 	return QueryVersionCookie{cookie}
 }
 
+// QueryVersionUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func QueryVersionUnchecked(c *xgb.Conn, MajorVersion uint32, MinorVersion uint32) QueryVersionCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(queryVersionRequest(c, MajorVersion, MinorVersion), cookie)
 	return QueryVersionCookie{cookie}
 }
 
-// Request reply for QueryVersion
-// size: 32
+// QueryVersionReply represents the data returned from a QueryVersion request.
 type QueryVersionReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	MajorVersion uint32
 	MinorVersion uint32
 	// padding: 16 bytes
 }
 
-// Waits and reads reply data from request QueryVersion
+// Reply blocks and returns the reply data for a QueryVersion request.
 func (cook QueryVersionCookie) Reply() (*QueryVersionReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -1303,7 +1329,7 @@ func (cook QueryVersionCookie) Reply() (*QueryVersionReply, error) {
 	return queryVersionReply(buf), nil
 }
 
-// Read reply into structure from buffer for QueryVersion
+// queryVersionReply reads a byte slice into a QueryVersionReply value.
 func queryVersionReply(buf []byte) *QueryVersionReply {
 	v := new(QueryVersionReply)
 	b := 1 // skip reply determinant
@@ -1328,6 +1354,7 @@ func queryVersionReply(buf []byte) *QueryVersionReply {
 }
 
 // Write request to wire for QueryVersion
+// queryVersionRequest writes a QueryVersion request to a byte slice.
 func queryVersionRequest(c *xgb.Conn, MajorVersion uint32, MinorVersion uint32) []byte {
 	size := 12
 	b := 0
@@ -1351,30 +1378,35 @@ func queryVersionRequest(c *xgb.Conn, MajorVersion uint32, MinorVersion uint32)
 	return buf
 }
 
-// Request WaitGL
-// size: 8
+// WaitGLCookie is a cookie used only for WaitGL requests.
 type WaitGLCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for WaitGL
+// WaitGL sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func WaitGL(c *xgb.Conn, ContextTag ContextTag) WaitGLCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(waitGLRequest(c, ContextTag), cookie)
 	return WaitGLCookie{cookie}
 }
 
+// WaitGLChecked sends a checked request.
+// If an error occurs, it can be retrieved using WaitGLCookie.Check()
 func WaitGLChecked(c *xgb.Conn, ContextTag ContextTag) WaitGLCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(waitGLRequest(c, ContextTag), cookie)
 	return WaitGLCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook WaitGLCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for WaitGL
+// waitGLRequest writes a WaitGL request to a byte slice.
 func waitGLRequest(c *xgb.Conn, ContextTag ContextTag) []byte {
 	size := 8
 	b := 0
@@ -1395,30 +1427,35 @@ func waitGLRequest(c *xgb.Conn, ContextTag ContextTag) []byte {
 	return buf
 }
 
-// Request WaitX
-// size: 8
+// WaitXCookie is a cookie used only for WaitX requests.
 type WaitXCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for WaitX
+// WaitX sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func WaitX(c *xgb.Conn, ContextTag ContextTag) WaitXCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(waitXRequest(c, ContextTag), cookie)
 	return WaitXCookie{cookie}
 }
 
+// WaitXChecked sends a checked request.
+// If an error occurs, it can be retrieved using WaitXCookie.Check()
 func WaitXChecked(c *xgb.Conn, ContextTag ContextTag) WaitXCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(waitXRequest(c, ContextTag), cookie)
 	return WaitXCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook WaitXCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for WaitX
+// waitXRequest writes a WaitX request to a byte slice.
 func waitXRequest(c *xgb.Conn, ContextTag ContextTag) []byte {
 	size := 8
 	b := 0
@@ -1439,30 +1476,35 @@ func waitXRequest(c *xgb.Conn, ContextTag ContextTag) []byte {
 	return buf
 }
 
-// Request CopyContext
-// size: 20
+// CopyContextCookie is a cookie used only for CopyContext requests.
 type CopyContextCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for CopyContext
+// CopyContext sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func CopyContext(c *xgb.Conn, Src Context, Dest Context, Mask uint32, SrcContextTag ContextTag) CopyContextCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(copyContextRequest(c, Src, Dest, Mask, SrcContextTag), cookie)
 	return CopyContextCookie{cookie}
 }
 
+// CopyContextChecked sends a checked request.
+// If an error occurs, it can be retrieved using CopyContextCookie.Check()
 func CopyContextChecked(c *xgb.Conn, Src Context, Dest Context, Mask uint32, SrcContextTag ContextTag) CopyContextCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(copyContextRequest(c, Src, Dest, Mask, SrcContextTag), cookie)
 	return CopyContextCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook CopyContextCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for CopyContext
+// copyContextRequest writes a CopyContext request to a byte slice.
 func copyContextRequest(c *xgb.Conn, Src Context, Dest Context, Mask uint32, SrcContextTag ContextTag) []byte {
 	size := 20
 	b := 0
@@ -1492,30 +1534,35 @@ func copyContextRequest(c *xgb.Conn, Src Context, Dest Context, Mask uint32, Src
 	return buf
 }
 
-// Request SwapBuffers
-// size: 12
+// SwapBuffersCookie is a cookie used only for SwapBuffers requests.
 type SwapBuffersCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for SwapBuffers
+// SwapBuffers sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func SwapBuffers(c *xgb.Conn, ContextTag ContextTag, Drawable Drawable) SwapBuffersCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(swapBuffersRequest(c, ContextTag, Drawable), cookie)
 	return SwapBuffersCookie{cookie}
 }
 
+// SwapBuffersChecked sends a checked request.
+// If an error occurs, it can be retrieved using SwapBuffersCookie.Check()
 func SwapBuffersChecked(c *xgb.Conn, ContextTag ContextTag, Drawable Drawable) SwapBuffersCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(swapBuffersRequest(c, ContextTag, Drawable), cookie)
 	return SwapBuffersCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook SwapBuffersCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for SwapBuffers
+// swapBuffersRequest writes a SwapBuffers request to a byte slice.
 func swapBuffersRequest(c *xgb.Conn, ContextTag ContextTag, Drawable Drawable) []byte {
 	size := 12
 	b := 0
@@ -1539,30 +1586,35 @@ func swapBuffersRequest(c *xgb.Conn, ContextTag ContextTag, Drawable Drawable) [
 	return buf
 }
 
-// Request UseXFont
-// size: 24
+// UseXFontCookie is a cookie used only for UseXFont requests.
 type UseXFontCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for UseXFont
+// UseXFont sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func UseXFont(c *xgb.Conn, ContextTag ContextTag, Font xproto.Font, First uint32, Count uint32, ListBase uint32) UseXFontCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(useXFontRequest(c, ContextTag, Font, First, Count, ListBase), cookie)
 	return UseXFontCookie{cookie}
 }
 
+// UseXFontChecked sends a checked request.
+// If an error occurs, it can be retrieved using UseXFontCookie.Check()
 func UseXFontChecked(c *xgb.Conn, ContextTag ContextTag, Font xproto.Font, First uint32, Count uint32, ListBase uint32) UseXFontCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(useXFontRequest(c, ContextTag, Font, First, Count, ListBase), cookie)
 	return UseXFontCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook UseXFontCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for UseXFont
+// useXFontRequest writes a UseXFont request to a byte slice.
 func useXFontRequest(c *xgb.Conn, ContextTag ContextTag, Font xproto.Font, First uint32, Count uint32, ListBase uint32) []byte {
 	size := 24
 	b := 0
@@ -1595,30 +1647,35 @@ func useXFontRequest(c *xgb.Conn, ContextTag ContextTag, Font xproto.Font, First
 	return buf
 }
 
-// Request CreateGLXPixmap
-// size: 20
+// CreateGLXPixmapCookie is a cookie used only for CreateGLXPixmap requests.
 type CreateGLXPixmapCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for CreateGLXPixmap
+// CreateGLXPixmap sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func CreateGLXPixmap(c *xgb.Conn, Screen uint32, Visual xproto.Visualid, Pixmap xproto.Pixmap, GlxPixmap Pixmap) CreateGLXPixmapCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(createGLXPixmapRequest(c, Screen, Visual, Pixmap, GlxPixmap), cookie)
 	return CreateGLXPixmapCookie{cookie}
 }
 
+// CreateGLXPixmapChecked sends a checked request.
+// If an error occurs, it can be retrieved using CreateGLXPixmapCookie.Check()
 func CreateGLXPixmapChecked(c *xgb.Conn, Screen uint32, Visual xproto.Visualid, Pixmap xproto.Pixmap, GlxPixmap Pixmap) CreateGLXPixmapCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(createGLXPixmapRequest(c, Screen, Visual, Pixmap, GlxPixmap), cookie)
 	return CreateGLXPixmapCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook CreateGLXPixmapCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for CreateGLXPixmap
+// createGLXPixmapRequest writes a CreateGLXPixmap request to a byte slice.
 func createGLXPixmapRequest(c *xgb.Conn, Screen uint32, Visual xproto.Visualid, Pixmap xproto.Pixmap, GlxPixmap Pixmap) []byte {
 	size := 20
 	b := 0
@@ -1648,29 +1705,31 @@ func createGLXPixmapRequest(c *xgb.Conn, Screen uint32, Visual xproto.Visualid,
 	return buf
 }
 
-// Request GetVisualConfigs
-// size: 8
+// GetVisualConfigsCookie is a cookie used only for GetVisualConfigs requests.
 type GetVisualConfigsCookie struct {
 	*xgb.Cookie
 }
 
+// GetVisualConfigs sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetVisualConfigsCookie.Reply()
 func GetVisualConfigs(c *xgb.Conn, Screen uint32) GetVisualConfigsCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getVisualConfigsRequest(c, Screen), cookie)
 	return GetVisualConfigsCookie{cookie}
 }
 
+// GetVisualConfigsUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetVisualConfigsUnchecked(c *xgb.Conn, Screen uint32) GetVisualConfigsCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getVisualConfigsRequest(c, Screen), cookie)
 	return GetVisualConfigsCookie{cookie}
 }
 
-// Request reply for GetVisualConfigs
-// size: (32 + xgb.Pad((int(Length) * 4)))
+// GetVisualConfigsReply represents the data returned from a GetVisualConfigs request.
 type GetVisualConfigsReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	NumVisuals    uint32
 	NumProperties uint32
@@ -1678,7 +1737,7 @@ type GetVisualConfigsReply struct {
 	PropertyList []uint32 // size: xgb.Pad((int(Length) * 4))
 }
 
-// Waits and reads reply data from request GetVisualConfigs
+// Reply blocks and returns the reply data for a GetVisualConfigs request.
 func (cook GetVisualConfigsCookie) Reply() (*GetVisualConfigsReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -1690,7 +1749,7 @@ func (cook GetVisualConfigsCookie) Reply() (*GetVisualConfigsReply, error) {
 	return getVisualConfigsReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetVisualConfigs
+// getVisualConfigsReply reads a byte slice into a GetVisualConfigsReply value.
 func getVisualConfigsReply(buf []byte) *GetVisualConfigsReply {
 	v := new(GetVisualConfigsReply)
 	b := 1 // skip reply determinant
@@ -1722,6 +1781,7 @@ func getVisualConfigsReply(buf []byte) *GetVisualConfigsReply {
 }
 
 // Write request to wire for GetVisualConfigs
+// getVisualConfigsRequest writes a GetVisualConfigs request to a byte slice.
 func getVisualConfigsRequest(c *xgb.Conn, Screen uint32) []byte {
 	size := 8
 	b := 0
@@ -1742,30 +1802,35 @@ func getVisualConfigsRequest(c *xgb.Conn, Screen uint32) []byte {
 	return buf
 }
 
-// Request DestroyGLXPixmap
-// size: 8
+// DestroyGLXPixmapCookie is a cookie used only for DestroyGLXPixmap requests.
 type DestroyGLXPixmapCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for DestroyGLXPixmap
+// DestroyGLXPixmap sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func DestroyGLXPixmap(c *xgb.Conn, GlxPixmap Pixmap) DestroyGLXPixmapCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(destroyGLXPixmapRequest(c, GlxPixmap), cookie)
 	return DestroyGLXPixmapCookie{cookie}
 }
 
+// DestroyGLXPixmapChecked sends a checked request.
+// If an error occurs, it can be retrieved using DestroyGLXPixmapCookie.Check()
 func DestroyGLXPixmapChecked(c *xgb.Conn, GlxPixmap Pixmap) DestroyGLXPixmapCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(destroyGLXPixmapRequest(c, GlxPixmap), cookie)
 	return DestroyGLXPixmapCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook DestroyGLXPixmapCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for DestroyGLXPixmap
+// destroyGLXPixmapRequest writes a DestroyGLXPixmap request to a byte slice.
 func destroyGLXPixmapRequest(c *xgb.Conn, GlxPixmap Pixmap) []byte {
 	size := 8
 	b := 0
@@ -1786,30 +1851,35 @@ func destroyGLXPixmapRequest(c *xgb.Conn, GlxPixmap Pixmap) []byte {
 	return buf
 }
 
-// Request VendorPrivate
-// size: xgb.Pad((12 + xgb.Pad((len(Data) * 1))))
+// VendorPrivateCookie is a cookie used only for VendorPrivate requests.
 type VendorPrivateCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for VendorPrivate
+// VendorPrivate sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func VendorPrivate(c *xgb.Conn, VendorCode uint32, ContextTag ContextTag, Data []byte) VendorPrivateCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(vendorPrivateRequest(c, VendorCode, ContextTag, Data), cookie)
 	return VendorPrivateCookie{cookie}
 }
 
+// VendorPrivateChecked sends a checked request.
+// If an error occurs, it can be retrieved using VendorPrivateCookie.Check()
 func VendorPrivateChecked(c *xgb.Conn, VendorCode uint32, ContextTag ContextTag, Data []byte) VendorPrivateCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(vendorPrivateRequest(c, VendorCode, ContextTag, Data), cookie)
 	return VendorPrivateCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook VendorPrivateCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for VendorPrivate
+// vendorPrivateRequest writes a VendorPrivate request to a byte slice.
 func vendorPrivateRequest(c *xgb.Conn, VendorCode uint32, ContextTag ContextTag, Data []byte) []byte {
 	size := xgb.Pad((12 + xgb.Pad((len(Data) * 1))))
 	b := 0
@@ -1836,36 +1906,38 @@ func vendorPrivateRequest(c *xgb.Conn, VendorCode uint32, ContextTag ContextTag,
 	return buf
 }
 
-// Request VendorPrivateWithReply
-// size: xgb.Pad((12 + xgb.Pad((len(Data) * 1))))
+// VendorPrivateWithReplyCookie is a cookie used only for VendorPrivateWithReply requests.
 type VendorPrivateWithReplyCookie struct {
 	*xgb.Cookie
 }
 
+// VendorPrivateWithReply sends a checked request.
+// If an error occurs, it will be returned with the reply by calling VendorPrivateWithReplyCookie.Reply()
 func VendorPrivateWithReply(c *xgb.Conn, VendorCode uint32, ContextTag ContextTag, Data []byte) VendorPrivateWithReplyCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(vendorPrivateWithReplyRequest(c, VendorCode, ContextTag, Data), cookie)
 	return VendorPrivateWithReplyCookie{cookie}
 }
 
+// VendorPrivateWithReplyUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func VendorPrivateWithReplyUnchecked(c *xgb.Conn, VendorCode uint32, ContextTag ContextTag, Data []byte) VendorPrivateWithReplyCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(vendorPrivateWithReplyRequest(c, VendorCode, ContextTag, Data), cookie)
 	return VendorPrivateWithReplyCookie{cookie}
 }
 
-// Request reply for VendorPrivateWithReply
-// size: (36 + xgb.Pad(((int(Length) * 4) * 1)))
+// VendorPrivateWithReplyReply represents the data returned from a VendorPrivateWithReply request.
 type VendorPrivateWithReplyReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	Retval uint32
 	Data1  []byte // size: 24
 	Data2  []byte // size: xgb.Pad(((int(Length) * 4) * 1))
 }
 
-// Waits and reads reply data from request VendorPrivateWithReply
+// Reply blocks and returns the reply data for a VendorPrivateWithReply request.
 func (cook VendorPrivateWithReplyCookie) Reply() (*VendorPrivateWithReplyReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -1877,7 +1949,7 @@ func (cook VendorPrivateWithReplyCookie) Reply() (*VendorPrivateWithReplyReply,
 	return vendorPrivateWithReplyReply(buf), nil
 }
 
-// Read reply into structure from buffer for VendorPrivateWithReply
+// vendorPrivateWithReplyReply reads a byte slice into a VendorPrivateWithReplyReply value.
 func vendorPrivateWithReplyReply(buf []byte) *VendorPrivateWithReplyReply {
 	v := new(VendorPrivateWithReplyReply)
 	b := 1 // skip reply determinant
@@ -1905,6 +1977,7 @@ func vendorPrivateWithReplyReply(buf []byte) *VendorPrivateWithReplyReply {
 }
 
 // Write request to wire for VendorPrivateWithReply
+// vendorPrivateWithReplyRequest writes a VendorPrivateWithReply request to a byte slice.
 func vendorPrivateWithReplyRequest(c *xgb.Conn, VendorCode uint32, ContextTag ContextTag, Data []byte) []byte {
 	size := xgb.Pad((12 + xgb.Pad((len(Data) * 1))))
 	b := 0
@@ -1931,36 +2004,38 @@ func vendorPrivateWithReplyRequest(c *xgb.Conn, VendorCode uint32, ContextTag Co
 	return buf
 }
 
-// Request QueryExtensionsString
-// size: 8
+// QueryExtensionsStringCookie is a cookie used only for QueryExtensionsString requests.
 type QueryExtensionsStringCookie struct {
 	*xgb.Cookie
 }
 
+// QueryExtensionsString sends a checked request.
+// If an error occurs, it will be returned with the reply by calling QueryExtensionsStringCookie.Reply()
 func QueryExtensionsString(c *xgb.Conn, Screen uint32) QueryExtensionsStringCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(queryExtensionsStringRequest(c, Screen), cookie)
 	return QueryExtensionsStringCookie{cookie}
 }
 
+// QueryExtensionsStringUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func QueryExtensionsStringUnchecked(c *xgb.Conn, Screen uint32) QueryExtensionsStringCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(queryExtensionsStringRequest(c, Screen), cookie)
 	return QueryExtensionsStringCookie{cookie}
 }
 
-// Request reply for QueryExtensionsString
-// size: 32
+// QueryExtensionsStringReply represents the data returned from a QueryExtensionsString request.
 type QueryExtensionsStringReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N uint32
 	// padding: 16 bytes
 }
 
-// Waits and reads reply data from request QueryExtensionsString
+// Reply blocks and returns the reply data for a QueryExtensionsString request.
 func (cook QueryExtensionsStringCookie) Reply() (*QueryExtensionsStringReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -1972,7 +2047,7 @@ func (cook QueryExtensionsStringCookie) Reply() (*QueryExtensionsStringReply, er
 	return queryExtensionsStringReply(buf), nil
 }
 
-// Read reply into structure from buffer for QueryExtensionsString
+// queryExtensionsStringReply reads a byte slice into a QueryExtensionsStringReply value.
 func queryExtensionsStringReply(buf []byte) *QueryExtensionsStringReply {
 	v := new(QueryExtensionsStringReply)
 	b := 1 // skip reply determinant
@@ -1996,6 +2071,7 @@ func queryExtensionsStringReply(buf []byte) *QueryExtensionsStringReply {
 }
 
 // Write request to wire for QueryExtensionsString
+// queryExtensionsStringRequest writes a QueryExtensionsString request to a byte slice.
 func queryExtensionsStringRequest(c *xgb.Conn, Screen uint32) []byte {
 	size := 8
 	b := 0
@@ -2016,29 +2092,31 @@ func queryExtensionsStringRequest(c *xgb.Conn, Screen uint32) []byte {
 	return buf
 }
 
-// Request QueryServerString
-// size: 12
+// QueryServerStringCookie is a cookie used only for QueryServerString requests.
 type QueryServerStringCookie struct {
 	*xgb.Cookie
 }
 
+// QueryServerString sends a checked request.
+// If an error occurs, it will be returned with the reply by calling QueryServerStringCookie.Reply()
 func QueryServerString(c *xgb.Conn, Screen uint32, Name uint32) QueryServerStringCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(queryServerStringRequest(c, Screen, Name), cookie)
 	return QueryServerStringCookie{cookie}
 }
 
+// QueryServerStringUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func QueryServerStringUnchecked(c *xgb.Conn, Screen uint32, Name uint32) QueryServerStringCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(queryServerStringRequest(c, Screen, Name), cookie)
 	return QueryServerStringCookie{cookie}
 }
 
-// Request reply for QueryServerString
-// size: (32 + xgb.Pad((int(StrLen) * 1)))
+// QueryServerStringReply represents the data returned from a QueryServerString request.
 type QueryServerStringReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	StrLen uint32
@@ -2046,7 +2124,7 @@ type QueryServerStringReply struct {
 	String string // size: xgb.Pad((int(StrLen) * 1))
 }
 
-// Waits and reads reply data from request QueryServerString
+// Reply blocks and returns the reply data for a QueryServerString request.
 func (cook QueryServerStringCookie) Reply() (*QueryServerStringReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -2058,7 +2136,7 @@ func (cook QueryServerStringCookie) Reply() (*QueryServerStringReply, error) {
 	return queryServerStringReply(buf), nil
 }
 
-// Read reply into structure from buffer for QueryServerString
+// queryServerStringReply reads a byte slice into a QueryServerStringReply value.
 func queryServerStringReply(buf []byte) *QueryServerStringReply {
 	v := new(QueryServerStringReply)
 	b := 1 // skip reply determinant
@@ -2089,6 +2167,7 @@ func queryServerStringReply(buf []byte) *QueryServerStringReply {
 }
 
 // Write request to wire for QueryServerString
+// queryServerStringRequest writes a QueryServerString request to a byte slice.
 func queryServerStringRequest(c *xgb.Conn, Screen uint32, Name uint32) []byte {
 	size := 12
 	b := 0
@@ -2112,30 +2191,35 @@ func queryServerStringRequest(c *xgb.Conn, Screen uint32, Name uint32) []byte {
 	return buf
 }
 
-// Request ClientInfo
-// size: xgb.Pad((16 + xgb.Pad((int(StrLen) * 1))))
+// ClientInfoCookie is a cookie used only for ClientInfo requests.
 type ClientInfoCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for ClientInfo
+// ClientInfo sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func ClientInfo(c *xgb.Conn, MajorVersion uint32, MinorVersion uint32, StrLen uint32, String string) ClientInfoCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(clientInfoRequest(c, MajorVersion, MinorVersion, StrLen, String), cookie)
 	return ClientInfoCookie{cookie}
 }
 
+// ClientInfoChecked sends a checked request.
+// If an error occurs, it can be retrieved using ClientInfoCookie.Check()
 func ClientInfoChecked(c *xgb.Conn, MajorVersion uint32, MinorVersion uint32, StrLen uint32, String string) ClientInfoCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(clientInfoRequest(c, MajorVersion, MinorVersion, StrLen, String), cookie)
 	return ClientInfoCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook ClientInfoCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for ClientInfo
+// clientInfoRequest writes a ClientInfo request to a byte slice.
 func clientInfoRequest(c *xgb.Conn, MajorVersion uint32, MinorVersion uint32, StrLen uint32, String string) []byte {
 	size := xgb.Pad((16 + xgb.Pad((int(StrLen) * 1))))
 	b := 0
@@ -2165,29 +2249,31 @@ func clientInfoRequest(c *xgb.Conn, MajorVersion uint32, MinorVersion uint32, St
 	return buf
 }
 
-// Request GetFBConfigs
-// size: 8
+// GetFBConfigsCookie is a cookie used only for GetFBConfigs requests.
 type GetFBConfigsCookie struct {
 	*xgb.Cookie
 }
 
+// GetFBConfigs sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetFBConfigsCookie.Reply()
 func GetFBConfigs(c *xgb.Conn, Screen uint32) GetFBConfigsCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getFBConfigsRequest(c, Screen), cookie)
 	return GetFBConfigsCookie{cookie}
 }
 
+// GetFBConfigsUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetFBConfigsUnchecked(c *xgb.Conn, Screen uint32) GetFBConfigsCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getFBConfigsRequest(c, Screen), cookie)
 	return GetFBConfigsCookie{cookie}
 }
 
-// Request reply for GetFBConfigs
-// size: (32 + xgb.Pad((int(Length) * 4)))
+// GetFBConfigsReply represents the data returned from a GetFBConfigs request.
 type GetFBConfigsReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	NumFbConfigs  uint32
 	NumProperties uint32
@@ -2195,7 +2281,7 @@ type GetFBConfigsReply struct {
 	PropertyList []uint32 // size: xgb.Pad((int(Length) * 4))
 }
 
-// Waits and reads reply data from request GetFBConfigs
+// Reply blocks and returns the reply data for a GetFBConfigs request.
 func (cook GetFBConfigsCookie) Reply() (*GetFBConfigsReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -2207,7 +2293,7 @@ func (cook GetFBConfigsCookie) Reply() (*GetFBConfigsReply, error) {
 	return getFBConfigsReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetFBConfigs
+// getFBConfigsReply reads a byte slice into a GetFBConfigsReply value.
 func getFBConfigsReply(buf []byte) *GetFBConfigsReply {
 	v := new(GetFBConfigsReply)
 	b := 1 // skip reply determinant
@@ -2239,6 +2325,7 @@ func getFBConfigsReply(buf []byte) *GetFBConfigsReply {
 }
 
 // Write request to wire for GetFBConfigs
+// getFBConfigsRequest writes a GetFBConfigs request to a byte slice.
 func getFBConfigsRequest(c *xgb.Conn, Screen uint32) []byte {
 	size := 8
 	b := 0
@@ -2259,30 +2346,35 @@ func getFBConfigsRequest(c *xgb.Conn, Screen uint32) []byte {
 	return buf
 }
 
-// Request CreatePixmap
-// size: xgb.Pad((24 + xgb.Pad(((int(NumAttribs) * 2) * 4))))
+// CreatePixmapCookie is a cookie used only for CreatePixmap requests.
 type CreatePixmapCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for CreatePixmap
+// CreatePixmap sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func CreatePixmap(c *xgb.Conn, Screen uint32, Fbconfig Fbconfig, Pixmap xproto.Pixmap, GlxPixmap Pixmap, NumAttribs uint32, Attribs []uint32) CreatePixmapCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(createPixmapRequest(c, Screen, Fbconfig, Pixmap, GlxPixmap, NumAttribs, Attribs), cookie)
 	return CreatePixmapCookie{cookie}
 }
 
+// CreatePixmapChecked sends a checked request.
+// If an error occurs, it can be retrieved using CreatePixmapCookie.Check()
 func CreatePixmapChecked(c *xgb.Conn, Screen uint32, Fbconfig Fbconfig, Pixmap xproto.Pixmap, GlxPixmap Pixmap, NumAttribs uint32, Attribs []uint32) CreatePixmapCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(createPixmapRequest(c, Screen, Fbconfig, Pixmap, GlxPixmap, NumAttribs, Attribs), cookie)
 	return CreatePixmapCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook CreatePixmapCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for CreatePixmap
+// createPixmapRequest writes a CreatePixmap request to a byte slice.
 func createPixmapRequest(c *xgb.Conn, Screen uint32, Fbconfig Fbconfig, Pixmap xproto.Pixmap, GlxPixmap Pixmap, NumAttribs uint32, Attribs []uint32) []byte {
 	size := xgb.Pad((24 + xgb.Pad(((int(NumAttribs) * 2) * 4))))
 	b := 0
@@ -2321,30 +2413,35 @@ func createPixmapRequest(c *xgb.Conn, Screen uint32, Fbconfig Fbconfig, Pixmap x
 	return buf
 }
 
-// Request DestroyPixmap
-// size: 8
+// DestroyPixmapCookie is a cookie used only for DestroyPixmap requests.
 type DestroyPixmapCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for DestroyPixmap
+// DestroyPixmap sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func DestroyPixmap(c *xgb.Conn, GlxPixmap Pixmap) DestroyPixmapCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(destroyPixmapRequest(c, GlxPixmap), cookie)
 	return DestroyPixmapCookie{cookie}
 }
 
+// DestroyPixmapChecked sends a checked request.
+// If an error occurs, it can be retrieved using DestroyPixmapCookie.Check()
 func DestroyPixmapChecked(c *xgb.Conn, GlxPixmap Pixmap) DestroyPixmapCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(destroyPixmapRequest(c, GlxPixmap), cookie)
 	return DestroyPixmapCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook DestroyPixmapCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for DestroyPixmap
+// destroyPixmapRequest writes a DestroyPixmap request to a byte slice.
 func destroyPixmapRequest(c *xgb.Conn, GlxPixmap Pixmap) []byte {
 	size := 8
 	b := 0
@@ -2365,30 +2462,35 @@ func destroyPixmapRequest(c *xgb.Conn, GlxPixmap Pixmap) []byte {
 	return buf
 }
 
-// Request CreateNewContext
-// size: 28
+// CreateNewContextCookie is a cookie used only for CreateNewContext requests.
 type CreateNewContextCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for CreateNewContext
+// CreateNewContext sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func CreateNewContext(c *xgb.Conn, Context Context, Fbconfig Fbconfig, Screen uint32, RenderType uint32, ShareList Context, IsDirect bool) CreateNewContextCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(createNewContextRequest(c, Context, Fbconfig, Screen, RenderType, ShareList, IsDirect), cookie)
 	return CreateNewContextCookie{cookie}
 }
 
+// CreateNewContextChecked sends a checked request.
+// If an error occurs, it can be retrieved using CreateNewContextCookie.Check()
 func CreateNewContextChecked(c *xgb.Conn, Context Context, Fbconfig Fbconfig, Screen uint32, RenderType uint32, ShareList Context, IsDirect bool) CreateNewContextCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(createNewContextRequest(c, Context, Fbconfig, Screen, RenderType, ShareList, IsDirect), cookie)
 	return CreateNewContextCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook CreateNewContextCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for CreateNewContext
+// createNewContextRequest writes a CreateNewContext request to a byte slice.
 func createNewContextRequest(c *xgb.Conn, Context Context, Fbconfig Fbconfig, Screen uint32, RenderType uint32, ShareList Context, IsDirect bool) []byte {
 	size := 28
 	b := 0
@@ -2430,36 +2532,38 @@ func createNewContextRequest(c *xgb.Conn, Context Context, Fbconfig Fbconfig, Sc
 	return buf
 }
 
-// Request QueryContext
-// size: 8
+// QueryContextCookie is a cookie used only for QueryContext requests.
 type QueryContextCookie struct {
 	*xgb.Cookie
 }
 
+// QueryContext sends a checked request.
+// If an error occurs, it will be returned with the reply by calling QueryContextCookie.Reply()
 func QueryContext(c *xgb.Conn, Context Context) QueryContextCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(queryContextRequest(c, Context), cookie)
 	return QueryContextCookie{cookie}
 }
 
+// QueryContextUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func QueryContextUnchecked(c *xgb.Conn, Context Context) QueryContextCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(queryContextRequest(c, Context), cookie)
 	return QueryContextCookie{cookie}
 }
 
-// Request reply for QueryContext
-// size: (32 + xgb.Pad(((int(NumAttribs) * 2) * 4)))
+// QueryContextReply represents the data returned from a QueryContext request.
 type QueryContextReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	NumAttribs uint32
 	// padding: 20 bytes
 	Attribs []uint32 // size: xgb.Pad(((int(NumAttribs) * 2) * 4))
 }
 
-// Waits and reads reply data from request QueryContext
+// Reply blocks and returns the reply data for a QueryContext request.
 func (cook QueryContextCookie) Reply() (*QueryContextReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -2471,7 +2575,7 @@ func (cook QueryContextCookie) Reply() (*QueryContextReply, error) {
 	return queryContextReply(buf), nil
 }
 
-// Read reply into structure from buffer for QueryContext
+// queryContextReply reads a byte slice into a QueryContextReply value.
 func queryContextReply(buf []byte) *QueryContextReply {
 	v := new(QueryContextReply)
 	b := 1 // skip reply determinant
@@ -2500,6 +2604,7 @@ func queryContextReply(buf []byte) *QueryContextReply {
 }
 
 // Write request to wire for QueryContext
+// queryContextRequest writes a QueryContext request to a byte slice.
 func queryContextRequest(c *xgb.Conn, Context Context) []byte {
 	size := 8
 	b := 0
@@ -2520,35 +2625,37 @@ func queryContextRequest(c *xgb.Conn, Context Context) []byte {
 	return buf
 }
 
-// Request MakeContextCurrent
-// size: 20
+// MakeContextCurrentCookie is a cookie used only for MakeContextCurrent requests.
 type MakeContextCurrentCookie struct {
 	*xgb.Cookie
 }
 
+// MakeContextCurrent sends a checked request.
+// If an error occurs, it will be returned with the reply by calling MakeContextCurrentCookie.Reply()
 func MakeContextCurrent(c *xgb.Conn, OldContextTag ContextTag, Drawable Drawable, ReadDrawable Drawable, Context Context) MakeContextCurrentCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(makeContextCurrentRequest(c, OldContextTag, Drawable, ReadDrawable, Context), cookie)
 	return MakeContextCurrentCookie{cookie}
 }
 
+// MakeContextCurrentUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func MakeContextCurrentUnchecked(c *xgb.Conn, OldContextTag ContextTag, Drawable Drawable, ReadDrawable Drawable, Context Context) MakeContextCurrentCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(makeContextCurrentRequest(c, OldContextTag, Drawable, ReadDrawable, Context), cookie)
 	return MakeContextCurrentCookie{cookie}
 }
 
-// Request reply for MakeContextCurrent
-// size: 32
+// MakeContextCurrentReply represents the data returned from a MakeContextCurrent request.
 type MakeContextCurrentReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	ContextTag ContextTag
 	// padding: 20 bytes
 }
 
-// Waits and reads reply data from request MakeContextCurrent
+// Reply blocks and returns the reply data for a MakeContextCurrent request.
 func (cook MakeContextCurrentCookie) Reply() (*MakeContextCurrentReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -2560,7 +2667,7 @@ func (cook MakeContextCurrentCookie) Reply() (*MakeContextCurrentReply, error) {
 	return makeContextCurrentReply(buf), nil
 }
 
-// Read reply into structure from buffer for MakeContextCurrent
+// makeContextCurrentReply reads a byte slice into a MakeContextCurrentReply value.
 func makeContextCurrentReply(buf []byte) *MakeContextCurrentReply {
 	v := new(MakeContextCurrentReply)
 	b := 1 // skip reply determinant
@@ -2582,6 +2689,7 @@ func makeContextCurrentReply(buf []byte) *MakeContextCurrentReply {
 }
 
 // Write request to wire for MakeContextCurrent
+// makeContextCurrentRequest writes a MakeContextCurrent request to a byte slice.
 func makeContextCurrentRequest(c *xgb.Conn, OldContextTag ContextTag, Drawable Drawable, ReadDrawable Drawable, Context Context) []byte {
 	size := 20
 	b := 0
@@ -2611,30 +2719,35 @@ func makeContextCurrentRequest(c *xgb.Conn, OldContextTag ContextTag, Drawable D
 	return buf
 }
 
-// Request CreatePbuffer
-// size: xgb.Pad((20 + xgb.Pad(((int(NumAttribs) * 2) * 4))))
+// CreatePbufferCookie is a cookie used only for CreatePbuffer requests.
 type CreatePbufferCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for CreatePbuffer
+// CreatePbuffer sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func CreatePbuffer(c *xgb.Conn, Screen uint32, Fbconfig Fbconfig, Pbuffer Pbuffer, NumAttribs uint32, Attribs []uint32) CreatePbufferCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(createPbufferRequest(c, Screen, Fbconfig, Pbuffer, NumAttribs, Attribs), cookie)
 	return CreatePbufferCookie{cookie}
 }
 
+// CreatePbufferChecked sends a checked request.
+// If an error occurs, it can be retrieved using CreatePbufferCookie.Check()
 func CreatePbufferChecked(c *xgb.Conn, Screen uint32, Fbconfig Fbconfig, Pbuffer Pbuffer, NumAttribs uint32, Attribs []uint32) CreatePbufferCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(createPbufferRequest(c, Screen, Fbconfig, Pbuffer, NumAttribs, Attribs), cookie)
 	return CreatePbufferCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook CreatePbufferCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for CreatePbuffer
+// createPbufferRequest writes a CreatePbuffer request to a byte slice.
 func createPbufferRequest(c *xgb.Conn, Screen uint32, Fbconfig Fbconfig, Pbuffer Pbuffer, NumAttribs uint32, Attribs []uint32) []byte {
 	size := xgb.Pad((20 + xgb.Pad(((int(NumAttribs) * 2) * 4))))
 	b := 0
@@ -2670,30 +2783,35 @@ func createPbufferRequest(c *xgb.Conn, Screen uint32, Fbconfig Fbconfig, Pbuffer
 	return buf
 }
 
-// Request DestroyPbuffer
-// size: 8
+// DestroyPbufferCookie is a cookie used only for DestroyPbuffer requests.
 type DestroyPbufferCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for DestroyPbuffer
+// DestroyPbuffer sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func DestroyPbuffer(c *xgb.Conn, Pbuffer Pbuffer) DestroyPbufferCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(destroyPbufferRequest(c, Pbuffer), cookie)
 	return DestroyPbufferCookie{cookie}
 }
 
+// DestroyPbufferChecked sends a checked request.
+// If an error occurs, it can be retrieved using DestroyPbufferCookie.Check()
 func DestroyPbufferChecked(c *xgb.Conn, Pbuffer Pbuffer) DestroyPbufferCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(destroyPbufferRequest(c, Pbuffer), cookie)
 	return DestroyPbufferCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook DestroyPbufferCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for DestroyPbuffer
+// destroyPbufferRequest writes a DestroyPbuffer request to a byte slice.
 func destroyPbufferRequest(c *xgb.Conn, Pbuffer Pbuffer) []byte {
 	size := 8
 	b := 0
@@ -2714,36 +2832,38 @@ func destroyPbufferRequest(c *xgb.Conn, Pbuffer Pbuffer) []byte {
 	return buf
 }
 
-// Request GetDrawableAttributes
-// size: 8
+// GetDrawableAttributesCookie is a cookie used only for GetDrawableAttributes requests.
 type GetDrawableAttributesCookie struct {
 	*xgb.Cookie
 }
 
+// GetDrawableAttributes sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetDrawableAttributesCookie.Reply()
 func GetDrawableAttributes(c *xgb.Conn, Drawable Drawable) GetDrawableAttributesCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getDrawableAttributesRequest(c, Drawable), cookie)
 	return GetDrawableAttributesCookie{cookie}
 }
 
+// GetDrawableAttributesUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetDrawableAttributesUnchecked(c *xgb.Conn, Drawable Drawable) GetDrawableAttributesCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getDrawableAttributesRequest(c, Drawable), cookie)
 	return GetDrawableAttributesCookie{cookie}
 }
 
-// Request reply for GetDrawableAttributes
-// size: (32 + xgb.Pad(((int(NumAttribs) * 2) * 4)))
+// GetDrawableAttributesReply represents the data returned from a GetDrawableAttributes request.
 type GetDrawableAttributesReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	NumAttribs uint32
 	// padding: 20 bytes
 	Attribs []uint32 // size: xgb.Pad(((int(NumAttribs) * 2) * 4))
 }
 
-// Waits and reads reply data from request GetDrawableAttributes
+// Reply blocks and returns the reply data for a GetDrawableAttributes request.
 func (cook GetDrawableAttributesCookie) Reply() (*GetDrawableAttributesReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -2755,7 +2875,7 @@ func (cook GetDrawableAttributesCookie) Reply() (*GetDrawableAttributesReply, er
 	return getDrawableAttributesReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetDrawableAttributes
+// getDrawableAttributesReply reads a byte slice into a GetDrawableAttributesReply value.
 func getDrawableAttributesReply(buf []byte) *GetDrawableAttributesReply {
 	v := new(GetDrawableAttributesReply)
 	b := 1 // skip reply determinant
@@ -2784,6 +2904,7 @@ func getDrawableAttributesReply(buf []byte) *GetDrawableAttributesReply {
 }
 
 // Write request to wire for GetDrawableAttributes
+// getDrawableAttributesRequest writes a GetDrawableAttributes request to a byte slice.
 func getDrawableAttributesRequest(c *xgb.Conn, Drawable Drawable) []byte {
 	size := 8
 	b := 0
@@ -2804,30 +2925,35 @@ func getDrawableAttributesRequest(c *xgb.Conn, Drawable Drawable) []byte {
 	return buf
 }
 
-// Request ChangeDrawableAttributes
-// size: xgb.Pad((12 + xgb.Pad(((int(NumAttribs) * 2) * 4))))
+// ChangeDrawableAttributesCookie is a cookie used only for ChangeDrawableAttributes requests.
 type ChangeDrawableAttributesCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for ChangeDrawableAttributes
+// ChangeDrawableAttributes sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func ChangeDrawableAttributes(c *xgb.Conn, Drawable Drawable, NumAttribs uint32, Attribs []uint32) ChangeDrawableAttributesCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(changeDrawableAttributesRequest(c, Drawable, NumAttribs, Attribs), cookie)
 	return ChangeDrawableAttributesCookie{cookie}
 }
 
+// ChangeDrawableAttributesChecked sends a checked request.
+// If an error occurs, it can be retrieved using ChangeDrawableAttributesCookie.Check()
 func ChangeDrawableAttributesChecked(c *xgb.Conn, Drawable Drawable, NumAttribs uint32, Attribs []uint32) ChangeDrawableAttributesCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(changeDrawableAttributesRequest(c, Drawable, NumAttribs, Attribs), cookie)
 	return ChangeDrawableAttributesCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook ChangeDrawableAttributesCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for ChangeDrawableAttributes
+// changeDrawableAttributesRequest writes a ChangeDrawableAttributes request to a byte slice.
 func changeDrawableAttributesRequest(c *xgb.Conn, Drawable Drawable, NumAttribs uint32, Attribs []uint32) []byte {
 	size := xgb.Pad((12 + xgb.Pad(((int(NumAttribs) * 2) * 4))))
 	b := 0
@@ -2857,30 +2983,35 @@ func changeDrawableAttributesRequest(c *xgb.Conn, Drawable Drawable, NumAttribs
 	return buf
 }
 
-// Request CreateWindow
-// size: xgb.Pad((24 + xgb.Pad(((int(NumAttribs) * 2) * 4))))
+// CreateWindowCookie is a cookie used only for CreateWindow requests.
 type CreateWindowCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for CreateWindow
+// CreateWindow sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func CreateWindow(c *xgb.Conn, Screen uint32, Fbconfig Fbconfig, Window xproto.Window, GlxWindow Window, NumAttribs uint32, Attribs []uint32) CreateWindowCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(createWindowRequest(c, Screen, Fbconfig, Window, GlxWindow, NumAttribs, Attribs), cookie)
 	return CreateWindowCookie{cookie}
 }
 
+// CreateWindowChecked sends a checked request.
+// If an error occurs, it can be retrieved using CreateWindowCookie.Check()
 func CreateWindowChecked(c *xgb.Conn, Screen uint32, Fbconfig Fbconfig, Window xproto.Window, GlxWindow Window, NumAttribs uint32, Attribs []uint32) CreateWindowCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(createWindowRequest(c, Screen, Fbconfig, Window, GlxWindow, NumAttribs, Attribs), cookie)
 	return CreateWindowCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook CreateWindowCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for CreateWindow
+// createWindowRequest writes a CreateWindow request to a byte slice.
 func createWindowRequest(c *xgb.Conn, Screen uint32, Fbconfig Fbconfig, Window xproto.Window, GlxWindow Window, NumAttribs uint32, Attribs []uint32) []byte {
 	size := xgb.Pad((24 + xgb.Pad(((int(NumAttribs) * 2) * 4))))
 	b := 0
@@ -2919,30 +3050,35 @@ func createWindowRequest(c *xgb.Conn, Screen uint32, Fbconfig Fbconfig, Window x
 	return buf
 }
 
-// Request DeleteWindow
-// size: 8
+// DeleteWindowCookie is a cookie used only for DeleteWindow requests.
 type DeleteWindowCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for DeleteWindow
+// DeleteWindow sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func DeleteWindow(c *xgb.Conn, Glxwindow Window) DeleteWindowCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(deleteWindowRequest(c, Glxwindow), cookie)
 	return DeleteWindowCookie{cookie}
 }
 
+// DeleteWindowChecked sends a checked request.
+// If an error occurs, it can be retrieved using DeleteWindowCookie.Check()
 func DeleteWindowChecked(c *xgb.Conn, Glxwindow Window) DeleteWindowCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(deleteWindowRequest(c, Glxwindow), cookie)
 	return DeleteWindowCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook DeleteWindowCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for DeleteWindow
+// deleteWindowRequest writes a DeleteWindow request to a byte slice.
 func deleteWindowRequest(c *xgb.Conn, Glxwindow Window) []byte {
 	size := 8
 	b := 0
@@ -2963,30 +3099,35 @@ func deleteWindowRequest(c *xgb.Conn, Glxwindow Window) []byte {
 	return buf
 }
 
-// Request SetClientInfoARB
-// size: xgb.Pad((((24 + xgb.Pad(((int(NumVersions) * 2) * 4))) + xgb.Pad((int(GlStrLen) * 1))) + xgb.Pad((int(GlxStrLen) * 1))))
+// SetClientInfoARBCookie is a cookie used only for SetClientInfoARB requests.
 type SetClientInfoARBCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for SetClientInfoARB
+// SetClientInfoARB sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func SetClientInfoARB(c *xgb.Conn, MajorVersion uint32, MinorVersion uint32, NumVersions uint32, GlStrLen uint32, GlxStrLen uint32, GlVersions []uint32, GlExtensionString string, GlxExtensionString string) SetClientInfoARBCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(setClientInfoARBRequest(c, MajorVersion, MinorVersion, NumVersions, GlStrLen, GlxStrLen, GlVersions, GlExtensionString, GlxExtensionString), cookie)
 	return SetClientInfoARBCookie{cookie}
 }
 
+// SetClientInfoARBChecked sends a checked request.
+// If an error occurs, it can be retrieved using SetClientInfoARBCookie.Check()
 func SetClientInfoARBChecked(c *xgb.Conn, MajorVersion uint32, MinorVersion uint32, NumVersions uint32, GlStrLen uint32, GlxStrLen uint32, GlVersions []uint32, GlExtensionString string, GlxExtensionString string) SetClientInfoARBCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(setClientInfoARBRequest(c, MajorVersion, MinorVersion, NumVersions, GlStrLen, GlxStrLen, GlVersions, GlExtensionString, GlxExtensionString), cookie)
 	return SetClientInfoARBCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook SetClientInfoARBCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for SetClientInfoARB
+// setClientInfoARBRequest writes a SetClientInfoARB request to a byte slice.
 func setClientInfoARBRequest(c *xgb.Conn, MajorVersion uint32, MinorVersion uint32, NumVersions uint32, GlStrLen uint32, GlxStrLen uint32, GlVersions []uint32, GlExtensionString string, GlxExtensionString string) []byte {
 	size := xgb.Pad((((24 + xgb.Pad(((int(NumVersions) * 2) * 4))) + xgb.Pad((int(GlStrLen) * 1))) + xgb.Pad((int(GlxStrLen) * 1))))
 	b := 0
@@ -3031,30 +3172,35 @@ func setClientInfoARBRequest(c *xgb.Conn, MajorVersion uint32, MinorVersion uint
 	return buf
 }
 
-// Request CreateContextAttribsARB
-// size: xgb.Pad((28 + xgb.Pad(((int(NumAttribs) * 2) * 4))))
+// CreateContextAttribsARBCookie is a cookie used only for CreateContextAttribsARB requests.
 type CreateContextAttribsARBCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for CreateContextAttribsARB
+// CreateContextAttribsARB sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func CreateContextAttribsARB(c *xgb.Conn, Context Context, Fbconfig Fbconfig, Screen uint32, ShareList Context, IsDirect bool, NumAttribs uint32, Attribs []uint32) CreateContextAttribsARBCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(createContextAttribsARBRequest(c, Context, Fbconfig, Screen, ShareList, IsDirect, NumAttribs, Attribs), cookie)
 	return CreateContextAttribsARBCookie{cookie}
 }
 
+// CreateContextAttribsARBChecked sends a checked request.
+// If an error occurs, it can be retrieved using CreateContextAttribsARBCookie.Check()
 func CreateContextAttribsARBChecked(c *xgb.Conn, Context Context, Fbconfig Fbconfig, Screen uint32, ShareList Context, IsDirect bool, NumAttribs uint32, Attribs []uint32) CreateContextAttribsARBCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(createContextAttribsARBRequest(c, Context, Fbconfig, Screen, ShareList, IsDirect, NumAttribs, Attribs), cookie)
 	return CreateContextAttribsARBCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook CreateContextAttribsARBCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for CreateContextAttribsARB
+// createContextAttribsARBRequest writes a CreateContextAttribsARB request to a byte slice.
 func createContextAttribsARBRequest(c *xgb.Conn, Context Context, Fbconfig Fbconfig, Screen uint32, ShareList Context, IsDirect bool, NumAttribs uint32, Attribs []uint32) []byte {
 	size := xgb.Pad((28 + xgb.Pad(((int(NumAttribs) * 2) * 4))))
 	b := 0
@@ -3102,30 +3248,35 @@ func createContextAttribsARBRequest(c *xgb.Conn, Context Context, Fbconfig Fbcon
 	return buf
 }
 
-// Request SetClientInfo2ARB
-// size: xgb.Pad((((24 + xgb.Pad(((int(NumVersions) * 3) * 4))) + xgb.Pad((int(GlStrLen) * 1))) + xgb.Pad((int(GlxStrLen) * 1))))
+// SetClientInfo2ARBCookie is a cookie used only for SetClientInfo2ARB requests.
 type SetClientInfo2ARBCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for SetClientInfo2ARB
+// SetClientInfo2ARB sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func SetClientInfo2ARB(c *xgb.Conn, MajorVersion uint32, MinorVersion uint32, NumVersions uint32, GlStrLen uint32, GlxStrLen uint32, GlVersions []uint32, GlExtensionString string, GlxExtensionString string) SetClientInfo2ARBCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(setClientInfo2ARBRequest(c, MajorVersion, MinorVersion, NumVersions, GlStrLen, GlxStrLen, GlVersions, GlExtensionString, GlxExtensionString), cookie)
 	return SetClientInfo2ARBCookie{cookie}
 }
 
+// SetClientInfo2ARBChecked sends a checked request.
+// If an error occurs, it can be retrieved using SetClientInfo2ARBCookie.Check()
 func SetClientInfo2ARBChecked(c *xgb.Conn, MajorVersion uint32, MinorVersion uint32, NumVersions uint32, GlStrLen uint32, GlxStrLen uint32, GlVersions []uint32, GlExtensionString string, GlxExtensionString string) SetClientInfo2ARBCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(setClientInfo2ARBRequest(c, MajorVersion, MinorVersion, NumVersions, GlStrLen, GlxStrLen, GlVersions, GlExtensionString, GlxExtensionString), cookie)
 	return SetClientInfo2ARBCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook SetClientInfo2ARBCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for SetClientInfo2ARB
+// setClientInfo2ARBRequest writes a SetClientInfo2ARB request to a byte slice.
 func setClientInfo2ARBRequest(c *xgb.Conn, MajorVersion uint32, MinorVersion uint32, NumVersions uint32, GlStrLen uint32, GlxStrLen uint32, GlVersions []uint32, GlExtensionString string, GlxExtensionString string) []byte {
 	size := xgb.Pad((((24 + xgb.Pad(((int(NumVersions) * 3) * 4))) + xgb.Pad((int(GlStrLen) * 1))) + xgb.Pad((int(GlxStrLen) * 1))))
 	b := 0
@@ -3170,30 +3321,35 @@ func setClientInfo2ARBRequest(c *xgb.Conn, MajorVersion uint32, MinorVersion uin
 	return buf
 }
 
-// Request NewList
-// size: 16
+// NewListCookie is a cookie used only for NewList requests.
 type NewListCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for NewList
+// NewList sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func NewList(c *xgb.Conn, ContextTag ContextTag, List uint32, Mode uint32) NewListCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(newListRequest(c, ContextTag, List, Mode), cookie)
 	return NewListCookie{cookie}
 }
 
+// NewListChecked sends a checked request.
+// If an error occurs, it can be retrieved using NewListCookie.Check()
 func NewListChecked(c *xgb.Conn, ContextTag ContextTag, List uint32, Mode uint32) NewListCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(newListRequest(c, ContextTag, List, Mode), cookie)
 	return NewListCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook NewListCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for NewList
+// newListRequest writes a NewList request to a byte slice.
 func newListRequest(c *xgb.Conn, ContextTag ContextTag, List uint32, Mode uint32) []byte {
 	size := 16
 	b := 0
@@ -3220,30 +3376,35 @@ func newListRequest(c *xgb.Conn, ContextTag ContextTag, List uint32, Mode uint32
 	return buf
 }
 
-// Request EndList
-// size: 8
+// EndListCookie is a cookie used only for EndList requests.
 type EndListCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for EndList
+// EndList sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func EndList(c *xgb.Conn, ContextTag ContextTag) EndListCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(endListRequest(c, ContextTag), cookie)
 	return EndListCookie{cookie}
 }
 
+// EndListChecked sends a checked request.
+// If an error occurs, it can be retrieved using EndListCookie.Check()
 func EndListChecked(c *xgb.Conn, ContextTag ContextTag) EndListCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(endListRequest(c, ContextTag), cookie)
 	return EndListCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook EndListCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for EndList
+// endListRequest writes a EndList request to a byte slice.
 func endListRequest(c *xgb.Conn, ContextTag ContextTag) []byte {
 	size := 8
 	b := 0
@@ -3264,30 +3425,35 @@ func endListRequest(c *xgb.Conn, ContextTag ContextTag) []byte {
 	return buf
 }
 
-// Request DeleteLists
-// size: 16
+// DeleteListsCookie is a cookie used only for DeleteLists requests.
 type DeleteListsCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for DeleteLists
+// DeleteLists sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func DeleteLists(c *xgb.Conn, ContextTag ContextTag, List uint32, Range int32) DeleteListsCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(deleteListsRequest(c, ContextTag, List, Range), cookie)
 	return DeleteListsCookie{cookie}
 }
 
+// DeleteListsChecked sends a checked request.
+// If an error occurs, it can be retrieved using DeleteListsCookie.Check()
 func DeleteListsChecked(c *xgb.Conn, ContextTag ContextTag, List uint32, Range int32) DeleteListsCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(deleteListsRequest(c, ContextTag, List, Range), cookie)
 	return DeleteListsCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook DeleteListsCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for DeleteLists
+// deleteListsRequest writes a DeleteLists request to a byte slice.
 func deleteListsRequest(c *xgb.Conn, ContextTag ContextTag, List uint32, Range int32) []byte {
 	size := 16
 	b := 0
@@ -3314,34 +3480,36 @@ func deleteListsRequest(c *xgb.Conn, ContextTag ContextTag, List uint32, Range i
 	return buf
 }
 
-// Request GenLists
-// size: 12
+// GenListsCookie is a cookie used only for GenLists requests.
 type GenListsCookie struct {
 	*xgb.Cookie
 }
 
+// GenLists sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GenListsCookie.Reply()
 func GenLists(c *xgb.Conn, ContextTag ContextTag, Range int32) GenListsCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(genListsRequest(c, ContextTag, Range), cookie)
 	return GenListsCookie{cookie}
 }
 
+// GenListsUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GenListsUnchecked(c *xgb.Conn, ContextTag ContextTag, Range int32) GenListsCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(genListsRequest(c, ContextTag, Range), cookie)
 	return GenListsCookie{cookie}
 }
 
-// Request reply for GenLists
-// size: 12
+// GenListsReply represents the data returned from a GenLists request.
 type GenListsReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	RetVal uint32
 }
 
-// Waits and reads reply data from request GenLists
+// Reply blocks and returns the reply data for a GenLists request.
 func (cook GenListsCookie) Reply() (*GenListsReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -3353,7 +3521,7 @@ func (cook GenListsCookie) Reply() (*GenListsReply, error) {
 	return genListsReply(buf), nil
 }
 
-// Read reply into structure from buffer for GenLists
+// genListsReply reads a byte slice into a GenListsReply value.
 func genListsReply(buf []byte) *GenListsReply {
 	v := new(GenListsReply)
 	b := 1 // skip reply determinant
@@ -3373,6 +3541,7 @@ func genListsReply(buf []byte) *GenListsReply {
 }
 
 // Write request to wire for GenLists
+// genListsRequest writes a GenLists request to a byte slice.
 func genListsRequest(c *xgb.Conn, ContextTag ContextTag, Range int32) []byte {
 	size := 12
 	b := 0
@@ -3396,30 +3565,35 @@ func genListsRequest(c *xgb.Conn, ContextTag ContextTag, Range int32) []byte {
 	return buf
 }
 
-// Request FeedbackBuffer
-// size: 16
+// FeedbackBufferCookie is a cookie used only for FeedbackBuffer requests.
 type FeedbackBufferCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for FeedbackBuffer
+// FeedbackBuffer sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func FeedbackBuffer(c *xgb.Conn, ContextTag ContextTag, Size int32, Type int32) FeedbackBufferCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(feedbackBufferRequest(c, ContextTag, Size, Type), cookie)
 	return FeedbackBufferCookie{cookie}
 }
 
+// FeedbackBufferChecked sends a checked request.
+// If an error occurs, it can be retrieved using FeedbackBufferCookie.Check()
 func FeedbackBufferChecked(c *xgb.Conn, ContextTag ContextTag, Size int32, Type int32) FeedbackBufferCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(feedbackBufferRequest(c, ContextTag, Size, Type), cookie)
 	return FeedbackBufferCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook FeedbackBufferCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for FeedbackBuffer
+// feedbackBufferRequest writes a FeedbackBuffer request to a byte slice.
 func feedbackBufferRequest(c *xgb.Conn, ContextTag ContextTag, Size int32, Type int32) []byte {
 	size := 16
 	b := 0
@@ -3446,30 +3620,35 @@ func feedbackBufferRequest(c *xgb.Conn, ContextTag ContextTag, Size int32, Type
 	return buf
 }
 
-// Request SelectBuffer
-// size: 12
+// SelectBufferCookie is a cookie used only for SelectBuffer requests.
 type SelectBufferCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for SelectBuffer
+// SelectBuffer sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func SelectBuffer(c *xgb.Conn, ContextTag ContextTag, Size int32) SelectBufferCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(selectBufferRequest(c, ContextTag, Size), cookie)
 	return SelectBufferCookie{cookie}
 }
 
+// SelectBufferChecked sends a checked request.
+// If an error occurs, it can be retrieved using SelectBufferCookie.Check()
 func SelectBufferChecked(c *xgb.Conn, ContextTag ContextTag, Size int32) SelectBufferCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(selectBufferRequest(c, ContextTag, Size), cookie)
 	return SelectBufferCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook SelectBufferCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for SelectBuffer
+// selectBufferRequest writes a SelectBuffer request to a byte slice.
 func selectBufferRequest(c *xgb.Conn, ContextTag ContextTag, Size int32) []byte {
 	size := 12
 	b := 0
@@ -3493,29 +3672,31 @@ func selectBufferRequest(c *xgb.Conn, ContextTag ContextTag, Size int32) []byte
 	return buf
 }
 
-// Request RenderMode
-// size: 12
+// RenderModeCookie is a cookie used only for RenderMode requests.
 type RenderModeCookie struct {
 	*xgb.Cookie
 }
 
+// RenderMode sends a checked request.
+// If an error occurs, it will be returned with the reply by calling RenderModeCookie.Reply()
 func RenderMode(c *xgb.Conn, ContextTag ContextTag, Mode uint32) RenderModeCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(renderModeRequest(c, ContextTag, Mode), cookie)
 	return RenderModeCookie{cookie}
 }
 
+// RenderModeUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func RenderModeUnchecked(c *xgb.Conn, ContextTag ContextTag, Mode uint32) RenderModeCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(renderModeRequest(c, ContextTag, Mode), cookie)
 	return RenderModeCookie{cookie}
 }
 
-// Request reply for RenderMode
-// size: (32 + xgb.Pad((int(N) * 4)))
+// RenderModeReply represents the data returned from a RenderMode request.
 type RenderModeReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	RetVal  uint32
 	N       uint32
@@ -3524,7 +3705,7 @@ type RenderModeReply struct {
 	Data []uint32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request RenderMode
+// Reply blocks and returns the reply data for a RenderMode request.
 func (cook RenderModeCookie) Reply() (*RenderModeReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -3536,7 +3717,7 @@ func (cook RenderModeCookie) Reply() (*RenderModeReply, error) {
 	return renderModeReply(buf), nil
 }
 
-// Read reply into structure from buffer for RenderMode
+// renderModeReply reads a byte slice into a RenderModeReply value.
 func renderModeReply(buf []byte) *RenderModeReply {
 	v := new(RenderModeReply)
 	b := 1 // skip reply determinant
@@ -3571,6 +3752,7 @@ func renderModeReply(buf []byte) *RenderModeReply {
 }
 
 // Write request to wire for RenderMode
+// renderModeRequest writes a RenderMode request to a byte slice.
 func renderModeRequest(c *xgb.Conn, ContextTag ContextTag, Mode uint32) []byte {
 	size := 12
 	b := 0
@@ -3594,33 +3776,35 @@ func renderModeRequest(c *xgb.Conn, ContextTag ContextTag, Mode uint32) []byte {
 	return buf
 }
 
-// Request Finish
-// size: 8
+// FinishCookie is a cookie used only for Finish requests.
 type FinishCookie struct {
 	*xgb.Cookie
 }
 
+// Finish sends a checked request.
+// If an error occurs, it will be returned with the reply by calling FinishCookie.Reply()
 func Finish(c *xgb.Conn, ContextTag ContextTag) FinishCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(finishRequest(c, ContextTag), cookie)
 	return FinishCookie{cookie}
 }
 
+// FinishUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func FinishUnchecked(c *xgb.Conn, ContextTag ContextTag) FinishCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(finishRequest(c, ContextTag), cookie)
 	return FinishCookie{cookie}
 }
 
-// Request reply for Finish
-// size: 8
+// FinishReply represents the data returned from a Finish request.
 type FinishReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 }
 
-// Waits and reads reply data from request Finish
+// Reply blocks and returns the reply data for a Finish request.
 func (cook FinishCookie) Reply() (*FinishReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -3632,7 +3816,7 @@ func (cook FinishCookie) Reply() (*FinishReply, error) {
 	return finishReply(buf), nil
 }
 
-// Read reply into structure from buffer for Finish
+// finishReply reads a byte slice into a FinishReply value.
 func finishReply(buf []byte) *FinishReply {
 	v := new(FinishReply)
 	b := 1 // skip reply determinant
@@ -3649,6 +3833,7 @@ func finishReply(buf []byte) *FinishReply {
 }
 
 // Write request to wire for Finish
+// finishRequest writes a Finish request to a byte slice.
 func finishRequest(c *xgb.Conn, ContextTag ContextTag) []byte {
 	size := 8
 	b := 0
@@ -3669,30 +3854,35 @@ func finishRequest(c *xgb.Conn, ContextTag ContextTag) []byte {
 	return buf
 }
 
-// Request PixelStoref
-// size: 16
+// PixelStorefCookie is a cookie used only for PixelStoref requests.
 type PixelStorefCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for PixelStoref
+// PixelStoref sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func PixelStoref(c *xgb.Conn, ContextTag ContextTag, Pname uint32, Datum Float32) PixelStorefCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(pixelStorefRequest(c, ContextTag, Pname, Datum), cookie)
 	return PixelStorefCookie{cookie}
 }
 
+// PixelStorefChecked sends a checked request.
+// If an error occurs, it can be retrieved using PixelStorefCookie.Check()
 func PixelStorefChecked(c *xgb.Conn, ContextTag ContextTag, Pname uint32, Datum Float32) PixelStorefCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(pixelStorefRequest(c, ContextTag, Pname, Datum), cookie)
 	return PixelStorefCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook PixelStorefCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for PixelStoref
+// pixelStorefRequest writes a PixelStoref request to a byte slice.
 func pixelStorefRequest(c *xgb.Conn, ContextTag ContextTag, Pname uint32, Datum Float32) []byte {
 	size := 16
 	b := 0
@@ -3719,30 +3909,35 @@ func pixelStorefRequest(c *xgb.Conn, ContextTag ContextTag, Pname uint32, Datum
 	return buf
 }
 
-// Request PixelStorei
-// size: 16
+// PixelStoreiCookie is a cookie used only for PixelStorei requests.
 type PixelStoreiCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for PixelStorei
+// PixelStorei sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func PixelStorei(c *xgb.Conn, ContextTag ContextTag, Pname uint32, Datum int32) PixelStoreiCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(pixelStoreiRequest(c, ContextTag, Pname, Datum), cookie)
 	return PixelStoreiCookie{cookie}
 }
 
+// PixelStoreiChecked sends a checked request.
+// If an error occurs, it can be retrieved using PixelStoreiCookie.Check()
 func PixelStoreiChecked(c *xgb.Conn, ContextTag ContextTag, Pname uint32, Datum int32) PixelStoreiCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(pixelStoreiRequest(c, ContextTag, Pname, Datum), cookie)
 	return PixelStoreiCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook PixelStoreiCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for PixelStorei
+// pixelStoreiRequest writes a PixelStorei request to a byte slice.
 func pixelStoreiRequest(c *xgb.Conn, ContextTag ContextTag, Pname uint32, Datum int32) []byte {
 	size := 16
 	b := 0
@@ -3769,35 +3964,37 @@ func pixelStoreiRequest(c *xgb.Conn, ContextTag ContextTag, Pname uint32, Datum
 	return buf
 }
 
-// Request ReadPixels
-// size: 36
+// ReadPixelsCookie is a cookie used only for ReadPixels requests.
 type ReadPixelsCookie struct {
 	*xgb.Cookie
 }
 
+// ReadPixels sends a checked request.
+// If an error occurs, it will be returned with the reply by calling ReadPixelsCookie.Reply()
 func ReadPixels(c *xgb.Conn, ContextTag ContextTag, X int32, Y int32, Width int32, Height int32, Format uint32, Type uint32, SwapBytes bool, LsbFirst bool) ReadPixelsCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(readPixelsRequest(c, ContextTag, X, Y, Width, Height, Format, Type, SwapBytes, LsbFirst), cookie)
 	return ReadPixelsCookie{cookie}
 }
 
+// ReadPixelsUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func ReadPixelsUnchecked(c *xgb.Conn, ContextTag ContextTag, X int32, Y int32, Width int32, Height int32, Format uint32, Type uint32, SwapBytes bool, LsbFirst bool) ReadPixelsCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(readPixelsRequest(c, ContextTag, X, Y, Width, Height, Format, Type, SwapBytes, LsbFirst), cookie)
 	return ReadPixelsCookie{cookie}
 }
 
-// Request reply for ReadPixels
-// size: (32 + xgb.Pad(((int(Length) * 4) * 1)))
+// ReadPixelsReply represents the data returned from a ReadPixels request.
 type ReadPixelsReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 24 bytes
 	Data []byte // size: xgb.Pad(((int(Length) * 4) * 1))
 }
 
-// Waits and reads reply data from request ReadPixels
+// Reply blocks and returns the reply data for a ReadPixels request.
 func (cook ReadPixelsCookie) Reply() (*ReadPixelsReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -3809,7 +4006,7 @@ func (cook ReadPixelsCookie) Reply() (*ReadPixelsReply, error) {
 	return readPixelsReply(buf), nil
 }
 
-// Read reply into structure from buffer for ReadPixels
+// readPixelsReply reads a byte slice into a ReadPixelsReply value.
 func readPixelsReply(buf []byte) *ReadPixelsReply {
 	v := new(ReadPixelsReply)
 	b := 1 // skip reply determinant
@@ -3832,6 +4029,7 @@ func readPixelsReply(buf []byte) *ReadPixelsReply {
 }
 
 // Write request to wire for ReadPixels
+// readPixelsRequest writes a ReadPixels request to a byte slice.
 func readPixelsRequest(c *xgb.Conn, ContextTag ContextTag, X int32, Y int32, Width int32, Height int32, Format uint32, Type uint32, SwapBytes bool, LsbFirst bool) []byte {
 	size := 36
 	b := 0
@@ -3884,29 +4082,31 @@ func readPixelsRequest(c *xgb.Conn, ContextTag ContextTag, X int32, Y int32, Wid
 	return buf
 }
 
-// Request GetBooleanv
-// size: 12
+// GetBooleanvCookie is a cookie used only for GetBooleanv requests.
 type GetBooleanvCookie struct {
 	*xgb.Cookie
 }
 
+// GetBooleanv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetBooleanvCookie.Reply()
 func GetBooleanv(c *xgb.Conn, ContextTag ContextTag, Pname int32) GetBooleanvCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getBooleanvRequest(c, ContextTag, Pname), cookie)
 	return GetBooleanvCookie{cookie}
 }
 
+// GetBooleanvUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetBooleanvUnchecked(c *xgb.Conn, ContextTag ContextTag, Pname int32) GetBooleanvCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getBooleanvRequest(c, ContextTag, Pname), cookie)
 	return GetBooleanvCookie{cookie}
 }
 
-// Request reply for GetBooleanv
-// size: (32 + xgb.Pad((int(N) * 1)))
+// GetBooleanvReply represents the data returned from a GetBooleanv request.
 type GetBooleanvReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -3915,7 +4115,7 @@ type GetBooleanvReply struct {
 	Data []bool // size: xgb.Pad((int(N) * 1))
 }
 
-// Waits and reads reply data from request GetBooleanv
+// Reply blocks and returns the reply data for a GetBooleanv request.
 func (cook GetBooleanvCookie) Reply() (*GetBooleanvReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -3927,7 +4127,7 @@ func (cook GetBooleanvCookie) Reply() (*GetBooleanvReply, error) {
 	return getBooleanvReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetBooleanv
+// getBooleanvReply reads a byte slice into a GetBooleanvReply value.
 func getBooleanvReply(buf []byte) *GetBooleanvReply {
 	v := new(GetBooleanvReply)
 	b := 1 // skip reply determinant
@@ -3969,6 +4169,7 @@ func getBooleanvReply(buf []byte) *GetBooleanvReply {
 }
 
 // Write request to wire for GetBooleanv
+// getBooleanvRequest writes a GetBooleanv request to a byte slice.
 func getBooleanvRequest(c *xgb.Conn, ContextTag ContextTag, Pname int32) []byte {
 	size := 12
 	b := 0
@@ -3992,35 +4193,37 @@ func getBooleanvRequest(c *xgb.Conn, ContextTag ContextTag, Pname int32) []byte
 	return buf
 }
 
-// Request GetClipPlane
-// size: 12
+// GetClipPlaneCookie is a cookie used only for GetClipPlane requests.
 type GetClipPlaneCookie struct {
 	*xgb.Cookie
 }
 
+// GetClipPlane sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetClipPlaneCookie.Reply()
 func GetClipPlane(c *xgb.Conn, ContextTag ContextTag, Plane int32) GetClipPlaneCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getClipPlaneRequest(c, ContextTag, Plane), cookie)
 	return GetClipPlaneCookie{cookie}
 }
 
+// GetClipPlaneUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetClipPlaneUnchecked(c *xgb.Conn, ContextTag ContextTag, Plane int32) GetClipPlaneCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getClipPlaneRequest(c, ContextTag, Plane), cookie)
 	return GetClipPlaneCookie{cookie}
 }
 
-// Request reply for GetClipPlane
-// size: (32 + xgb.Pad(((int(Length) / 2) * 8)))
+// GetClipPlaneReply represents the data returned from a GetClipPlane request.
 type GetClipPlaneReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 24 bytes
 	Data []Float64 // size: xgb.Pad(((int(Length) / 2) * 8))
 }
 
-// Waits and reads reply data from request GetClipPlane
+// Reply blocks and returns the reply data for a GetClipPlane request.
 func (cook GetClipPlaneCookie) Reply() (*GetClipPlaneReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -4032,7 +4235,7 @@ func (cook GetClipPlaneCookie) Reply() (*GetClipPlaneReply, error) {
 	return getClipPlaneReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetClipPlane
+// getClipPlaneReply reads a byte slice into a GetClipPlaneReply value.
 func getClipPlaneReply(buf []byte) *GetClipPlaneReply {
 	v := new(GetClipPlaneReply)
 	b := 1 // skip reply determinant
@@ -4058,6 +4261,7 @@ func getClipPlaneReply(buf []byte) *GetClipPlaneReply {
 }
 
 // Write request to wire for GetClipPlane
+// getClipPlaneRequest writes a GetClipPlane request to a byte slice.
 func getClipPlaneRequest(c *xgb.Conn, ContextTag ContextTag, Plane int32) []byte {
 	size := 12
 	b := 0
@@ -4081,29 +4285,31 @@ func getClipPlaneRequest(c *xgb.Conn, ContextTag ContextTag, Plane int32) []byte
 	return buf
 }
 
-// Request GetDoublev
-// size: 12
+// GetDoublevCookie is a cookie used only for GetDoublev requests.
 type GetDoublevCookie struct {
 	*xgb.Cookie
 }
 
+// GetDoublev sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetDoublevCookie.Reply()
 func GetDoublev(c *xgb.Conn, ContextTag ContextTag, Pname uint32) GetDoublevCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getDoublevRequest(c, ContextTag, Pname), cookie)
 	return GetDoublevCookie{cookie}
 }
 
+// GetDoublevUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetDoublevUnchecked(c *xgb.Conn, ContextTag ContextTag, Pname uint32) GetDoublevCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getDoublevRequest(c, ContextTag, Pname), cookie)
 	return GetDoublevCookie{cookie}
 }
 
-// Request reply for GetDoublev
-// size: (32 + xgb.Pad((int(N) * 8)))
+// GetDoublevReply represents the data returned from a GetDoublev request.
 type GetDoublevReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -4112,7 +4318,7 @@ type GetDoublevReply struct {
 	Data []Float64 // size: xgb.Pad((int(N) * 8))
 }
 
-// Waits and reads reply data from request GetDoublev
+// Reply blocks and returns the reply data for a GetDoublev request.
 func (cook GetDoublevCookie) Reply() (*GetDoublevReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -4124,7 +4330,7 @@ func (cook GetDoublevCookie) Reply() (*GetDoublevReply, error) {
 	return getDoublevReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetDoublev
+// getDoublevReply reads a byte slice into a GetDoublevReply value.
 func getDoublevReply(buf []byte) *GetDoublevReply {
 	v := new(GetDoublevReply)
 	b := 1 // skip reply determinant
@@ -4158,6 +4364,7 @@ func getDoublevReply(buf []byte) *GetDoublevReply {
 }
 
 // Write request to wire for GetDoublev
+// getDoublevRequest writes a GetDoublev request to a byte slice.
 func getDoublevRequest(c *xgb.Conn, ContextTag ContextTag, Pname uint32) []byte {
 	size := 12
 	b := 0
@@ -4181,34 +4388,36 @@ func getDoublevRequest(c *xgb.Conn, ContextTag ContextTag, Pname uint32) []byte
 	return buf
 }
 
-// Request GetError
-// size: 8
+// GetErrorCookie is a cookie used only for GetError requests.
 type GetErrorCookie struct {
 	*xgb.Cookie
 }
 
+// GetError sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetErrorCookie.Reply()
 func GetError(c *xgb.Conn, ContextTag ContextTag) GetErrorCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getErrorRequest(c, ContextTag), cookie)
 	return GetErrorCookie{cookie}
 }
 
+// GetErrorUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetErrorUnchecked(c *xgb.Conn, ContextTag ContextTag) GetErrorCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getErrorRequest(c, ContextTag), cookie)
 	return GetErrorCookie{cookie}
 }
 
-// Request reply for GetError
-// size: 12
+// GetErrorReply represents the data returned from a GetError request.
 type GetErrorReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	Error int32
 }
 
-// Waits and reads reply data from request GetError
+// Reply blocks and returns the reply data for a GetError request.
 func (cook GetErrorCookie) Reply() (*GetErrorReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -4220,7 +4429,7 @@ func (cook GetErrorCookie) Reply() (*GetErrorReply, error) {
 	return getErrorReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetError
+// getErrorReply reads a byte slice into a GetErrorReply value.
 func getErrorReply(buf []byte) *GetErrorReply {
 	v := new(GetErrorReply)
 	b := 1 // skip reply determinant
@@ -4240,6 +4449,7 @@ func getErrorReply(buf []byte) *GetErrorReply {
 }
 
 // Write request to wire for GetError
+// getErrorRequest writes a GetError request to a byte slice.
 func getErrorRequest(c *xgb.Conn, ContextTag ContextTag) []byte {
 	size := 8
 	b := 0
@@ -4260,29 +4470,31 @@ func getErrorRequest(c *xgb.Conn, ContextTag ContextTag) []byte {
 	return buf
 }
 
-// Request GetFloatv
-// size: 12
+// GetFloatvCookie is a cookie used only for GetFloatv requests.
 type GetFloatvCookie struct {
 	*xgb.Cookie
 }
 
+// GetFloatv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetFloatvCookie.Reply()
 func GetFloatv(c *xgb.Conn, ContextTag ContextTag, Pname uint32) GetFloatvCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getFloatvRequest(c, ContextTag, Pname), cookie)
 	return GetFloatvCookie{cookie}
 }
 
+// GetFloatvUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetFloatvUnchecked(c *xgb.Conn, ContextTag ContextTag, Pname uint32) GetFloatvCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getFloatvRequest(c, ContextTag, Pname), cookie)
 	return GetFloatvCookie{cookie}
 }
 
-// Request reply for GetFloatv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetFloatvReply represents the data returned from a GetFloatv request.
 type GetFloatvReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -4291,7 +4503,7 @@ type GetFloatvReply struct {
 	Data []Float32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetFloatv
+// Reply blocks and returns the reply data for a GetFloatv request.
 func (cook GetFloatvCookie) Reply() (*GetFloatvReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -4303,7 +4515,7 @@ func (cook GetFloatvCookie) Reply() (*GetFloatvReply, error) {
 	return getFloatvReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetFloatv
+// getFloatvReply reads a byte slice into a GetFloatvReply value.
 func getFloatvReply(buf []byte) *GetFloatvReply {
 	v := new(GetFloatvReply)
 	b := 1 // skip reply determinant
@@ -4337,6 +4549,7 @@ func getFloatvReply(buf []byte) *GetFloatvReply {
 }
 
 // Write request to wire for GetFloatv
+// getFloatvRequest writes a GetFloatv request to a byte slice.
 func getFloatvRequest(c *xgb.Conn, ContextTag ContextTag, Pname uint32) []byte {
 	size := 12
 	b := 0
@@ -4360,29 +4573,31 @@ func getFloatvRequest(c *xgb.Conn, ContextTag ContextTag, Pname uint32) []byte {
 	return buf
 }
 
-// Request GetIntegerv
-// size: 12
+// GetIntegervCookie is a cookie used only for GetIntegerv requests.
 type GetIntegervCookie struct {
 	*xgb.Cookie
 }
 
+// GetIntegerv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetIntegervCookie.Reply()
 func GetIntegerv(c *xgb.Conn, ContextTag ContextTag, Pname uint32) GetIntegervCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getIntegervRequest(c, ContextTag, Pname), cookie)
 	return GetIntegervCookie{cookie}
 }
 
+// GetIntegervUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetIntegervUnchecked(c *xgb.Conn, ContextTag ContextTag, Pname uint32) GetIntegervCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getIntegervRequest(c, ContextTag, Pname), cookie)
 	return GetIntegervCookie{cookie}
 }
 
-// Request reply for GetIntegerv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetIntegervReply represents the data returned from a GetIntegerv request.
 type GetIntegervReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -4391,7 +4606,7 @@ type GetIntegervReply struct {
 	Data []int32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetIntegerv
+// Reply blocks and returns the reply data for a GetIntegerv request.
 func (cook GetIntegervCookie) Reply() (*GetIntegervReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -4403,7 +4618,7 @@ func (cook GetIntegervCookie) Reply() (*GetIntegervReply, error) {
 	return getIntegervReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetIntegerv
+// getIntegervReply reads a byte slice into a GetIntegervReply value.
 func getIntegervReply(buf []byte) *GetIntegervReply {
 	v := new(GetIntegervReply)
 	b := 1 // skip reply determinant
@@ -4437,6 +4652,7 @@ func getIntegervReply(buf []byte) *GetIntegervReply {
 }
 
 // Write request to wire for GetIntegerv
+// getIntegervRequest writes a GetIntegerv request to a byte slice.
 func getIntegervRequest(c *xgb.Conn, ContextTag ContextTag, Pname uint32) []byte {
 	size := 12
 	b := 0
@@ -4460,29 +4676,31 @@ func getIntegervRequest(c *xgb.Conn, ContextTag ContextTag, Pname uint32) []byte
 	return buf
 }
 
-// Request GetLightfv
-// size: 16
+// GetLightfvCookie is a cookie used only for GetLightfv requests.
 type GetLightfvCookie struct {
 	*xgb.Cookie
 }
 
+// GetLightfv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetLightfvCookie.Reply()
 func GetLightfv(c *xgb.Conn, ContextTag ContextTag, Light uint32, Pname uint32) GetLightfvCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getLightfvRequest(c, ContextTag, Light, Pname), cookie)
 	return GetLightfvCookie{cookie}
 }
 
+// GetLightfvUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetLightfvUnchecked(c *xgb.Conn, ContextTag ContextTag, Light uint32, Pname uint32) GetLightfvCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getLightfvRequest(c, ContextTag, Light, Pname), cookie)
 	return GetLightfvCookie{cookie}
 }
 
-// Request reply for GetLightfv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetLightfvReply represents the data returned from a GetLightfv request.
 type GetLightfvReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -4491,7 +4709,7 @@ type GetLightfvReply struct {
 	Data []Float32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetLightfv
+// Reply blocks and returns the reply data for a GetLightfv request.
 func (cook GetLightfvCookie) Reply() (*GetLightfvReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -4503,7 +4721,7 @@ func (cook GetLightfvCookie) Reply() (*GetLightfvReply, error) {
 	return getLightfvReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetLightfv
+// getLightfvReply reads a byte slice into a GetLightfvReply value.
 func getLightfvReply(buf []byte) *GetLightfvReply {
 	v := new(GetLightfvReply)
 	b := 1 // skip reply determinant
@@ -4537,6 +4755,7 @@ func getLightfvReply(buf []byte) *GetLightfvReply {
 }
 
 // Write request to wire for GetLightfv
+// getLightfvRequest writes a GetLightfv request to a byte slice.
 func getLightfvRequest(c *xgb.Conn, ContextTag ContextTag, Light uint32, Pname uint32) []byte {
 	size := 16
 	b := 0
@@ -4563,29 +4782,31 @@ func getLightfvRequest(c *xgb.Conn, ContextTag ContextTag, Light uint32, Pname u
 	return buf
 }
 
-// Request GetLightiv
-// size: 16
+// GetLightivCookie is a cookie used only for GetLightiv requests.
 type GetLightivCookie struct {
 	*xgb.Cookie
 }
 
+// GetLightiv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetLightivCookie.Reply()
 func GetLightiv(c *xgb.Conn, ContextTag ContextTag, Light uint32, Pname uint32) GetLightivCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getLightivRequest(c, ContextTag, Light, Pname), cookie)
 	return GetLightivCookie{cookie}
 }
 
+// GetLightivUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetLightivUnchecked(c *xgb.Conn, ContextTag ContextTag, Light uint32, Pname uint32) GetLightivCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getLightivRequest(c, ContextTag, Light, Pname), cookie)
 	return GetLightivCookie{cookie}
 }
 
-// Request reply for GetLightiv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetLightivReply represents the data returned from a GetLightiv request.
 type GetLightivReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -4594,7 +4815,7 @@ type GetLightivReply struct {
 	Data []int32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetLightiv
+// Reply blocks and returns the reply data for a GetLightiv request.
 func (cook GetLightivCookie) Reply() (*GetLightivReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -4606,7 +4827,7 @@ func (cook GetLightivCookie) Reply() (*GetLightivReply, error) {
 	return getLightivReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetLightiv
+// getLightivReply reads a byte slice into a GetLightivReply value.
 func getLightivReply(buf []byte) *GetLightivReply {
 	v := new(GetLightivReply)
 	b := 1 // skip reply determinant
@@ -4640,6 +4861,7 @@ func getLightivReply(buf []byte) *GetLightivReply {
 }
 
 // Write request to wire for GetLightiv
+// getLightivRequest writes a GetLightiv request to a byte slice.
 func getLightivRequest(c *xgb.Conn, ContextTag ContextTag, Light uint32, Pname uint32) []byte {
 	size := 16
 	b := 0
@@ -4666,29 +4888,31 @@ func getLightivRequest(c *xgb.Conn, ContextTag ContextTag, Light uint32, Pname u
 	return buf
 }
 
-// Request GetMapdv
-// size: 16
+// GetMapdvCookie is a cookie used only for GetMapdv requests.
 type GetMapdvCookie struct {
 	*xgb.Cookie
 }
 
+// GetMapdv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetMapdvCookie.Reply()
 func GetMapdv(c *xgb.Conn, ContextTag ContextTag, Target uint32, Query uint32) GetMapdvCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getMapdvRequest(c, ContextTag, Target, Query), cookie)
 	return GetMapdvCookie{cookie}
 }
 
+// GetMapdvUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetMapdvUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Query uint32) GetMapdvCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getMapdvRequest(c, ContextTag, Target, Query), cookie)
 	return GetMapdvCookie{cookie}
 }
 
-// Request reply for GetMapdv
-// size: (32 + xgb.Pad((int(N) * 8)))
+// GetMapdvReply represents the data returned from a GetMapdv request.
 type GetMapdvReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -4697,7 +4921,7 @@ type GetMapdvReply struct {
 	Data []Float64 // size: xgb.Pad((int(N) * 8))
 }
 
-// Waits and reads reply data from request GetMapdv
+// Reply blocks and returns the reply data for a GetMapdv request.
 func (cook GetMapdvCookie) Reply() (*GetMapdvReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -4709,7 +4933,7 @@ func (cook GetMapdvCookie) Reply() (*GetMapdvReply, error) {
 	return getMapdvReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetMapdv
+// getMapdvReply reads a byte slice into a GetMapdvReply value.
 func getMapdvReply(buf []byte) *GetMapdvReply {
 	v := new(GetMapdvReply)
 	b := 1 // skip reply determinant
@@ -4743,6 +4967,7 @@ func getMapdvReply(buf []byte) *GetMapdvReply {
 }
 
 // Write request to wire for GetMapdv
+// getMapdvRequest writes a GetMapdv request to a byte slice.
 func getMapdvRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Query uint32) []byte {
 	size := 16
 	b := 0
@@ -4769,29 +4994,31 @@ func getMapdvRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Query ui
 	return buf
 }
 
-// Request GetMapfv
-// size: 16
+// GetMapfvCookie is a cookie used only for GetMapfv requests.
 type GetMapfvCookie struct {
 	*xgb.Cookie
 }
 
+// GetMapfv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetMapfvCookie.Reply()
 func GetMapfv(c *xgb.Conn, ContextTag ContextTag, Target uint32, Query uint32) GetMapfvCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getMapfvRequest(c, ContextTag, Target, Query), cookie)
 	return GetMapfvCookie{cookie}
 }
 
+// GetMapfvUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetMapfvUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Query uint32) GetMapfvCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getMapfvRequest(c, ContextTag, Target, Query), cookie)
 	return GetMapfvCookie{cookie}
 }
 
-// Request reply for GetMapfv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetMapfvReply represents the data returned from a GetMapfv request.
 type GetMapfvReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -4800,7 +5027,7 @@ type GetMapfvReply struct {
 	Data []Float32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetMapfv
+// Reply blocks and returns the reply data for a GetMapfv request.
 func (cook GetMapfvCookie) Reply() (*GetMapfvReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -4812,7 +5039,7 @@ func (cook GetMapfvCookie) Reply() (*GetMapfvReply, error) {
 	return getMapfvReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetMapfv
+// getMapfvReply reads a byte slice into a GetMapfvReply value.
 func getMapfvReply(buf []byte) *GetMapfvReply {
 	v := new(GetMapfvReply)
 	b := 1 // skip reply determinant
@@ -4846,6 +5073,7 @@ func getMapfvReply(buf []byte) *GetMapfvReply {
 }
 
 // Write request to wire for GetMapfv
+// getMapfvRequest writes a GetMapfv request to a byte slice.
 func getMapfvRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Query uint32) []byte {
 	size := 16
 	b := 0
@@ -4872,29 +5100,31 @@ func getMapfvRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Query ui
 	return buf
 }
 
-// Request GetMapiv
-// size: 16
+// GetMapivCookie is a cookie used only for GetMapiv requests.
 type GetMapivCookie struct {
 	*xgb.Cookie
 }
 
+// GetMapiv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetMapivCookie.Reply()
 func GetMapiv(c *xgb.Conn, ContextTag ContextTag, Target uint32, Query uint32) GetMapivCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getMapivRequest(c, ContextTag, Target, Query), cookie)
 	return GetMapivCookie{cookie}
 }
 
+// GetMapivUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetMapivUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Query uint32) GetMapivCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getMapivRequest(c, ContextTag, Target, Query), cookie)
 	return GetMapivCookie{cookie}
 }
 
-// Request reply for GetMapiv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetMapivReply represents the data returned from a GetMapiv request.
 type GetMapivReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -4903,7 +5133,7 @@ type GetMapivReply struct {
 	Data []int32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetMapiv
+// Reply blocks and returns the reply data for a GetMapiv request.
 func (cook GetMapivCookie) Reply() (*GetMapivReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -4915,7 +5145,7 @@ func (cook GetMapivCookie) Reply() (*GetMapivReply, error) {
 	return getMapivReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetMapiv
+// getMapivReply reads a byte slice into a GetMapivReply value.
 func getMapivReply(buf []byte) *GetMapivReply {
 	v := new(GetMapivReply)
 	b := 1 // skip reply determinant
@@ -4949,6 +5179,7 @@ func getMapivReply(buf []byte) *GetMapivReply {
 }
 
 // Write request to wire for GetMapiv
+// getMapivRequest writes a GetMapiv request to a byte slice.
 func getMapivRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Query uint32) []byte {
 	size := 16
 	b := 0
@@ -4975,29 +5206,31 @@ func getMapivRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Query ui
 	return buf
 }
 
-// Request GetMaterialfv
-// size: 16
+// GetMaterialfvCookie is a cookie used only for GetMaterialfv requests.
 type GetMaterialfvCookie struct {
 	*xgb.Cookie
 }
 
+// GetMaterialfv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetMaterialfvCookie.Reply()
 func GetMaterialfv(c *xgb.Conn, ContextTag ContextTag, Face uint32, Pname uint32) GetMaterialfvCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getMaterialfvRequest(c, ContextTag, Face, Pname), cookie)
 	return GetMaterialfvCookie{cookie}
 }
 
+// GetMaterialfvUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetMaterialfvUnchecked(c *xgb.Conn, ContextTag ContextTag, Face uint32, Pname uint32) GetMaterialfvCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getMaterialfvRequest(c, ContextTag, Face, Pname), cookie)
 	return GetMaterialfvCookie{cookie}
 }
 
-// Request reply for GetMaterialfv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetMaterialfvReply represents the data returned from a GetMaterialfv request.
 type GetMaterialfvReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -5006,7 +5239,7 @@ type GetMaterialfvReply struct {
 	Data []Float32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetMaterialfv
+// Reply blocks and returns the reply data for a GetMaterialfv request.
 func (cook GetMaterialfvCookie) Reply() (*GetMaterialfvReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -5018,7 +5251,7 @@ func (cook GetMaterialfvCookie) Reply() (*GetMaterialfvReply, error) {
 	return getMaterialfvReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetMaterialfv
+// getMaterialfvReply reads a byte slice into a GetMaterialfvReply value.
 func getMaterialfvReply(buf []byte) *GetMaterialfvReply {
 	v := new(GetMaterialfvReply)
 	b := 1 // skip reply determinant
@@ -5052,6 +5285,7 @@ func getMaterialfvReply(buf []byte) *GetMaterialfvReply {
 }
 
 // Write request to wire for GetMaterialfv
+// getMaterialfvRequest writes a GetMaterialfv request to a byte slice.
 func getMaterialfvRequest(c *xgb.Conn, ContextTag ContextTag, Face uint32, Pname uint32) []byte {
 	size := 16
 	b := 0
@@ -5078,29 +5312,31 @@ func getMaterialfvRequest(c *xgb.Conn, ContextTag ContextTag, Face uint32, Pname
 	return buf
 }
 
-// Request GetMaterialiv
-// size: 16
+// GetMaterialivCookie is a cookie used only for GetMaterialiv requests.
 type GetMaterialivCookie struct {
 	*xgb.Cookie
 }
 
+// GetMaterialiv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetMaterialivCookie.Reply()
 func GetMaterialiv(c *xgb.Conn, ContextTag ContextTag, Face uint32, Pname uint32) GetMaterialivCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getMaterialivRequest(c, ContextTag, Face, Pname), cookie)
 	return GetMaterialivCookie{cookie}
 }
 
+// GetMaterialivUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetMaterialivUnchecked(c *xgb.Conn, ContextTag ContextTag, Face uint32, Pname uint32) GetMaterialivCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getMaterialivRequest(c, ContextTag, Face, Pname), cookie)
 	return GetMaterialivCookie{cookie}
 }
 
-// Request reply for GetMaterialiv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetMaterialivReply represents the data returned from a GetMaterialiv request.
 type GetMaterialivReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -5109,7 +5345,7 @@ type GetMaterialivReply struct {
 	Data []int32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetMaterialiv
+// Reply blocks and returns the reply data for a GetMaterialiv request.
 func (cook GetMaterialivCookie) Reply() (*GetMaterialivReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -5121,7 +5357,7 @@ func (cook GetMaterialivCookie) Reply() (*GetMaterialivReply, error) {
 	return getMaterialivReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetMaterialiv
+// getMaterialivReply reads a byte slice into a GetMaterialivReply value.
 func getMaterialivReply(buf []byte) *GetMaterialivReply {
 	v := new(GetMaterialivReply)
 	b := 1 // skip reply determinant
@@ -5155,6 +5391,7 @@ func getMaterialivReply(buf []byte) *GetMaterialivReply {
 }
 
 // Write request to wire for GetMaterialiv
+// getMaterialivRequest writes a GetMaterialiv request to a byte slice.
 func getMaterialivRequest(c *xgb.Conn, ContextTag ContextTag, Face uint32, Pname uint32) []byte {
 	size := 16
 	b := 0
@@ -5181,29 +5418,31 @@ func getMaterialivRequest(c *xgb.Conn, ContextTag ContextTag, Face uint32, Pname
 	return buf
 }
 
-// Request GetPixelMapfv
-// size: 12
+// GetPixelMapfvCookie is a cookie used only for GetPixelMapfv requests.
 type GetPixelMapfvCookie struct {
 	*xgb.Cookie
 }
 
+// GetPixelMapfv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetPixelMapfvCookie.Reply()
 func GetPixelMapfv(c *xgb.Conn, ContextTag ContextTag, Map uint32) GetPixelMapfvCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getPixelMapfvRequest(c, ContextTag, Map), cookie)
 	return GetPixelMapfvCookie{cookie}
 }
 
+// GetPixelMapfvUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetPixelMapfvUnchecked(c *xgb.Conn, ContextTag ContextTag, Map uint32) GetPixelMapfvCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getPixelMapfvRequest(c, ContextTag, Map), cookie)
 	return GetPixelMapfvCookie{cookie}
 }
 
-// Request reply for GetPixelMapfv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetPixelMapfvReply represents the data returned from a GetPixelMapfv request.
 type GetPixelMapfvReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -5212,7 +5451,7 @@ type GetPixelMapfvReply struct {
 	Data []Float32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetPixelMapfv
+// Reply blocks and returns the reply data for a GetPixelMapfv request.
 func (cook GetPixelMapfvCookie) Reply() (*GetPixelMapfvReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -5224,7 +5463,7 @@ func (cook GetPixelMapfvCookie) Reply() (*GetPixelMapfvReply, error) {
 	return getPixelMapfvReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetPixelMapfv
+// getPixelMapfvReply reads a byte slice into a GetPixelMapfvReply value.
 func getPixelMapfvReply(buf []byte) *GetPixelMapfvReply {
 	v := new(GetPixelMapfvReply)
 	b := 1 // skip reply determinant
@@ -5258,6 +5497,7 @@ func getPixelMapfvReply(buf []byte) *GetPixelMapfvReply {
 }
 
 // Write request to wire for GetPixelMapfv
+// getPixelMapfvRequest writes a GetPixelMapfv request to a byte slice.
 func getPixelMapfvRequest(c *xgb.Conn, ContextTag ContextTag, Map uint32) []byte {
 	size := 12
 	b := 0
@@ -5281,29 +5521,31 @@ func getPixelMapfvRequest(c *xgb.Conn, ContextTag ContextTag, Map uint32) []byte
 	return buf
 }
 
-// Request GetPixelMapuiv
-// size: 12
+// GetPixelMapuivCookie is a cookie used only for GetPixelMapuiv requests.
 type GetPixelMapuivCookie struct {
 	*xgb.Cookie
 }
 
+// GetPixelMapuiv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetPixelMapuivCookie.Reply()
 func GetPixelMapuiv(c *xgb.Conn, ContextTag ContextTag, Map uint32) GetPixelMapuivCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getPixelMapuivRequest(c, ContextTag, Map), cookie)
 	return GetPixelMapuivCookie{cookie}
 }
 
+// GetPixelMapuivUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetPixelMapuivUnchecked(c *xgb.Conn, ContextTag ContextTag, Map uint32) GetPixelMapuivCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getPixelMapuivRequest(c, ContextTag, Map), cookie)
 	return GetPixelMapuivCookie{cookie}
 }
 
-// Request reply for GetPixelMapuiv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetPixelMapuivReply represents the data returned from a GetPixelMapuiv request.
 type GetPixelMapuivReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -5312,7 +5554,7 @@ type GetPixelMapuivReply struct {
 	Data []uint32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetPixelMapuiv
+// Reply blocks and returns the reply data for a GetPixelMapuiv request.
 func (cook GetPixelMapuivCookie) Reply() (*GetPixelMapuivReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -5324,7 +5566,7 @@ func (cook GetPixelMapuivCookie) Reply() (*GetPixelMapuivReply, error) {
 	return getPixelMapuivReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetPixelMapuiv
+// getPixelMapuivReply reads a byte slice into a GetPixelMapuivReply value.
 func getPixelMapuivReply(buf []byte) *GetPixelMapuivReply {
 	v := new(GetPixelMapuivReply)
 	b := 1 // skip reply determinant
@@ -5358,6 +5600,7 @@ func getPixelMapuivReply(buf []byte) *GetPixelMapuivReply {
 }
 
 // Write request to wire for GetPixelMapuiv
+// getPixelMapuivRequest writes a GetPixelMapuiv request to a byte slice.
 func getPixelMapuivRequest(c *xgb.Conn, ContextTag ContextTag, Map uint32) []byte {
 	size := 12
 	b := 0
@@ -5381,29 +5624,31 @@ func getPixelMapuivRequest(c *xgb.Conn, ContextTag ContextTag, Map uint32) []byt
 	return buf
 }
 
-// Request GetPixelMapusv
-// size: 12
+// GetPixelMapusvCookie is a cookie used only for GetPixelMapusv requests.
 type GetPixelMapusvCookie struct {
 	*xgb.Cookie
 }
 
+// GetPixelMapusv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetPixelMapusvCookie.Reply()
 func GetPixelMapusv(c *xgb.Conn, ContextTag ContextTag, Map uint32) GetPixelMapusvCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getPixelMapusvRequest(c, ContextTag, Map), cookie)
 	return GetPixelMapusvCookie{cookie}
 }
 
+// GetPixelMapusvUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetPixelMapusvUnchecked(c *xgb.Conn, ContextTag ContextTag, Map uint32) GetPixelMapusvCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getPixelMapusvRequest(c, ContextTag, Map), cookie)
 	return GetPixelMapusvCookie{cookie}
 }
 
-// Request reply for GetPixelMapusv
-// size: (34 + xgb.Pad((int(N) * 2)))
+// GetPixelMapusvReply represents the data returned from a GetPixelMapusv request.
 type GetPixelMapusvReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -5412,7 +5657,7 @@ type GetPixelMapusvReply struct {
 	Data []uint16 // size: xgb.Pad((int(N) * 2))
 }
 
-// Waits and reads reply data from request GetPixelMapusv
+// Reply blocks and returns the reply data for a GetPixelMapusv request.
 func (cook GetPixelMapusvCookie) Reply() (*GetPixelMapusvReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -5424,7 +5669,7 @@ func (cook GetPixelMapusvCookie) Reply() (*GetPixelMapusvReply, error) {
 	return getPixelMapusvReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetPixelMapusv
+// getPixelMapusvReply reads a byte slice into a GetPixelMapusvReply value.
 func getPixelMapusvReply(buf []byte) *GetPixelMapusvReply {
 	v := new(GetPixelMapusvReply)
 	b := 1 // skip reply determinant
@@ -5458,6 +5703,7 @@ func getPixelMapusvReply(buf []byte) *GetPixelMapusvReply {
 }
 
 // Write request to wire for GetPixelMapusv
+// getPixelMapusvRequest writes a GetPixelMapusv request to a byte slice.
 func getPixelMapusvRequest(c *xgb.Conn, ContextTag ContextTag, Map uint32) []byte {
 	size := 12
 	b := 0
@@ -5481,35 +5727,37 @@ func getPixelMapusvRequest(c *xgb.Conn, ContextTag ContextTag, Map uint32) []byt
 	return buf
 }
 
-// Request GetPolygonStipple
-// size: 12
+// GetPolygonStippleCookie is a cookie used only for GetPolygonStipple requests.
 type GetPolygonStippleCookie struct {
 	*xgb.Cookie
 }
 
+// GetPolygonStipple sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetPolygonStippleCookie.Reply()
 func GetPolygonStipple(c *xgb.Conn, ContextTag ContextTag, LsbFirst bool) GetPolygonStippleCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getPolygonStippleRequest(c, ContextTag, LsbFirst), cookie)
 	return GetPolygonStippleCookie{cookie}
 }
 
+// GetPolygonStippleUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetPolygonStippleUnchecked(c *xgb.Conn, ContextTag ContextTag, LsbFirst bool) GetPolygonStippleCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getPolygonStippleRequest(c, ContextTag, LsbFirst), cookie)
 	return GetPolygonStippleCookie{cookie}
 }
 
-// Request reply for GetPolygonStipple
-// size: (32 + xgb.Pad(((int(Length) * 4) * 1)))
+// GetPolygonStippleReply represents the data returned from a GetPolygonStipple request.
 type GetPolygonStippleReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 24 bytes
 	Data []byte // size: xgb.Pad(((int(Length) * 4) * 1))
 }
 
-// Waits and reads reply data from request GetPolygonStipple
+// Reply blocks and returns the reply data for a GetPolygonStipple request.
 func (cook GetPolygonStippleCookie) Reply() (*GetPolygonStippleReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -5521,7 +5769,7 @@ func (cook GetPolygonStippleCookie) Reply() (*GetPolygonStippleReply, error) {
 	return getPolygonStippleReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetPolygonStipple
+// getPolygonStippleReply reads a byte slice into a GetPolygonStippleReply value.
 func getPolygonStippleReply(buf []byte) *GetPolygonStippleReply {
 	v := new(GetPolygonStippleReply)
 	b := 1 // skip reply determinant
@@ -5544,6 +5792,7 @@ func getPolygonStippleReply(buf []byte) *GetPolygonStippleReply {
 }
 
 // Write request to wire for GetPolygonStipple
+// getPolygonStippleRequest writes a GetPolygonStipple request to a byte slice.
 func getPolygonStippleRequest(c *xgb.Conn, ContextTag ContextTag, LsbFirst bool) []byte {
 	size := 12
 	b := 0
@@ -5571,29 +5820,31 @@ func getPolygonStippleRequest(c *xgb.Conn, ContextTag ContextTag, LsbFirst bool)
 	return buf
 }
 
-// Request GetString
-// size: 12
+// GetStringCookie is a cookie used only for GetString requests.
 type GetStringCookie struct {
 	*xgb.Cookie
 }
 
+// GetString sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetStringCookie.Reply()
 func GetString(c *xgb.Conn, ContextTag ContextTag, Name uint32) GetStringCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getStringRequest(c, ContextTag, Name), cookie)
 	return GetStringCookie{cookie}
 }
 
+// GetStringUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetStringUnchecked(c *xgb.Conn, ContextTag ContextTag, Name uint32) GetStringCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getStringRequest(c, ContextTag, Name), cookie)
 	return GetStringCookie{cookie}
 }
 
-// Request reply for GetString
-// size: (32 + xgb.Pad((int(N) * 1)))
+// GetStringReply represents the data returned from a GetString request.
 type GetStringReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N uint32
@@ -5601,7 +5852,7 @@ type GetStringReply struct {
 	String string // size: xgb.Pad((int(N) * 1))
 }
 
-// Waits and reads reply data from request GetString
+// Reply blocks and returns the reply data for a GetString request.
 func (cook GetStringCookie) Reply() (*GetStringReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -5613,7 +5864,7 @@ func (cook GetStringCookie) Reply() (*GetStringReply, error) {
 	return getStringReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetString
+// getStringReply reads a byte slice into a GetStringReply value.
 func getStringReply(buf []byte) *GetStringReply {
 	v := new(GetStringReply)
 	b := 1 // skip reply determinant
@@ -5644,6 +5895,7 @@ func getStringReply(buf []byte) *GetStringReply {
 }
 
 // Write request to wire for GetString
+// getStringRequest writes a GetString request to a byte slice.
 func getStringRequest(c *xgb.Conn, ContextTag ContextTag, Name uint32) []byte {
 	size := 12
 	b := 0
@@ -5667,29 +5919,31 @@ func getStringRequest(c *xgb.Conn, ContextTag ContextTag, Name uint32) []byte {
 	return buf
 }
 
-// Request GetTexEnvfv
-// size: 16
+// GetTexEnvfvCookie is a cookie used only for GetTexEnvfv requests.
 type GetTexEnvfvCookie struct {
 	*xgb.Cookie
 }
 
+// GetTexEnvfv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetTexEnvfvCookie.Reply()
 func GetTexEnvfv(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetTexEnvfvCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getTexEnvfvRequest(c, ContextTag, Target, Pname), cookie)
 	return GetTexEnvfvCookie{cookie}
 }
 
+// GetTexEnvfvUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetTexEnvfvUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetTexEnvfvCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getTexEnvfvRequest(c, ContextTag, Target, Pname), cookie)
 	return GetTexEnvfvCookie{cookie}
 }
 
-// Request reply for GetTexEnvfv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetTexEnvfvReply represents the data returned from a GetTexEnvfv request.
 type GetTexEnvfvReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -5698,7 +5952,7 @@ type GetTexEnvfvReply struct {
 	Data []Float32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetTexEnvfv
+// Reply blocks and returns the reply data for a GetTexEnvfv request.
 func (cook GetTexEnvfvCookie) Reply() (*GetTexEnvfvReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -5710,7 +5964,7 @@ func (cook GetTexEnvfvCookie) Reply() (*GetTexEnvfvReply, error) {
 	return getTexEnvfvReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetTexEnvfv
+// getTexEnvfvReply reads a byte slice into a GetTexEnvfvReply value.
 func getTexEnvfvReply(buf []byte) *GetTexEnvfvReply {
 	v := new(GetTexEnvfvReply)
 	b := 1 // skip reply determinant
@@ -5744,6 +5998,7 @@ func getTexEnvfvReply(buf []byte) *GetTexEnvfvReply {
 }
 
 // Write request to wire for GetTexEnvfv
+// getTexEnvfvRequest writes a GetTexEnvfv request to a byte slice.
 func getTexEnvfvRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) []byte {
 	size := 16
 	b := 0
@@ -5770,29 +6025,31 @@ func getTexEnvfvRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname
 	return buf
 }
 
-// Request GetTexEnviv
-// size: 16
+// GetTexEnvivCookie is a cookie used only for GetTexEnviv requests.
 type GetTexEnvivCookie struct {
 	*xgb.Cookie
 }
 
+// GetTexEnviv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetTexEnvivCookie.Reply()
 func GetTexEnviv(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetTexEnvivCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getTexEnvivRequest(c, ContextTag, Target, Pname), cookie)
 	return GetTexEnvivCookie{cookie}
 }
 
+// GetTexEnvivUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetTexEnvivUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetTexEnvivCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getTexEnvivRequest(c, ContextTag, Target, Pname), cookie)
 	return GetTexEnvivCookie{cookie}
 }
 
-// Request reply for GetTexEnviv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetTexEnvivReply represents the data returned from a GetTexEnviv request.
 type GetTexEnvivReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -5801,7 +6058,7 @@ type GetTexEnvivReply struct {
 	Data []int32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetTexEnviv
+// Reply blocks and returns the reply data for a GetTexEnviv request.
 func (cook GetTexEnvivCookie) Reply() (*GetTexEnvivReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -5813,7 +6070,7 @@ func (cook GetTexEnvivCookie) Reply() (*GetTexEnvivReply, error) {
 	return getTexEnvivReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetTexEnviv
+// getTexEnvivReply reads a byte slice into a GetTexEnvivReply value.
 func getTexEnvivReply(buf []byte) *GetTexEnvivReply {
 	v := new(GetTexEnvivReply)
 	b := 1 // skip reply determinant
@@ -5847,6 +6104,7 @@ func getTexEnvivReply(buf []byte) *GetTexEnvivReply {
 }
 
 // Write request to wire for GetTexEnviv
+// getTexEnvivRequest writes a GetTexEnviv request to a byte slice.
 func getTexEnvivRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) []byte {
 	size := 16
 	b := 0
@@ -5873,29 +6131,31 @@ func getTexEnvivRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname
 	return buf
 }
 
-// Request GetTexGendv
-// size: 16
+// GetTexGendvCookie is a cookie used only for GetTexGendv requests.
 type GetTexGendvCookie struct {
 	*xgb.Cookie
 }
 
+// GetTexGendv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetTexGendvCookie.Reply()
 func GetTexGendv(c *xgb.Conn, ContextTag ContextTag, Coord uint32, Pname uint32) GetTexGendvCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getTexGendvRequest(c, ContextTag, Coord, Pname), cookie)
 	return GetTexGendvCookie{cookie}
 }
 
+// GetTexGendvUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetTexGendvUnchecked(c *xgb.Conn, ContextTag ContextTag, Coord uint32, Pname uint32) GetTexGendvCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getTexGendvRequest(c, ContextTag, Coord, Pname), cookie)
 	return GetTexGendvCookie{cookie}
 }
 
-// Request reply for GetTexGendv
-// size: (32 + xgb.Pad((int(N) * 8)))
+// GetTexGendvReply represents the data returned from a GetTexGendv request.
 type GetTexGendvReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -5904,7 +6164,7 @@ type GetTexGendvReply struct {
 	Data []Float64 // size: xgb.Pad((int(N) * 8))
 }
 
-// Waits and reads reply data from request GetTexGendv
+// Reply blocks and returns the reply data for a GetTexGendv request.
 func (cook GetTexGendvCookie) Reply() (*GetTexGendvReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -5916,7 +6176,7 @@ func (cook GetTexGendvCookie) Reply() (*GetTexGendvReply, error) {
 	return getTexGendvReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetTexGendv
+// getTexGendvReply reads a byte slice into a GetTexGendvReply value.
 func getTexGendvReply(buf []byte) *GetTexGendvReply {
 	v := new(GetTexGendvReply)
 	b := 1 // skip reply determinant
@@ -5950,6 +6210,7 @@ func getTexGendvReply(buf []byte) *GetTexGendvReply {
 }
 
 // Write request to wire for GetTexGendv
+// getTexGendvRequest writes a GetTexGendv request to a byte slice.
 func getTexGendvRequest(c *xgb.Conn, ContextTag ContextTag, Coord uint32, Pname uint32) []byte {
 	size := 16
 	b := 0
@@ -5976,29 +6237,31 @@ func getTexGendvRequest(c *xgb.Conn, ContextTag ContextTag, Coord uint32, Pname
 	return buf
 }
 
-// Request GetTexGenfv
-// size: 16
+// GetTexGenfvCookie is a cookie used only for GetTexGenfv requests.
 type GetTexGenfvCookie struct {
 	*xgb.Cookie
 }
 
+// GetTexGenfv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetTexGenfvCookie.Reply()
 func GetTexGenfv(c *xgb.Conn, ContextTag ContextTag, Coord uint32, Pname uint32) GetTexGenfvCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getTexGenfvRequest(c, ContextTag, Coord, Pname), cookie)
 	return GetTexGenfvCookie{cookie}
 }
 
+// GetTexGenfvUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetTexGenfvUnchecked(c *xgb.Conn, ContextTag ContextTag, Coord uint32, Pname uint32) GetTexGenfvCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getTexGenfvRequest(c, ContextTag, Coord, Pname), cookie)
 	return GetTexGenfvCookie{cookie}
 }
 
-// Request reply for GetTexGenfv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetTexGenfvReply represents the data returned from a GetTexGenfv request.
 type GetTexGenfvReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -6007,7 +6270,7 @@ type GetTexGenfvReply struct {
 	Data []Float32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetTexGenfv
+// Reply blocks and returns the reply data for a GetTexGenfv request.
 func (cook GetTexGenfvCookie) Reply() (*GetTexGenfvReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -6019,7 +6282,7 @@ func (cook GetTexGenfvCookie) Reply() (*GetTexGenfvReply, error) {
 	return getTexGenfvReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetTexGenfv
+// getTexGenfvReply reads a byte slice into a GetTexGenfvReply value.
 func getTexGenfvReply(buf []byte) *GetTexGenfvReply {
 	v := new(GetTexGenfvReply)
 	b := 1 // skip reply determinant
@@ -6053,6 +6316,7 @@ func getTexGenfvReply(buf []byte) *GetTexGenfvReply {
 }
 
 // Write request to wire for GetTexGenfv
+// getTexGenfvRequest writes a GetTexGenfv request to a byte slice.
 func getTexGenfvRequest(c *xgb.Conn, ContextTag ContextTag, Coord uint32, Pname uint32) []byte {
 	size := 16
 	b := 0
@@ -6079,29 +6343,31 @@ func getTexGenfvRequest(c *xgb.Conn, ContextTag ContextTag, Coord uint32, Pname
 	return buf
 }
 
-// Request GetTexGeniv
-// size: 16
+// GetTexGenivCookie is a cookie used only for GetTexGeniv requests.
 type GetTexGenivCookie struct {
 	*xgb.Cookie
 }
 
+// GetTexGeniv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetTexGenivCookie.Reply()
 func GetTexGeniv(c *xgb.Conn, ContextTag ContextTag, Coord uint32, Pname uint32) GetTexGenivCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getTexGenivRequest(c, ContextTag, Coord, Pname), cookie)
 	return GetTexGenivCookie{cookie}
 }
 
+// GetTexGenivUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetTexGenivUnchecked(c *xgb.Conn, ContextTag ContextTag, Coord uint32, Pname uint32) GetTexGenivCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getTexGenivRequest(c, ContextTag, Coord, Pname), cookie)
 	return GetTexGenivCookie{cookie}
 }
 
-// Request reply for GetTexGeniv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetTexGenivReply represents the data returned from a GetTexGeniv request.
 type GetTexGenivReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -6110,7 +6376,7 @@ type GetTexGenivReply struct {
 	Data []int32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetTexGeniv
+// Reply blocks and returns the reply data for a GetTexGeniv request.
 func (cook GetTexGenivCookie) Reply() (*GetTexGenivReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -6122,7 +6388,7 @@ func (cook GetTexGenivCookie) Reply() (*GetTexGenivReply, error) {
 	return getTexGenivReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetTexGeniv
+// getTexGenivReply reads a byte slice into a GetTexGenivReply value.
 func getTexGenivReply(buf []byte) *GetTexGenivReply {
 	v := new(GetTexGenivReply)
 	b := 1 // skip reply determinant
@@ -6156,6 +6422,7 @@ func getTexGenivReply(buf []byte) *GetTexGenivReply {
 }
 
 // Write request to wire for GetTexGeniv
+// getTexGenivRequest writes a GetTexGeniv request to a byte slice.
 func getTexGenivRequest(c *xgb.Conn, ContextTag ContextTag, Coord uint32, Pname uint32) []byte {
 	size := 16
 	b := 0
@@ -6182,29 +6449,31 @@ func getTexGenivRequest(c *xgb.Conn, ContextTag ContextTag, Coord uint32, Pname
 	return buf
 }
 
-// Request GetTexImage
-// size: 28
+// GetTexImageCookie is a cookie used only for GetTexImage requests.
 type GetTexImageCookie struct {
 	*xgb.Cookie
 }
 
+// GetTexImage sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetTexImageCookie.Reply()
 func GetTexImage(c *xgb.Conn, ContextTag ContextTag, Target uint32, Level int32, Format uint32, Type uint32, SwapBytes bool) GetTexImageCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getTexImageRequest(c, ContextTag, Target, Level, Format, Type, SwapBytes), cookie)
 	return GetTexImageCookie{cookie}
 }
 
+// GetTexImageUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetTexImageUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Level int32, Format uint32, Type uint32, SwapBytes bool) GetTexImageCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getTexImageRequest(c, ContextTag, Target, Level, Format, Type, SwapBytes), cookie)
 	return GetTexImageCookie{cookie}
 }
 
-// Request reply for GetTexImage
-// size: (32 + xgb.Pad(((int(Length) * 4) * 1)))
+// GetTexImageReply represents the data returned from a GetTexImage request.
 type GetTexImageReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 8 bytes
 	Width  int32
@@ -6214,7 +6483,7 @@ type GetTexImageReply struct {
 	Data []byte // size: xgb.Pad(((int(Length) * 4) * 1))
 }
 
-// Waits and reads reply data from request GetTexImage
+// Reply blocks and returns the reply data for a GetTexImage request.
 func (cook GetTexImageCookie) Reply() (*GetTexImageReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -6226,7 +6495,7 @@ func (cook GetTexImageCookie) Reply() (*GetTexImageReply, error) {
 	return getTexImageReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetTexImage
+// getTexImageReply reads a byte slice into a GetTexImageReply value.
 func getTexImageReply(buf []byte) *GetTexImageReply {
 	v := new(GetTexImageReply)
 	b := 1 // skip reply determinant
@@ -6260,6 +6529,7 @@ func getTexImageReply(buf []byte) *GetTexImageReply {
 }
 
 // Write request to wire for GetTexImage
+// getTexImageRequest writes a GetTexImage request to a byte slice.
 func getTexImageRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Level int32, Format uint32, Type uint32, SwapBytes bool) []byte {
 	size := 28
 	b := 0
@@ -6299,29 +6569,31 @@ func getTexImageRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Level
 	return buf
 }
 
-// Request GetTexParameterfv
-// size: 16
+// GetTexParameterfvCookie is a cookie used only for GetTexParameterfv requests.
 type GetTexParameterfvCookie struct {
 	*xgb.Cookie
 }
 
+// GetTexParameterfv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetTexParameterfvCookie.Reply()
 func GetTexParameterfv(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetTexParameterfvCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getTexParameterfvRequest(c, ContextTag, Target, Pname), cookie)
 	return GetTexParameterfvCookie{cookie}
 }
 
+// GetTexParameterfvUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetTexParameterfvUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetTexParameterfvCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getTexParameterfvRequest(c, ContextTag, Target, Pname), cookie)
 	return GetTexParameterfvCookie{cookie}
 }
 
-// Request reply for GetTexParameterfv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetTexParameterfvReply represents the data returned from a GetTexParameterfv request.
 type GetTexParameterfvReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -6330,7 +6602,7 @@ type GetTexParameterfvReply struct {
 	Data []Float32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetTexParameterfv
+// Reply blocks and returns the reply data for a GetTexParameterfv request.
 func (cook GetTexParameterfvCookie) Reply() (*GetTexParameterfvReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -6342,7 +6614,7 @@ func (cook GetTexParameterfvCookie) Reply() (*GetTexParameterfvReply, error) {
 	return getTexParameterfvReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetTexParameterfv
+// getTexParameterfvReply reads a byte slice into a GetTexParameterfvReply value.
 func getTexParameterfvReply(buf []byte) *GetTexParameterfvReply {
 	v := new(GetTexParameterfvReply)
 	b := 1 // skip reply determinant
@@ -6376,6 +6648,7 @@ func getTexParameterfvReply(buf []byte) *GetTexParameterfvReply {
 }
 
 // Write request to wire for GetTexParameterfv
+// getTexParameterfvRequest writes a GetTexParameterfv request to a byte slice.
 func getTexParameterfvRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) []byte {
 	size := 16
 	b := 0
@@ -6402,29 +6675,31 @@ func getTexParameterfvRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32,
 	return buf
 }
 
-// Request GetTexParameteriv
-// size: 16
+// GetTexParameterivCookie is a cookie used only for GetTexParameteriv requests.
 type GetTexParameterivCookie struct {
 	*xgb.Cookie
 }
 
+// GetTexParameteriv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetTexParameterivCookie.Reply()
 func GetTexParameteriv(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetTexParameterivCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getTexParameterivRequest(c, ContextTag, Target, Pname), cookie)
 	return GetTexParameterivCookie{cookie}
 }
 
+// GetTexParameterivUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetTexParameterivUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetTexParameterivCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getTexParameterivRequest(c, ContextTag, Target, Pname), cookie)
 	return GetTexParameterivCookie{cookie}
 }
 
-// Request reply for GetTexParameteriv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetTexParameterivReply represents the data returned from a GetTexParameteriv request.
 type GetTexParameterivReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -6433,7 +6708,7 @@ type GetTexParameterivReply struct {
 	Data []int32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetTexParameteriv
+// Reply blocks and returns the reply data for a GetTexParameteriv request.
 func (cook GetTexParameterivCookie) Reply() (*GetTexParameterivReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -6445,7 +6720,7 @@ func (cook GetTexParameterivCookie) Reply() (*GetTexParameterivReply, error) {
 	return getTexParameterivReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetTexParameteriv
+// getTexParameterivReply reads a byte slice into a GetTexParameterivReply value.
 func getTexParameterivReply(buf []byte) *GetTexParameterivReply {
 	v := new(GetTexParameterivReply)
 	b := 1 // skip reply determinant
@@ -6479,6 +6754,7 @@ func getTexParameterivReply(buf []byte) *GetTexParameterivReply {
 }
 
 // Write request to wire for GetTexParameteriv
+// getTexParameterivRequest writes a GetTexParameteriv request to a byte slice.
 func getTexParameterivRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) []byte {
 	size := 16
 	b := 0
@@ -6505,29 +6781,31 @@ func getTexParameterivRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32,
 	return buf
 }
 
-// Request GetTexLevelParameterfv
-// size: 20
+// GetTexLevelParameterfvCookie is a cookie used only for GetTexLevelParameterfv requests.
 type GetTexLevelParameterfvCookie struct {
 	*xgb.Cookie
 }
 
+// GetTexLevelParameterfv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetTexLevelParameterfvCookie.Reply()
 func GetTexLevelParameterfv(c *xgb.Conn, ContextTag ContextTag, Target uint32, Level int32, Pname uint32) GetTexLevelParameterfvCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getTexLevelParameterfvRequest(c, ContextTag, Target, Level, Pname), cookie)
 	return GetTexLevelParameterfvCookie{cookie}
 }
 
+// GetTexLevelParameterfvUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetTexLevelParameterfvUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Level int32, Pname uint32) GetTexLevelParameterfvCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getTexLevelParameterfvRequest(c, ContextTag, Target, Level, Pname), cookie)
 	return GetTexLevelParameterfvCookie{cookie}
 }
 
-// Request reply for GetTexLevelParameterfv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetTexLevelParameterfvReply represents the data returned from a GetTexLevelParameterfv request.
 type GetTexLevelParameterfvReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -6536,7 +6814,7 @@ type GetTexLevelParameterfvReply struct {
 	Data []Float32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetTexLevelParameterfv
+// Reply blocks and returns the reply data for a GetTexLevelParameterfv request.
 func (cook GetTexLevelParameterfvCookie) Reply() (*GetTexLevelParameterfvReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -6548,7 +6826,7 @@ func (cook GetTexLevelParameterfvCookie) Reply() (*GetTexLevelParameterfvReply,
 	return getTexLevelParameterfvReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetTexLevelParameterfv
+// getTexLevelParameterfvReply reads a byte slice into a GetTexLevelParameterfvReply value.
 func getTexLevelParameterfvReply(buf []byte) *GetTexLevelParameterfvReply {
 	v := new(GetTexLevelParameterfvReply)
 	b := 1 // skip reply determinant
@@ -6582,6 +6860,7 @@ func getTexLevelParameterfvReply(buf []byte) *GetTexLevelParameterfvReply {
 }
 
 // Write request to wire for GetTexLevelParameterfv
+// getTexLevelParameterfvRequest writes a GetTexLevelParameterfv request to a byte slice.
 func getTexLevelParameterfvRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Level int32, Pname uint32) []byte {
 	size := 20
 	b := 0
@@ -6611,29 +6890,31 @@ func getTexLevelParameterfvRequest(c *xgb.Conn, ContextTag ContextTag, Target ui
 	return buf
 }
 
-// Request GetTexLevelParameteriv
-// size: 20
+// GetTexLevelParameterivCookie is a cookie used only for GetTexLevelParameteriv requests.
 type GetTexLevelParameterivCookie struct {
 	*xgb.Cookie
 }
 
+// GetTexLevelParameteriv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetTexLevelParameterivCookie.Reply()
 func GetTexLevelParameteriv(c *xgb.Conn, ContextTag ContextTag, Target uint32, Level int32, Pname uint32) GetTexLevelParameterivCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getTexLevelParameterivRequest(c, ContextTag, Target, Level, Pname), cookie)
 	return GetTexLevelParameterivCookie{cookie}
 }
 
+// GetTexLevelParameterivUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetTexLevelParameterivUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Level int32, Pname uint32) GetTexLevelParameterivCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getTexLevelParameterivRequest(c, ContextTag, Target, Level, Pname), cookie)
 	return GetTexLevelParameterivCookie{cookie}
 }
 
-// Request reply for GetTexLevelParameteriv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetTexLevelParameterivReply represents the data returned from a GetTexLevelParameteriv request.
 type GetTexLevelParameterivReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -6642,7 +6923,7 @@ type GetTexLevelParameterivReply struct {
 	Data []int32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetTexLevelParameteriv
+// Reply blocks and returns the reply data for a GetTexLevelParameteriv request.
 func (cook GetTexLevelParameterivCookie) Reply() (*GetTexLevelParameterivReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -6654,7 +6935,7 @@ func (cook GetTexLevelParameterivCookie) Reply() (*GetTexLevelParameterivReply,
 	return getTexLevelParameterivReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetTexLevelParameteriv
+// getTexLevelParameterivReply reads a byte slice into a GetTexLevelParameterivReply value.
 func getTexLevelParameterivReply(buf []byte) *GetTexLevelParameterivReply {
 	v := new(GetTexLevelParameterivReply)
 	b := 1 // skip reply determinant
@@ -6688,6 +6969,7 @@ func getTexLevelParameterivReply(buf []byte) *GetTexLevelParameterivReply {
 }
 
 // Write request to wire for GetTexLevelParameteriv
+// getTexLevelParameterivRequest writes a GetTexLevelParameteriv request to a byte slice.
 func getTexLevelParameterivRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Level int32, Pname uint32) []byte {
 	size := 20
 	b := 0
@@ -6717,34 +6999,36 @@ func getTexLevelParameterivRequest(c *xgb.Conn, ContextTag ContextTag, Target ui
 	return buf
 }
 
-// Request IsList
-// size: 12
+// IsListCookie is a cookie used only for IsList requests.
 type IsListCookie struct {
 	*xgb.Cookie
 }
 
+// IsList sends a checked request.
+// If an error occurs, it will be returned with the reply by calling IsListCookie.Reply()
 func IsList(c *xgb.Conn, ContextTag ContextTag, List uint32) IsListCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(isListRequest(c, ContextTag, List), cookie)
 	return IsListCookie{cookie}
 }
 
+// IsListUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func IsListUnchecked(c *xgb.Conn, ContextTag ContextTag, List uint32) IsListCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(isListRequest(c, ContextTag, List), cookie)
 	return IsListCookie{cookie}
 }
 
-// Request reply for IsList
-// size: 12
+// IsListReply represents the data returned from a IsList request.
 type IsListReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	RetVal Bool32
 }
 
-// Waits and reads reply data from request IsList
+// Reply blocks and returns the reply data for a IsList request.
 func (cook IsListCookie) Reply() (*IsListReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -6756,7 +7040,7 @@ func (cook IsListCookie) Reply() (*IsListReply, error) {
 	return isListReply(buf), nil
 }
 
-// Read reply into structure from buffer for IsList
+// isListReply reads a byte slice into a IsListReply value.
 func isListReply(buf []byte) *IsListReply {
 	v := new(IsListReply)
 	b := 1 // skip reply determinant
@@ -6776,6 +7060,7 @@ func isListReply(buf []byte) *IsListReply {
 }
 
 // Write request to wire for IsList
+// isListRequest writes a IsList request to a byte slice.
 func isListRequest(c *xgb.Conn, ContextTag ContextTag, List uint32) []byte {
 	size := 12
 	b := 0
@@ -6799,30 +7084,35 @@ func isListRequest(c *xgb.Conn, ContextTag ContextTag, List uint32) []byte {
 	return buf
 }
 
-// Request Flush
-// size: 8
+// FlushCookie is a cookie used only for Flush requests.
 type FlushCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for Flush
+// Flush sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func Flush(c *xgb.Conn, ContextTag ContextTag) FlushCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(flushRequest(c, ContextTag), cookie)
 	return FlushCookie{cookie}
 }
 
+// FlushChecked sends a checked request.
+// If an error occurs, it can be retrieved using FlushCookie.Check()
 func FlushChecked(c *xgb.Conn, ContextTag ContextTag) FlushCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(flushRequest(c, ContextTag), cookie)
 	return FlushCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook FlushCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for Flush
+// flushRequest writes a Flush request to a byte slice.
 func flushRequest(c *xgb.Conn, ContextTag ContextTag) []byte {
 	size := 8
 	b := 0
@@ -6843,36 +7133,38 @@ func flushRequest(c *xgb.Conn, ContextTag ContextTag) []byte {
 	return buf
 }
 
-// Request AreTexturesResident
-// size: xgb.Pad((12 + xgb.Pad((int(N) * 4))))
+// AreTexturesResidentCookie is a cookie used only for AreTexturesResident requests.
 type AreTexturesResidentCookie struct {
 	*xgb.Cookie
 }
 
+// AreTexturesResident sends a checked request.
+// If an error occurs, it will be returned with the reply by calling AreTexturesResidentCookie.Reply()
 func AreTexturesResident(c *xgb.Conn, ContextTag ContextTag, N int32, Textures []uint32) AreTexturesResidentCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(areTexturesResidentRequest(c, ContextTag, N, Textures), cookie)
 	return AreTexturesResidentCookie{cookie}
 }
 
+// AreTexturesResidentUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func AreTexturesResidentUnchecked(c *xgb.Conn, ContextTag ContextTag, N int32, Textures []uint32) AreTexturesResidentCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(areTexturesResidentRequest(c, ContextTag, N, Textures), cookie)
 	return AreTexturesResidentCookie{cookie}
 }
 
-// Request reply for AreTexturesResident
-// size: (32 + xgb.Pad(((int(Length) * 4) * 1)))
+// AreTexturesResidentReply represents the data returned from a AreTexturesResident request.
 type AreTexturesResidentReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	RetVal Bool32
 	// padding: 20 bytes
 	Data []bool // size: xgb.Pad(((int(Length) * 4) * 1))
 }
 
-// Waits and reads reply data from request AreTexturesResident
+// Reply blocks and returns the reply data for a AreTexturesResident request.
 func (cook AreTexturesResidentCookie) Reply() (*AreTexturesResidentReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -6884,7 +7176,7 @@ func (cook AreTexturesResidentCookie) Reply() (*AreTexturesResidentReply, error)
 	return areTexturesResidentReply(buf), nil
 }
 
-// Read reply into structure from buffer for AreTexturesResident
+// areTexturesResidentReply reads a byte slice into a AreTexturesResidentReply value.
 func areTexturesResidentReply(buf []byte) *AreTexturesResidentReply {
 	v := new(AreTexturesResidentReply)
 	b := 1 // skip reply determinant
@@ -6917,6 +7209,7 @@ func areTexturesResidentReply(buf []byte) *AreTexturesResidentReply {
 }
 
 // Write request to wire for AreTexturesResident
+// areTexturesResidentRequest writes a AreTexturesResident request to a byte slice.
 func areTexturesResidentRequest(c *xgb.Conn, ContextTag ContextTag, N int32, Textures []uint32) []byte {
 	size := xgb.Pad((12 + xgb.Pad((int(N) * 4))))
 	b := 0
@@ -6946,30 +7239,35 @@ func areTexturesResidentRequest(c *xgb.Conn, ContextTag ContextTag, N int32, Tex
 	return buf
 }
 
-// Request DeleteTextures
-// size: xgb.Pad((12 + xgb.Pad((int(N) * 4))))
+// DeleteTexturesCookie is a cookie used only for DeleteTextures requests.
 type DeleteTexturesCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for DeleteTextures
+// DeleteTextures sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func DeleteTextures(c *xgb.Conn, ContextTag ContextTag, N int32, Textures []uint32) DeleteTexturesCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(deleteTexturesRequest(c, ContextTag, N, Textures), cookie)
 	return DeleteTexturesCookie{cookie}
 }
 
+// DeleteTexturesChecked sends a checked request.
+// If an error occurs, it can be retrieved using DeleteTexturesCookie.Check()
 func DeleteTexturesChecked(c *xgb.Conn, ContextTag ContextTag, N int32, Textures []uint32) DeleteTexturesCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(deleteTexturesRequest(c, ContextTag, N, Textures), cookie)
 	return DeleteTexturesCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook DeleteTexturesCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for DeleteTextures
+// deleteTexturesRequest writes a DeleteTextures request to a byte slice.
 func deleteTexturesRequest(c *xgb.Conn, ContextTag ContextTag, N int32, Textures []uint32) []byte {
 	size := xgb.Pad((12 + xgb.Pad((int(N) * 4))))
 	b := 0
@@ -6999,35 +7297,37 @@ func deleteTexturesRequest(c *xgb.Conn, ContextTag ContextTag, N int32, Textures
 	return buf
 }
 
-// Request GenTextures
-// size: 12
+// GenTexturesCookie is a cookie used only for GenTextures requests.
 type GenTexturesCookie struct {
 	*xgb.Cookie
 }
 
+// GenTextures sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GenTexturesCookie.Reply()
 func GenTextures(c *xgb.Conn, ContextTag ContextTag, N int32) GenTexturesCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(genTexturesRequest(c, ContextTag, N), cookie)
 	return GenTexturesCookie{cookie}
 }
 
+// GenTexturesUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GenTexturesUnchecked(c *xgb.Conn, ContextTag ContextTag, N int32) GenTexturesCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(genTexturesRequest(c, ContextTag, N), cookie)
 	return GenTexturesCookie{cookie}
 }
 
-// Request reply for GenTextures
-// size: (32 + xgb.Pad((int(Length) * 4)))
+// GenTexturesReply represents the data returned from a GenTextures request.
 type GenTexturesReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 24 bytes
 	Data []uint32 // size: xgb.Pad((int(Length) * 4))
 }
 
-// Waits and reads reply data from request GenTextures
+// Reply blocks and returns the reply data for a GenTextures request.
 func (cook GenTexturesCookie) Reply() (*GenTexturesReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -7039,7 +7339,7 @@ func (cook GenTexturesCookie) Reply() (*GenTexturesReply, error) {
 	return genTexturesReply(buf), nil
 }
 
-// Read reply into structure from buffer for GenTextures
+// genTexturesReply reads a byte slice into a GenTexturesReply value.
 func genTexturesReply(buf []byte) *GenTexturesReply {
 	v := new(GenTexturesReply)
 	b := 1 // skip reply determinant
@@ -7065,6 +7365,7 @@ func genTexturesReply(buf []byte) *GenTexturesReply {
 }
 
 // Write request to wire for GenTextures
+// genTexturesRequest writes a GenTextures request to a byte slice.
 func genTexturesRequest(c *xgb.Conn, ContextTag ContextTag, N int32) []byte {
 	size := 12
 	b := 0
@@ -7088,34 +7389,36 @@ func genTexturesRequest(c *xgb.Conn, ContextTag ContextTag, N int32) []byte {
 	return buf
 }
 
-// Request IsTexture
-// size: 12
+// IsTextureCookie is a cookie used only for IsTexture requests.
 type IsTextureCookie struct {
 	*xgb.Cookie
 }
 
+// IsTexture sends a checked request.
+// If an error occurs, it will be returned with the reply by calling IsTextureCookie.Reply()
 func IsTexture(c *xgb.Conn, ContextTag ContextTag, Texture uint32) IsTextureCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(isTextureRequest(c, ContextTag, Texture), cookie)
 	return IsTextureCookie{cookie}
 }
 
+// IsTextureUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func IsTextureUnchecked(c *xgb.Conn, ContextTag ContextTag, Texture uint32) IsTextureCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(isTextureRequest(c, ContextTag, Texture), cookie)
 	return IsTextureCookie{cookie}
 }
 
-// Request reply for IsTexture
-// size: 12
+// IsTextureReply represents the data returned from a IsTexture request.
 type IsTextureReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	RetVal Bool32
 }
 
-// Waits and reads reply data from request IsTexture
+// Reply blocks and returns the reply data for a IsTexture request.
 func (cook IsTextureCookie) Reply() (*IsTextureReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -7127,7 +7430,7 @@ func (cook IsTextureCookie) Reply() (*IsTextureReply, error) {
 	return isTextureReply(buf), nil
 }
 
-// Read reply into structure from buffer for IsTexture
+// isTextureReply reads a byte slice into a IsTextureReply value.
 func isTextureReply(buf []byte) *IsTextureReply {
 	v := new(IsTextureReply)
 	b := 1 // skip reply determinant
@@ -7147,6 +7450,7 @@ func isTextureReply(buf []byte) *IsTextureReply {
 }
 
 // Write request to wire for IsTexture
+// isTextureRequest writes a IsTexture request to a byte slice.
 func isTextureRequest(c *xgb.Conn, ContextTag ContextTag, Texture uint32) []byte {
 	size := 12
 	b := 0
@@ -7170,29 +7474,31 @@ func isTextureRequest(c *xgb.Conn, ContextTag ContextTag, Texture uint32) []byte
 	return buf
 }
 
-// Request GetColorTable
-// size: 24
+// GetColorTableCookie is a cookie used only for GetColorTable requests.
 type GetColorTableCookie struct {
 	*xgb.Cookie
 }
 
+// GetColorTable sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetColorTableCookie.Reply()
 func GetColorTable(c *xgb.Conn, ContextTag ContextTag, Target uint32, Format uint32, Type uint32, SwapBytes bool) GetColorTableCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getColorTableRequest(c, ContextTag, Target, Format, Type, SwapBytes), cookie)
 	return GetColorTableCookie{cookie}
 }
 
+// GetColorTableUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetColorTableUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Format uint32, Type uint32, SwapBytes bool) GetColorTableCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getColorTableRequest(c, ContextTag, Target, Format, Type, SwapBytes), cookie)
 	return GetColorTableCookie{cookie}
 }
 
-// Request reply for GetColorTable
-// size: (32 + xgb.Pad(((int(Length) * 4) * 1)))
+// GetColorTableReply represents the data returned from a GetColorTable request.
 type GetColorTableReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 8 bytes
 	Width int32
@@ -7200,7 +7506,7 @@ type GetColorTableReply struct {
 	Data []byte // size: xgb.Pad(((int(Length) * 4) * 1))
 }
 
-// Waits and reads reply data from request GetColorTable
+// Reply blocks and returns the reply data for a GetColorTable request.
 func (cook GetColorTableCookie) Reply() (*GetColorTableReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -7212,7 +7518,7 @@ func (cook GetColorTableCookie) Reply() (*GetColorTableReply, error) {
 	return getColorTableReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetColorTable
+// getColorTableReply reads a byte slice into a GetColorTableReply value.
 func getColorTableReply(buf []byte) *GetColorTableReply {
 	v := new(GetColorTableReply)
 	b := 1 // skip reply determinant
@@ -7240,6 +7546,7 @@ func getColorTableReply(buf []byte) *GetColorTableReply {
 }
 
 // Write request to wire for GetColorTable
+// getColorTableRequest writes a GetColorTable request to a byte slice.
 func getColorTableRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Format uint32, Type uint32, SwapBytes bool) []byte {
 	size := 24
 	b := 0
@@ -7276,29 +7583,31 @@ func getColorTableRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, For
 	return buf
 }
 
-// Request GetColorTableParameterfv
-// size: 16
+// GetColorTableParameterfvCookie is a cookie used only for GetColorTableParameterfv requests.
 type GetColorTableParameterfvCookie struct {
 	*xgb.Cookie
 }
 
+// GetColorTableParameterfv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetColorTableParameterfvCookie.Reply()
 func GetColorTableParameterfv(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetColorTableParameterfvCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getColorTableParameterfvRequest(c, ContextTag, Target, Pname), cookie)
 	return GetColorTableParameterfvCookie{cookie}
 }
 
+// GetColorTableParameterfvUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetColorTableParameterfvUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetColorTableParameterfvCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getColorTableParameterfvRequest(c, ContextTag, Target, Pname), cookie)
 	return GetColorTableParameterfvCookie{cookie}
 }
 
-// Request reply for GetColorTableParameterfv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetColorTableParameterfvReply represents the data returned from a GetColorTableParameterfv request.
 type GetColorTableParameterfvReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -7307,7 +7616,7 @@ type GetColorTableParameterfvReply struct {
 	Data []Float32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetColorTableParameterfv
+// Reply blocks and returns the reply data for a GetColorTableParameterfv request.
 func (cook GetColorTableParameterfvCookie) Reply() (*GetColorTableParameterfvReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -7319,7 +7628,7 @@ func (cook GetColorTableParameterfvCookie) Reply() (*GetColorTableParameterfvRep
 	return getColorTableParameterfvReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetColorTableParameterfv
+// getColorTableParameterfvReply reads a byte slice into a GetColorTableParameterfvReply value.
 func getColorTableParameterfvReply(buf []byte) *GetColorTableParameterfvReply {
 	v := new(GetColorTableParameterfvReply)
 	b := 1 // skip reply determinant
@@ -7353,6 +7662,7 @@ func getColorTableParameterfvReply(buf []byte) *GetColorTableParameterfvReply {
 }
 
 // Write request to wire for GetColorTableParameterfv
+// getColorTableParameterfvRequest writes a GetColorTableParameterfv request to a byte slice.
 func getColorTableParameterfvRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) []byte {
 	size := 16
 	b := 0
@@ -7379,29 +7689,31 @@ func getColorTableParameterfvRequest(c *xgb.Conn, ContextTag ContextTag, Target
 	return buf
 }
 
-// Request GetColorTableParameteriv
-// size: 16
+// GetColorTableParameterivCookie is a cookie used only for GetColorTableParameteriv requests.
 type GetColorTableParameterivCookie struct {
 	*xgb.Cookie
 }
 
+// GetColorTableParameteriv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetColorTableParameterivCookie.Reply()
 func GetColorTableParameteriv(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetColorTableParameterivCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getColorTableParameterivRequest(c, ContextTag, Target, Pname), cookie)
 	return GetColorTableParameterivCookie{cookie}
 }
 
+// GetColorTableParameterivUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetColorTableParameterivUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetColorTableParameterivCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getColorTableParameterivRequest(c, ContextTag, Target, Pname), cookie)
 	return GetColorTableParameterivCookie{cookie}
 }
 
-// Request reply for GetColorTableParameteriv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetColorTableParameterivReply represents the data returned from a GetColorTableParameteriv request.
 type GetColorTableParameterivReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -7410,7 +7722,7 @@ type GetColorTableParameterivReply struct {
 	Data []int32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetColorTableParameteriv
+// Reply blocks and returns the reply data for a GetColorTableParameteriv request.
 func (cook GetColorTableParameterivCookie) Reply() (*GetColorTableParameterivReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -7422,7 +7734,7 @@ func (cook GetColorTableParameterivCookie) Reply() (*GetColorTableParameterivRep
 	return getColorTableParameterivReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetColorTableParameteriv
+// getColorTableParameterivReply reads a byte slice into a GetColorTableParameterivReply value.
 func getColorTableParameterivReply(buf []byte) *GetColorTableParameterivReply {
 	v := new(GetColorTableParameterivReply)
 	b := 1 // skip reply determinant
@@ -7456,6 +7768,7 @@ func getColorTableParameterivReply(buf []byte) *GetColorTableParameterivReply {
 }
 
 // Write request to wire for GetColorTableParameteriv
+// getColorTableParameterivRequest writes a GetColorTableParameteriv request to a byte slice.
 func getColorTableParameterivRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) []byte {
 	size := 16
 	b := 0
@@ -7482,29 +7795,31 @@ func getColorTableParameterivRequest(c *xgb.Conn, ContextTag ContextTag, Target
 	return buf
 }
 
-// Request GetConvolutionFilter
-// size: 24
+// GetConvolutionFilterCookie is a cookie used only for GetConvolutionFilter requests.
 type GetConvolutionFilterCookie struct {
 	*xgb.Cookie
 }
 
+// GetConvolutionFilter sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetConvolutionFilterCookie.Reply()
 func GetConvolutionFilter(c *xgb.Conn, ContextTag ContextTag, Target uint32, Format uint32, Type uint32, SwapBytes bool) GetConvolutionFilterCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getConvolutionFilterRequest(c, ContextTag, Target, Format, Type, SwapBytes), cookie)
 	return GetConvolutionFilterCookie{cookie}
 }
 
+// GetConvolutionFilterUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetConvolutionFilterUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Format uint32, Type uint32, SwapBytes bool) GetConvolutionFilterCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getConvolutionFilterRequest(c, ContextTag, Target, Format, Type, SwapBytes), cookie)
 	return GetConvolutionFilterCookie{cookie}
 }
 
-// Request reply for GetConvolutionFilter
-// size: (32 + xgb.Pad(((int(Length) * 4) * 1)))
+// GetConvolutionFilterReply represents the data returned from a GetConvolutionFilter request.
 type GetConvolutionFilterReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 8 bytes
 	Width  int32
@@ -7513,7 +7828,7 @@ type GetConvolutionFilterReply struct {
 	Data []byte // size: xgb.Pad(((int(Length) * 4) * 1))
 }
 
-// Waits and reads reply data from request GetConvolutionFilter
+// Reply blocks and returns the reply data for a GetConvolutionFilter request.
 func (cook GetConvolutionFilterCookie) Reply() (*GetConvolutionFilterReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -7525,7 +7840,7 @@ func (cook GetConvolutionFilterCookie) Reply() (*GetConvolutionFilterReply, erro
 	return getConvolutionFilterReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetConvolutionFilter
+// getConvolutionFilterReply reads a byte slice into a GetConvolutionFilterReply value.
 func getConvolutionFilterReply(buf []byte) *GetConvolutionFilterReply {
 	v := new(GetConvolutionFilterReply)
 	b := 1 // skip reply determinant
@@ -7556,6 +7871,7 @@ func getConvolutionFilterReply(buf []byte) *GetConvolutionFilterReply {
 }
 
 // Write request to wire for GetConvolutionFilter
+// getConvolutionFilterRequest writes a GetConvolutionFilter request to a byte slice.
 func getConvolutionFilterRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Format uint32, Type uint32, SwapBytes bool) []byte {
 	size := 24
 	b := 0
@@ -7592,29 +7908,31 @@ func getConvolutionFilterRequest(c *xgb.Conn, ContextTag ContextTag, Target uint
 	return buf
 }
 
-// Request GetConvolutionParameterfv
-// size: 16
+// GetConvolutionParameterfvCookie is a cookie used only for GetConvolutionParameterfv requests.
 type GetConvolutionParameterfvCookie struct {
 	*xgb.Cookie
 }
 
+// GetConvolutionParameterfv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetConvolutionParameterfvCookie.Reply()
 func GetConvolutionParameterfv(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetConvolutionParameterfvCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getConvolutionParameterfvRequest(c, ContextTag, Target, Pname), cookie)
 	return GetConvolutionParameterfvCookie{cookie}
 }
 
+// GetConvolutionParameterfvUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetConvolutionParameterfvUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetConvolutionParameterfvCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getConvolutionParameterfvRequest(c, ContextTag, Target, Pname), cookie)
 	return GetConvolutionParameterfvCookie{cookie}
 }
 
-// Request reply for GetConvolutionParameterfv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetConvolutionParameterfvReply represents the data returned from a GetConvolutionParameterfv request.
 type GetConvolutionParameterfvReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -7623,7 +7941,7 @@ type GetConvolutionParameterfvReply struct {
 	Data []Float32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetConvolutionParameterfv
+// Reply blocks and returns the reply data for a GetConvolutionParameterfv request.
 func (cook GetConvolutionParameterfvCookie) Reply() (*GetConvolutionParameterfvReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -7635,7 +7953,7 @@ func (cook GetConvolutionParameterfvCookie) Reply() (*GetConvolutionParameterfvR
 	return getConvolutionParameterfvReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetConvolutionParameterfv
+// getConvolutionParameterfvReply reads a byte slice into a GetConvolutionParameterfvReply value.
 func getConvolutionParameterfvReply(buf []byte) *GetConvolutionParameterfvReply {
 	v := new(GetConvolutionParameterfvReply)
 	b := 1 // skip reply determinant
@@ -7669,6 +7987,7 @@ func getConvolutionParameterfvReply(buf []byte) *GetConvolutionParameterfvReply
 }
 
 // Write request to wire for GetConvolutionParameterfv
+// getConvolutionParameterfvRequest writes a GetConvolutionParameterfv request to a byte slice.
 func getConvolutionParameterfvRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) []byte {
 	size := 16
 	b := 0
@@ -7695,29 +8014,31 @@ func getConvolutionParameterfvRequest(c *xgb.Conn, ContextTag ContextTag, Target
 	return buf
 }
 
-// Request GetConvolutionParameteriv
-// size: 16
+// GetConvolutionParameterivCookie is a cookie used only for GetConvolutionParameteriv requests.
 type GetConvolutionParameterivCookie struct {
 	*xgb.Cookie
 }
 
+// GetConvolutionParameteriv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetConvolutionParameterivCookie.Reply()
 func GetConvolutionParameteriv(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetConvolutionParameterivCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getConvolutionParameterivRequest(c, ContextTag, Target, Pname), cookie)
 	return GetConvolutionParameterivCookie{cookie}
 }
 
+// GetConvolutionParameterivUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetConvolutionParameterivUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetConvolutionParameterivCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getConvolutionParameterivRequest(c, ContextTag, Target, Pname), cookie)
 	return GetConvolutionParameterivCookie{cookie}
 }
 
-// Request reply for GetConvolutionParameteriv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetConvolutionParameterivReply represents the data returned from a GetConvolutionParameteriv request.
 type GetConvolutionParameterivReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -7726,7 +8047,7 @@ type GetConvolutionParameterivReply struct {
 	Data []int32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetConvolutionParameteriv
+// Reply blocks and returns the reply data for a GetConvolutionParameteriv request.
 func (cook GetConvolutionParameterivCookie) Reply() (*GetConvolutionParameterivReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -7738,7 +8059,7 @@ func (cook GetConvolutionParameterivCookie) Reply() (*GetConvolutionParameterivR
 	return getConvolutionParameterivReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetConvolutionParameteriv
+// getConvolutionParameterivReply reads a byte slice into a GetConvolutionParameterivReply value.
 func getConvolutionParameterivReply(buf []byte) *GetConvolutionParameterivReply {
 	v := new(GetConvolutionParameterivReply)
 	b := 1 // skip reply determinant
@@ -7772,6 +8093,7 @@ func getConvolutionParameterivReply(buf []byte) *GetConvolutionParameterivReply
 }
 
 // Write request to wire for GetConvolutionParameteriv
+// getConvolutionParameterivRequest writes a GetConvolutionParameteriv request to a byte slice.
 func getConvolutionParameterivRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) []byte {
 	size := 16
 	b := 0
@@ -7798,29 +8120,31 @@ func getConvolutionParameterivRequest(c *xgb.Conn, ContextTag ContextTag, Target
 	return buf
 }
 
-// Request GetSeparableFilter
-// size: 24
+// GetSeparableFilterCookie is a cookie used only for GetSeparableFilter requests.
 type GetSeparableFilterCookie struct {
 	*xgb.Cookie
 }
 
+// GetSeparableFilter sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetSeparableFilterCookie.Reply()
 func GetSeparableFilter(c *xgb.Conn, ContextTag ContextTag, Target uint32, Format uint32, Type uint32, SwapBytes bool) GetSeparableFilterCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getSeparableFilterRequest(c, ContextTag, Target, Format, Type, SwapBytes), cookie)
 	return GetSeparableFilterCookie{cookie}
 }
 
+// GetSeparableFilterUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetSeparableFilterUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Format uint32, Type uint32, SwapBytes bool) GetSeparableFilterCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getSeparableFilterRequest(c, ContextTag, Target, Format, Type, SwapBytes), cookie)
 	return GetSeparableFilterCookie{cookie}
 }
 
-// Request reply for GetSeparableFilter
-// size: (32 + xgb.Pad(((int(Length) * 4) * 1)))
+// GetSeparableFilterReply represents the data returned from a GetSeparableFilter request.
 type GetSeparableFilterReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 8 bytes
 	RowW int32
@@ -7829,7 +8153,7 @@ type GetSeparableFilterReply struct {
 	RowsAndCols []byte // size: xgb.Pad(((int(Length) * 4) * 1))
 }
 
-// Waits and reads reply data from request GetSeparableFilter
+// Reply blocks and returns the reply data for a GetSeparableFilter request.
 func (cook GetSeparableFilterCookie) Reply() (*GetSeparableFilterReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -7841,7 +8165,7 @@ func (cook GetSeparableFilterCookie) Reply() (*GetSeparableFilterReply, error) {
 	return getSeparableFilterReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetSeparableFilter
+// getSeparableFilterReply reads a byte slice into a GetSeparableFilterReply value.
 func getSeparableFilterReply(buf []byte) *GetSeparableFilterReply {
 	v := new(GetSeparableFilterReply)
 	b := 1 // skip reply determinant
@@ -7872,6 +8196,7 @@ func getSeparableFilterReply(buf []byte) *GetSeparableFilterReply {
 }
 
 // Write request to wire for GetSeparableFilter
+// getSeparableFilterRequest writes a GetSeparableFilter request to a byte slice.
 func getSeparableFilterRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Format uint32, Type uint32, SwapBytes bool) []byte {
 	size := 24
 	b := 0
@@ -7908,29 +8233,31 @@ func getSeparableFilterRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32
 	return buf
 }
 
-// Request GetHistogram
-// size: 24
+// GetHistogramCookie is a cookie used only for GetHistogram requests.
 type GetHistogramCookie struct {
 	*xgb.Cookie
 }
 
+// GetHistogram sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetHistogramCookie.Reply()
 func GetHistogram(c *xgb.Conn, ContextTag ContextTag, Target uint32, Format uint32, Type uint32, SwapBytes bool, Reset bool) GetHistogramCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getHistogramRequest(c, ContextTag, Target, Format, Type, SwapBytes, Reset), cookie)
 	return GetHistogramCookie{cookie}
 }
 
+// GetHistogramUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetHistogramUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Format uint32, Type uint32, SwapBytes bool, Reset bool) GetHistogramCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getHistogramRequest(c, ContextTag, Target, Format, Type, SwapBytes, Reset), cookie)
 	return GetHistogramCookie{cookie}
 }
 
-// Request reply for GetHistogram
-// size: (32 + xgb.Pad(((int(Length) * 4) * 1)))
+// GetHistogramReply represents the data returned from a GetHistogram request.
 type GetHistogramReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 8 bytes
 	Width int32
@@ -7938,7 +8265,7 @@ type GetHistogramReply struct {
 	Data []byte // size: xgb.Pad(((int(Length) * 4) * 1))
 }
 
-// Waits and reads reply data from request GetHistogram
+// Reply blocks and returns the reply data for a GetHistogram request.
 func (cook GetHistogramCookie) Reply() (*GetHistogramReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -7950,7 +8277,7 @@ func (cook GetHistogramCookie) Reply() (*GetHistogramReply, error) {
 	return getHistogramReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetHistogram
+// getHistogramReply reads a byte slice into a GetHistogramReply value.
 func getHistogramReply(buf []byte) *GetHistogramReply {
 	v := new(GetHistogramReply)
 	b := 1 // skip reply determinant
@@ -7978,6 +8305,7 @@ func getHistogramReply(buf []byte) *GetHistogramReply {
 }
 
 // Write request to wire for GetHistogram
+// getHistogramRequest writes a GetHistogram request to a byte slice.
 func getHistogramRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Format uint32, Type uint32, SwapBytes bool, Reset bool) []byte {
 	size := 24
 	b := 0
@@ -8021,29 +8349,31 @@ func getHistogramRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Form
 	return buf
 }
 
-// Request GetHistogramParameterfv
-// size: 16
+// GetHistogramParameterfvCookie is a cookie used only for GetHistogramParameterfv requests.
 type GetHistogramParameterfvCookie struct {
 	*xgb.Cookie
 }
 
+// GetHistogramParameterfv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetHistogramParameterfvCookie.Reply()
 func GetHistogramParameterfv(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetHistogramParameterfvCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getHistogramParameterfvRequest(c, ContextTag, Target, Pname), cookie)
 	return GetHistogramParameterfvCookie{cookie}
 }
 
+// GetHistogramParameterfvUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetHistogramParameterfvUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetHistogramParameterfvCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getHistogramParameterfvRequest(c, ContextTag, Target, Pname), cookie)
 	return GetHistogramParameterfvCookie{cookie}
 }
 
-// Request reply for GetHistogramParameterfv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetHistogramParameterfvReply represents the data returned from a GetHistogramParameterfv request.
 type GetHistogramParameterfvReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -8052,7 +8382,7 @@ type GetHistogramParameterfvReply struct {
 	Data []Float32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetHistogramParameterfv
+// Reply blocks and returns the reply data for a GetHistogramParameterfv request.
 func (cook GetHistogramParameterfvCookie) Reply() (*GetHistogramParameterfvReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -8064,7 +8394,7 @@ func (cook GetHistogramParameterfvCookie) Reply() (*GetHistogramParameterfvReply
 	return getHistogramParameterfvReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetHistogramParameterfv
+// getHistogramParameterfvReply reads a byte slice into a GetHistogramParameterfvReply value.
 func getHistogramParameterfvReply(buf []byte) *GetHistogramParameterfvReply {
 	v := new(GetHistogramParameterfvReply)
 	b := 1 // skip reply determinant
@@ -8098,6 +8428,7 @@ func getHistogramParameterfvReply(buf []byte) *GetHistogramParameterfvReply {
 }
 
 // Write request to wire for GetHistogramParameterfv
+// getHistogramParameterfvRequest writes a GetHistogramParameterfv request to a byte slice.
 func getHistogramParameterfvRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) []byte {
 	size := 16
 	b := 0
@@ -8124,29 +8455,31 @@ func getHistogramParameterfvRequest(c *xgb.Conn, ContextTag ContextTag, Target u
 	return buf
 }
 
-// Request GetHistogramParameteriv
-// size: 16
+// GetHistogramParameterivCookie is a cookie used only for GetHistogramParameteriv requests.
 type GetHistogramParameterivCookie struct {
 	*xgb.Cookie
 }
 
+// GetHistogramParameteriv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetHistogramParameterivCookie.Reply()
 func GetHistogramParameteriv(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetHistogramParameterivCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getHistogramParameterivRequest(c, ContextTag, Target, Pname), cookie)
 	return GetHistogramParameterivCookie{cookie}
 }
 
+// GetHistogramParameterivUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetHistogramParameterivUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetHistogramParameterivCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getHistogramParameterivRequest(c, ContextTag, Target, Pname), cookie)
 	return GetHistogramParameterivCookie{cookie}
 }
 
-// Request reply for GetHistogramParameteriv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetHistogramParameterivReply represents the data returned from a GetHistogramParameteriv request.
 type GetHistogramParameterivReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -8155,7 +8488,7 @@ type GetHistogramParameterivReply struct {
 	Data []int32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetHistogramParameteriv
+// Reply blocks and returns the reply data for a GetHistogramParameteriv request.
 func (cook GetHistogramParameterivCookie) Reply() (*GetHistogramParameterivReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -8167,7 +8500,7 @@ func (cook GetHistogramParameterivCookie) Reply() (*GetHistogramParameterivReply
 	return getHistogramParameterivReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetHistogramParameteriv
+// getHistogramParameterivReply reads a byte slice into a GetHistogramParameterivReply value.
 func getHistogramParameterivReply(buf []byte) *GetHistogramParameterivReply {
 	v := new(GetHistogramParameterivReply)
 	b := 1 // skip reply determinant
@@ -8201,6 +8534,7 @@ func getHistogramParameterivReply(buf []byte) *GetHistogramParameterivReply {
 }
 
 // Write request to wire for GetHistogramParameteriv
+// getHistogramParameterivRequest writes a GetHistogramParameteriv request to a byte slice.
 func getHistogramParameterivRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) []byte {
 	size := 16
 	b := 0
@@ -8227,35 +8561,37 @@ func getHistogramParameterivRequest(c *xgb.Conn, ContextTag ContextTag, Target u
 	return buf
 }
 
-// Request GetMinmax
-// size: 24
+// GetMinmaxCookie is a cookie used only for GetMinmax requests.
 type GetMinmaxCookie struct {
 	*xgb.Cookie
 }
 
+// GetMinmax sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetMinmaxCookie.Reply()
 func GetMinmax(c *xgb.Conn, ContextTag ContextTag, Target uint32, Format uint32, Type uint32, SwapBytes bool, Reset bool) GetMinmaxCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getMinmaxRequest(c, ContextTag, Target, Format, Type, SwapBytes, Reset), cookie)
 	return GetMinmaxCookie{cookie}
 }
 
+// GetMinmaxUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetMinmaxUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Format uint32, Type uint32, SwapBytes bool, Reset bool) GetMinmaxCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getMinmaxRequest(c, ContextTag, Target, Format, Type, SwapBytes, Reset), cookie)
 	return GetMinmaxCookie{cookie}
 }
 
-// Request reply for GetMinmax
-// size: (32 + xgb.Pad(((int(Length) * 4) * 1)))
+// GetMinmaxReply represents the data returned from a GetMinmax request.
 type GetMinmaxReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 24 bytes
 	Data []byte // size: xgb.Pad(((int(Length) * 4) * 1))
 }
 
-// Waits and reads reply data from request GetMinmax
+// Reply blocks and returns the reply data for a GetMinmax request.
 func (cook GetMinmaxCookie) Reply() (*GetMinmaxReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -8267,7 +8603,7 @@ func (cook GetMinmaxCookie) Reply() (*GetMinmaxReply, error) {
 	return getMinmaxReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetMinmax
+// getMinmaxReply reads a byte slice into a GetMinmaxReply value.
 func getMinmaxReply(buf []byte) *GetMinmaxReply {
 	v := new(GetMinmaxReply)
 	b := 1 // skip reply determinant
@@ -8290,6 +8626,7 @@ func getMinmaxReply(buf []byte) *GetMinmaxReply {
 }
 
 // Write request to wire for GetMinmax
+// getMinmaxRequest writes a GetMinmax request to a byte slice.
 func getMinmaxRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Format uint32, Type uint32, SwapBytes bool, Reset bool) []byte {
 	size := 24
 	b := 0
@@ -8333,29 +8670,31 @@ func getMinmaxRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Format
 	return buf
 }
 
-// Request GetMinmaxParameterfv
-// size: 16
+// GetMinmaxParameterfvCookie is a cookie used only for GetMinmaxParameterfv requests.
 type GetMinmaxParameterfvCookie struct {
 	*xgb.Cookie
 }
 
+// GetMinmaxParameterfv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetMinmaxParameterfvCookie.Reply()
 func GetMinmaxParameterfv(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetMinmaxParameterfvCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getMinmaxParameterfvRequest(c, ContextTag, Target, Pname), cookie)
 	return GetMinmaxParameterfvCookie{cookie}
 }
 
+// GetMinmaxParameterfvUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetMinmaxParameterfvUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetMinmaxParameterfvCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getMinmaxParameterfvRequest(c, ContextTag, Target, Pname), cookie)
 	return GetMinmaxParameterfvCookie{cookie}
 }
 
-// Request reply for GetMinmaxParameterfv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetMinmaxParameterfvReply represents the data returned from a GetMinmaxParameterfv request.
 type GetMinmaxParameterfvReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -8364,7 +8703,7 @@ type GetMinmaxParameterfvReply struct {
 	Data []Float32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetMinmaxParameterfv
+// Reply blocks and returns the reply data for a GetMinmaxParameterfv request.
 func (cook GetMinmaxParameterfvCookie) Reply() (*GetMinmaxParameterfvReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -8376,7 +8715,7 @@ func (cook GetMinmaxParameterfvCookie) Reply() (*GetMinmaxParameterfvReply, erro
 	return getMinmaxParameterfvReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetMinmaxParameterfv
+// getMinmaxParameterfvReply reads a byte slice into a GetMinmaxParameterfvReply value.
 func getMinmaxParameterfvReply(buf []byte) *GetMinmaxParameterfvReply {
 	v := new(GetMinmaxParameterfvReply)
 	b := 1 // skip reply determinant
@@ -8410,6 +8749,7 @@ func getMinmaxParameterfvReply(buf []byte) *GetMinmaxParameterfvReply {
 }
 
 // Write request to wire for GetMinmaxParameterfv
+// getMinmaxParameterfvRequest writes a GetMinmaxParameterfv request to a byte slice.
 func getMinmaxParameterfvRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) []byte {
 	size := 16
 	b := 0
@@ -8436,29 +8776,31 @@ func getMinmaxParameterfvRequest(c *xgb.Conn, ContextTag ContextTag, Target uint
 	return buf
 }
 
-// Request GetMinmaxParameteriv
-// size: 16
+// GetMinmaxParameterivCookie is a cookie used only for GetMinmaxParameteriv requests.
 type GetMinmaxParameterivCookie struct {
 	*xgb.Cookie
 }
 
+// GetMinmaxParameteriv sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetMinmaxParameterivCookie.Reply()
 func GetMinmaxParameteriv(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetMinmaxParameterivCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getMinmaxParameterivRequest(c, ContextTag, Target, Pname), cookie)
 	return GetMinmaxParameterivCookie{cookie}
 }
 
+// GetMinmaxParameterivUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetMinmaxParameterivUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetMinmaxParameterivCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getMinmaxParameterivRequest(c, ContextTag, Target, Pname), cookie)
 	return GetMinmaxParameterivCookie{cookie}
 }
 
-// Request reply for GetMinmaxParameteriv
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetMinmaxParameterivReply represents the data returned from a GetMinmaxParameteriv request.
 type GetMinmaxParameterivReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -8467,7 +8809,7 @@ type GetMinmaxParameterivReply struct {
 	Data []int32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetMinmaxParameteriv
+// Reply blocks and returns the reply data for a GetMinmaxParameteriv request.
 func (cook GetMinmaxParameterivCookie) Reply() (*GetMinmaxParameterivReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -8479,7 +8821,7 @@ func (cook GetMinmaxParameterivCookie) Reply() (*GetMinmaxParameterivReply, erro
 	return getMinmaxParameterivReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetMinmaxParameteriv
+// getMinmaxParameterivReply reads a byte slice into a GetMinmaxParameterivReply value.
 func getMinmaxParameterivReply(buf []byte) *GetMinmaxParameterivReply {
 	v := new(GetMinmaxParameterivReply)
 	b := 1 // skip reply determinant
@@ -8513,6 +8855,7 @@ func getMinmaxParameterivReply(buf []byte) *GetMinmaxParameterivReply {
 }
 
 // Write request to wire for GetMinmaxParameteriv
+// getMinmaxParameterivRequest writes a GetMinmaxParameteriv request to a byte slice.
 func getMinmaxParameterivRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) []byte {
 	size := 16
 	b := 0
@@ -8539,29 +8882,31 @@ func getMinmaxParameterivRequest(c *xgb.Conn, ContextTag ContextTag, Target uint
 	return buf
 }
 
-// Request GetCompressedTexImageARB
-// size: 16
+// GetCompressedTexImageARBCookie is a cookie used only for GetCompressedTexImageARB requests.
 type GetCompressedTexImageARBCookie struct {
 	*xgb.Cookie
 }
 
+// GetCompressedTexImageARB sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetCompressedTexImageARBCookie.Reply()
 func GetCompressedTexImageARB(c *xgb.Conn, ContextTag ContextTag, Target uint32, Level int32) GetCompressedTexImageARBCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getCompressedTexImageARBRequest(c, ContextTag, Target, Level), cookie)
 	return GetCompressedTexImageARBCookie{cookie}
 }
 
+// GetCompressedTexImageARBUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetCompressedTexImageARBUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Level int32) GetCompressedTexImageARBCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getCompressedTexImageARBRequest(c, ContextTag, Target, Level), cookie)
 	return GetCompressedTexImageARBCookie{cookie}
 }
 
-// Request reply for GetCompressedTexImageARB
-// size: (32 + xgb.Pad(((int(Length) * 4) * 1)))
+// GetCompressedTexImageARBReply represents the data returned from a GetCompressedTexImageARB request.
 type GetCompressedTexImageARBReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 8 bytes
 	Size int32
@@ -8569,7 +8914,7 @@ type GetCompressedTexImageARBReply struct {
 	Data []byte // size: xgb.Pad(((int(Length) * 4) * 1))
 }
 
-// Waits and reads reply data from request GetCompressedTexImageARB
+// Reply blocks and returns the reply data for a GetCompressedTexImageARB request.
 func (cook GetCompressedTexImageARBCookie) Reply() (*GetCompressedTexImageARBReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -8581,7 +8926,7 @@ func (cook GetCompressedTexImageARBCookie) Reply() (*GetCompressedTexImageARBRep
 	return getCompressedTexImageARBReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetCompressedTexImageARB
+// getCompressedTexImageARBReply reads a byte slice into a GetCompressedTexImageARBReply value.
 func getCompressedTexImageARBReply(buf []byte) *GetCompressedTexImageARBReply {
 	v := new(GetCompressedTexImageARBReply)
 	b := 1 // skip reply determinant
@@ -8609,6 +8954,7 @@ func getCompressedTexImageARBReply(buf []byte) *GetCompressedTexImageARBReply {
 }
 
 // Write request to wire for GetCompressedTexImageARB
+// getCompressedTexImageARBRequest writes a GetCompressedTexImageARB request to a byte slice.
 func getCompressedTexImageARBRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Level int32) []byte {
 	size := 16
 	b := 0
@@ -8635,30 +8981,35 @@ func getCompressedTexImageARBRequest(c *xgb.Conn, ContextTag ContextTag, Target
 	return buf
 }
 
-// Request DeleteQueriesARB
-// size: xgb.Pad((12 + xgb.Pad((int(N) * 4))))
+// DeleteQueriesARBCookie is a cookie used only for DeleteQueriesARB requests.
 type DeleteQueriesARBCookie struct {
 	*xgb.Cookie
 }
 
-// Write request to wire for DeleteQueriesARB
+// DeleteQueriesARB sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func DeleteQueriesARB(c *xgb.Conn, ContextTag ContextTag, N int32, Ids []uint32) DeleteQueriesARBCookie {
 	cookie := c.NewCookie(false, false)
 	c.NewRequest(deleteQueriesARBRequest(c, ContextTag, N, Ids), cookie)
 	return DeleteQueriesARBCookie{cookie}
 }
 
+// DeleteQueriesARBChecked sends a checked request.
+// If an error occurs, it can be retrieved using DeleteQueriesARBCookie.Check()
 func DeleteQueriesARBChecked(c *xgb.Conn, ContextTag ContextTag, N int32, Ids []uint32) DeleteQueriesARBCookie {
 	cookie := c.NewCookie(true, false)
 	c.NewRequest(deleteQueriesARBRequest(c, ContextTag, N, Ids), cookie)
 	return DeleteQueriesARBCookie{cookie}
 }
 
+// Check returns an error if one occurred for checked requests that are not expecting a reply.
+// This cannot be called for requests expecting a reply, nor for unchecked requests.
 func (cook DeleteQueriesARBCookie) Check() error {
 	return cook.Cookie.Check()
 }
 
 // Write request to wire for DeleteQueriesARB
+// deleteQueriesARBRequest writes a DeleteQueriesARB request to a byte slice.
 func deleteQueriesARBRequest(c *xgb.Conn, ContextTag ContextTag, N int32, Ids []uint32) []byte {
 	size := xgb.Pad((12 + xgb.Pad((int(N) * 4))))
 	b := 0
@@ -8688,35 +9039,37 @@ func deleteQueriesARBRequest(c *xgb.Conn, ContextTag ContextTag, N int32, Ids []
 	return buf
 }
 
-// Request GenQueriesARB
-// size: 12
+// GenQueriesARBCookie is a cookie used only for GenQueriesARB requests.
 type GenQueriesARBCookie struct {
 	*xgb.Cookie
 }
 
+// GenQueriesARB sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GenQueriesARBCookie.Reply()
 func GenQueriesARB(c *xgb.Conn, ContextTag ContextTag, N int32) GenQueriesARBCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(genQueriesARBRequest(c, ContextTag, N), cookie)
 	return GenQueriesARBCookie{cookie}
 }
 
+// GenQueriesARBUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GenQueriesARBUnchecked(c *xgb.Conn, ContextTag ContextTag, N int32) GenQueriesARBCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(genQueriesARBRequest(c, ContextTag, N), cookie)
 	return GenQueriesARBCookie{cookie}
 }
 
-// Request reply for GenQueriesARB
-// size: (32 + xgb.Pad((int(Length) * 4)))
+// GenQueriesARBReply represents the data returned from a GenQueriesARB request.
 type GenQueriesARBReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 24 bytes
 	Data []uint32 // size: xgb.Pad((int(Length) * 4))
 }
 
-// Waits and reads reply data from request GenQueriesARB
+// Reply blocks and returns the reply data for a GenQueriesARB request.
 func (cook GenQueriesARBCookie) Reply() (*GenQueriesARBReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -8728,7 +9081,7 @@ func (cook GenQueriesARBCookie) Reply() (*GenQueriesARBReply, error) {
 	return genQueriesARBReply(buf), nil
 }
 
-// Read reply into structure from buffer for GenQueriesARB
+// genQueriesARBReply reads a byte slice into a GenQueriesARBReply value.
 func genQueriesARBReply(buf []byte) *GenQueriesARBReply {
 	v := new(GenQueriesARBReply)
 	b := 1 // skip reply determinant
@@ -8754,6 +9107,7 @@ func genQueriesARBReply(buf []byte) *GenQueriesARBReply {
 }
 
 // Write request to wire for GenQueriesARB
+// genQueriesARBRequest writes a GenQueriesARB request to a byte slice.
 func genQueriesARBRequest(c *xgb.Conn, ContextTag ContextTag, N int32) []byte {
 	size := 12
 	b := 0
@@ -8777,34 +9131,36 @@ func genQueriesARBRequest(c *xgb.Conn, ContextTag ContextTag, N int32) []byte {
 	return buf
 }
 
-// Request IsQueryARB
-// size: 12
+// IsQueryARBCookie is a cookie used only for IsQueryARB requests.
 type IsQueryARBCookie struct {
 	*xgb.Cookie
 }
 
+// IsQueryARB sends a checked request.
+// If an error occurs, it will be returned with the reply by calling IsQueryARBCookie.Reply()
 func IsQueryARB(c *xgb.Conn, ContextTag ContextTag, Id uint32) IsQueryARBCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(isQueryARBRequest(c, ContextTag, Id), cookie)
 	return IsQueryARBCookie{cookie}
 }
 
+// IsQueryARBUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func IsQueryARBUnchecked(c *xgb.Conn, ContextTag ContextTag, Id uint32) IsQueryARBCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(isQueryARBRequest(c, ContextTag, Id), cookie)
 	return IsQueryARBCookie{cookie}
 }
 
-// Request reply for IsQueryARB
-// size: 12
+// IsQueryARBReply represents the data returned from a IsQueryARB request.
 type IsQueryARBReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	RetVal Bool32
 }
 
-// Waits and reads reply data from request IsQueryARB
+// Reply blocks and returns the reply data for a IsQueryARB request.
 func (cook IsQueryARBCookie) Reply() (*IsQueryARBReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -8816,7 +9172,7 @@ func (cook IsQueryARBCookie) Reply() (*IsQueryARBReply, error) {
 	return isQueryARBReply(buf), nil
 }
 
-// Read reply into structure from buffer for IsQueryARB
+// isQueryARBReply reads a byte slice into a IsQueryARBReply value.
 func isQueryARBReply(buf []byte) *IsQueryARBReply {
 	v := new(IsQueryARBReply)
 	b := 1 // skip reply determinant
@@ -8836,6 +9192,7 @@ func isQueryARBReply(buf []byte) *IsQueryARBReply {
 }
 
 // Write request to wire for IsQueryARB
+// isQueryARBRequest writes a IsQueryARB request to a byte slice.
 func isQueryARBRequest(c *xgb.Conn, ContextTag ContextTag, Id uint32) []byte {
 	size := 12
 	b := 0
@@ -8859,29 +9216,31 @@ func isQueryARBRequest(c *xgb.Conn, ContextTag ContextTag, Id uint32) []byte {
 	return buf
 }
 
-// Request GetQueryivARB
-// size: 16
+// GetQueryivARBCookie is a cookie used only for GetQueryivARB requests.
 type GetQueryivARBCookie struct {
 	*xgb.Cookie
 }
 
+// GetQueryivARB sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetQueryivARBCookie.Reply()
 func GetQueryivARB(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetQueryivARBCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getQueryivARBRequest(c, ContextTag, Target, Pname), cookie)
 	return GetQueryivARBCookie{cookie}
 }
 
+// GetQueryivARBUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetQueryivARBUnchecked(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) GetQueryivARBCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getQueryivARBRequest(c, ContextTag, Target, Pname), cookie)
 	return GetQueryivARBCookie{cookie}
 }
 
-// Request reply for GetQueryivARB
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetQueryivARBReply represents the data returned from a GetQueryivARB request.
 type GetQueryivARBReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -8890,7 +9249,7 @@ type GetQueryivARBReply struct {
 	Data []int32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetQueryivARB
+// Reply blocks and returns the reply data for a GetQueryivARB request.
 func (cook GetQueryivARBCookie) Reply() (*GetQueryivARBReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -8902,7 +9261,7 @@ func (cook GetQueryivARBCookie) Reply() (*GetQueryivARBReply, error) {
 	return getQueryivARBReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetQueryivARB
+// getQueryivARBReply reads a byte slice into a GetQueryivARBReply value.
 func getQueryivARBReply(buf []byte) *GetQueryivARBReply {
 	v := new(GetQueryivARBReply)
 	b := 1 // skip reply determinant
@@ -8936,6 +9295,7 @@ func getQueryivARBReply(buf []byte) *GetQueryivARBReply {
 }
 
 // Write request to wire for GetQueryivARB
+// getQueryivARBRequest writes a GetQueryivARB request to a byte slice.
 func getQueryivARBRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pname uint32) []byte {
 	size := 16
 	b := 0
@@ -8962,29 +9322,31 @@ func getQueryivARBRequest(c *xgb.Conn, ContextTag ContextTag, Target uint32, Pna
 	return buf
 }
 
-// Request GetQueryObjectivARB
-// size: 16
+// GetQueryObjectivARBCookie is a cookie used only for GetQueryObjectivARB requests.
 type GetQueryObjectivARBCookie struct {
 	*xgb.Cookie
 }
 
+// GetQueryObjectivARB sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetQueryObjectivARBCookie.Reply()
 func GetQueryObjectivARB(c *xgb.Conn, ContextTag ContextTag, Id uint32, Pname uint32) GetQueryObjectivARBCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getQueryObjectivARBRequest(c, ContextTag, Id, Pname), cookie)
 	return GetQueryObjectivARBCookie{cookie}
 }
 
+// GetQueryObjectivARBUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetQueryObjectivARBUnchecked(c *xgb.Conn, ContextTag ContextTag, Id uint32, Pname uint32) GetQueryObjectivARBCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getQueryObjectivARBRequest(c, ContextTag, Id, Pname), cookie)
 	return GetQueryObjectivARBCookie{cookie}
 }
 
-// Request reply for GetQueryObjectivARB
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetQueryObjectivARBReply represents the data returned from a GetQueryObjectivARB request.
 type GetQueryObjectivARBReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -8993,7 +9355,7 @@ type GetQueryObjectivARBReply struct {
 	Data []int32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetQueryObjectivARB
+// Reply blocks and returns the reply data for a GetQueryObjectivARB request.
 func (cook GetQueryObjectivARBCookie) Reply() (*GetQueryObjectivARBReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -9005,7 +9367,7 @@ func (cook GetQueryObjectivARBCookie) Reply() (*GetQueryObjectivARBReply, error)
 	return getQueryObjectivARBReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetQueryObjectivARB
+// getQueryObjectivARBReply reads a byte slice into a GetQueryObjectivARBReply value.
 func getQueryObjectivARBReply(buf []byte) *GetQueryObjectivARBReply {
 	v := new(GetQueryObjectivARBReply)
 	b := 1 // skip reply determinant
@@ -9039,6 +9401,7 @@ func getQueryObjectivARBReply(buf []byte) *GetQueryObjectivARBReply {
 }
 
 // Write request to wire for GetQueryObjectivARB
+// getQueryObjectivARBRequest writes a GetQueryObjectivARB request to a byte slice.
 func getQueryObjectivARBRequest(c *xgb.Conn, ContextTag ContextTag, Id uint32, Pname uint32) []byte {
 	size := 16
 	b := 0
@@ -9065,29 +9428,31 @@ func getQueryObjectivARBRequest(c *xgb.Conn, ContextTag ContextTag, Id uint32, P
 	return buf
 }
 
-// Request GetQueryObjectuivARB
-// size: 16
+// GetQueryObjectuivARBCookie is a cookie used only for GetQueryObjectuivARB requests.
 type GetQueryObjectuivARBCookie struct {
 	*xgb.Cookie
 }
 
+// GetQueryObjectuivARB sends a checked request.
+// If an error occurs, it will be returned with the reply by calling GetQueryObjectuivARBCookie.Reply()
 func GetQueryObjectuivARB(c *xgb.Conn, ContextTag ContextTag, Id uint32, Pname uint32) GetQueryObjectuivARBCookie {
 	cookie := c.NewCookie(true, true)
 	c.NewRequest(getQueryObjectuivARBRequest(c, ContextTag, Id, Pname), cookie)
 	return GetQueryObjectuivARBCookie{cookie}
 }
 
+// GetQueryObjectuivARBUnchecked sends an unchecked request.
+// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
 func GetQueryObjectuivARBUnchecked(c *xgb.Conn, ContextTag ContextTag, Id uint32, Pname uint32) GetQueryObjectuivARBCookie {
 	cookie := c.NewCookie(false, true)
 	c.NewRequest(getQueryObjectuivARBRequest(c, ContextTag, Id, Pname), cookie)
 	return GetQueryObjectuivARBCookie{cookie}
 }
 
-// Request reply for GetQueryObjectuivARB
-// size: (32 + xgb.Pad((int(N) * 4)))
+// GetQueryObjectuivARBReply represents the data returned from a GetQueryObjectuivARB request.
 type GetQueryObjectuivARBReply struct {
-	Sequence uint16
-	Length   uint32
+	Sequence uint16 // sequence number of the request for this reply
+	Length   uint32 // number of bytes in this reply
 	// padding: 1 bytes
 	// padding: 4 bytes
 	N     uint32
@@ -9096,7 +9461,7 @@ type GetQueryObjectuivARBReply struct {
 	Data []uint32 // size: xgb.Pad((int(N) * 4))
 }
 
-// Waits and reads reply data from request GetQueryObjectuivARB
+// Reply blocks and returns the reply data for a GetQueryObjectuivARB request.
 func (cook GetQueryObjectuivARBCookie) Reply() (*GetQueryObjectuivARBReply, error) {
 	buf, err := cook.Cookie.Reply()
 	if err != nil {
@@ -9108,7 +9473,7 @@ func (cook GetQueryObjectuivARBCookie) Reply() (*GetQueryObjectuivARBReply, erro
 	return getQueryObjectuivARBReply(buf), nil
 }
 
-// Read reply into structure from buffer for GetQueryObjectuivARB
+// getQueryObjectuivARBReply reads a byte slice into a GetQueryObjectuivARBReply value.
 func getQueryObjectuivARBReply(buf []byte) *GetQueryObjectuivARBReply {
 	v := new(GetQueryObjectuivARBReply)
 	b := 1 // skip reply determinant
@@ -9142,6 +9507,7 @@ func getQueryObjectuivARBReply(buf []byte) *GetQueryObjectuivARBReply {
 }
 
 // Write request to wire for GetQueryObjectuivARB
+// getQueryObjectuivARBRequest writes a GetQueryObjectuivARB request to a byte slice.
 func getQueryObjectuivARBRequest(c *xgb.Conn, ContextTag ContextTag, Id uint32, Pname uint32) []byte {
 	size := 16
 	b := 0