add fix all package level docs

cmd/doc.go

@@ -0,0 +1,4 @@
+/*
+Package cmd contains all the pilosa subcommand definitions (1 per file).
+*/
+package cmd

cmd/pilosa/main.go

@@ -1,3 +1,6 @@
+/*
+This is the entrypoint for the Pilosa binary.
+*/
 package main
 
 import (

ctl/doc.go

@@ -0,0 +1,3 @@
+// package ctl contains all pilosa subcommands other than 'server'. These are
+// generally administration, testing, and debugging tools.
+package ctl

doc.go

@@ -1,9 +1,7 @@
 /*
 
 Package pilosa implements the core of the Pilosa distributed bitmap index. It
-contains all the core domain objects, interfaces, and high level logic that make
-pilosa work.
+contains all the domain objects, interfaces, and logic that defines pilosa.
 
 */
-
 package pilosa

pql/doc.go

@@ -0,0 +1,4 @@
+/*
+Package pql defines the Pilosa Query Language.
+*/
+package pql

server/server.go

@@ -1,3 +1,7 @@
+// package server contains the `pilosa server` subcommand which runs Pilosa
+// itself. The purpose of this package is to define an easily tested Command
+// object which handles interpreting configuration and setting up all the
+// objects that Pilosa needs.
 package server
 
 import (