From 74ccae079eef7fb4fa04d8246bc03ee2eb34abfe Mon Sep 17 00:00:00 2001
From: Derek Collison <derek@apcera.com>
Date: Thu, 24 Oct 2013 10:46:54 -0700
Subject: [PATCH] pkg comments

---
 conf/parse.go      | 12 +++++++-----
 sublist/sublist.go |  5 ++++-
 2 files changed, 11 insertions(+), 6 deletions(-)

diff --git a/conf/parse.go b/conf/parse.go
index 576f94d3..a2edc99a 100644
--- a/conf/parse.go
+++ b/conf/parse.go
@@ -1,8 +1,9 @@
 // Copyright 2013 Apcera Inc. All rights reserved.
 
-// Parser will return a map of keys to interface{}, although concrete types
-// underly them. The values supported are string, bool, int64, float64, DateTime.
-// Arrays and nested Maps are also supported.
+// Conf is a configuration file format used by gnatsd. It is
+// a flexible format that combines the best of traditional
+// configuration formats and newer styles such as JSON and YAML.
+package conf
 
 // The format supported is less restrictive than today's formats.
 // Supports mixed Arrays [], nested Maps {}, multiple comment types (# and //)
@@ -13,14 +14,15 @@
 //
 // see parse_test.go for more examples.
 
-package conf
-
 import (
 	"fmt"
 	"strconv"
 	"time"
 )
 
+// Parser will return a map of keys to interface{}, although concrete types
+// underly them. The values supported are string, bool, int64, float64, DateTime.
+// Arrays and nested Maps are also supported.
 type parser struct {
 	mapping map[string]interface{}
 	lx      *lexer
diff --git a/sublist/sublist.go b/sublist/sublist.go
index 2a8e6c2f..690f591b 100644
--- a/sublist/sublist.go
+++ b/sublist/sublist.go
@@ -1,5 +1,8 @@
-// Copyright 2012 Apcera Inc. All rights reserved.
+// Copyright 2012-2013 Apcera Inc. All rights reserved.
 
+// Sublist is a subject distribution data structure that can match subjects to
+// interested subscribers. Subscribers can have wildcard subjects to match
+// multiple published subjects.
 package sublist
 
 import (