+;; You should have received a copy of the GNU General Public License
+;; along with GNU Emacs; see the file COPYING. If not, write to the
+;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+;; Boston, MA 02111-1307, USA.
+
+;;; Commentary:
+
+;; manages receiving a stream asynchronously,
+;; parsing it into transactions, and then calling
+;; handler functions
+
+;; Our basic structure is the queue/process/buffer triple. Each entry
+;; of the queue is a regexp/closure/function triple. We buffer
+;; bytes from the process until we see the regexp at the head of the
+;; queue. Then we call the function with the closure and the
+;; collected bytes.