From 24fef4062ad441c935f5a87e908c5f293d8a2f42 Mon Sep 17 00:00:00 2001
From: "Andrew Gallant (Ocelot)" <Andrew.Gallant@tufts.edu>
Date: Sat, 12 May 2012 21:36:31 -0400
Subject: docs
---
nexgb/auth.go | 10 ++++++----
nexgb/conn.go | 7 +++++++
nexgb/help.go | 10 ++++++++++
nexgb/sync.go | 2 +-
nexgb/xgb.go | 7 +++++--
5 files changed, 29 insertions(+), 7 deletions(-)
diff --git a/nexgb/auth.go b/nexgb/auth.go
index 85e2d56..396e832 100644
--- a/nexgb/auth.go
+++ b/nexgb/auth.go
@@ -1,9 +1,11 @@
-// Copyright 2009 The XGB Authors. All rights reserved.
-// Use of this source code is governed by a BSD-style
-// license that can be found in the LICENSE file.
-
package xgb
+/*
+auth.go contains functions to facilitate the parsing of .Xauthority files.
+
+It is largely unmodified from the original XGB package that I forked.
+*/
+
import (
"bufio"
"errors"
diff --git a/nexgb/conn.go b/nexgb/conn.go
index 662a059..9baf86c 100644
--- a/nexgb/conn.go
+++ b/nexgb/conn.go
@@ -1,5 +1,12 @@
package xgb
+/*
+conn.go contains a couple of functions that do some real dirty work related
+to the initial connection handshake with X.
+
+This code is largely unmodified from the original XGB package that I forked.
+*/
+
import (
"errors"
"fmt"
diff --git a/nexgb/help.go b/nexgb/help.go
index 36fe98b..5729917 100644
--- a/nexgb/help.go
+++ b/nexgb/help.go
@@ -1,5 +1,15 @@
package xgb
+/*
+help.go is meant to contain a rough hodge podge of functions that are mainly
+used in the auto generated code. Indeed, several functions here are simple
+wrappers so that the sub-packages don't need to be smart about which stdlib
+packages to import.
+
+Also, the 'Get..' and 'Put..' functions are used through the core xgb package
+too. (xgbutil uses them too.)
+*/
+
import (
"fmt"
"strings"
diff --git a/nexgb/sync.go b/nexgb/sync.go
index d671e62..59d0de1 100644
--- a/nexgb/sync.go
+++ b/nexgb/sync.go
@@ -1,6 +1,6 @@
package xgb
-// Sync sends a round trip request and wait for the response.
+// Sync sends a round trip request and waits for the response.
// This forces all pending cookies to be dealt with.
// You actually shouldn't need to use this like you might with Xlib. Namely,
// buffers are automatically flushed using Go's channels and round trip requests
diff --git a/nexgb/xgb.go b/nexgb/xgb.go
index 50cfdba..b2cf56c 100644
--- a/nexgb/xgb.go
+++ b/nexgb/xgb.go
@@ -166,8 +166,11 @@ type eventOrError interface{}
// NewID generates a new unused ID for use with requests like CreateWindow.
// If no new ids can be generated, the id returned is 0 and error is non-nil.
-// Note that the value returned will need to be converted to the proper
-// type. i.e., xproto.Window(id).
+// This shouldn't be used directly, and is exported for use in the extension
+// sub-packages.
+// If you need identifiers, use the appropriate constructor.
+// e.g., For a window id, use xproto.NewWindowId. For
+// a new pixmap id, use xproto.NewPixmapId. And so on.
func (c *Conn) NewId() (uint32, error) {
xid := <-c.xidChan
if xid.err != nil {
--
cgit v1.2.3-70-g09d2