Improve code documentation

proc/doc.go

@@ -1,10 +1,9 @@
 // proc is a low-level package that provides methods to manipulate
-// the process we are debugging, and methods to read and write from
-// the virtual memory of the process.
-//
-// proc implements the core features of this debugger, including all
-// process manipulation (step, next, continue, halt) as well as providing
-// methods to evaluate variables and read them from the virtual memory of
 // the process we are debugging.
 //
+// proc implements all core functionality including:
+// * creating / attaching to a process
+// * process manipulation (step, next, continue, halt)
+// * methods to explore the memory of the process
+//
 package proc

proc/proc_linux.go

@@ -19,6 +19,7 @@ import (
 	"github.com/derekparker/delve/dwarf/line"
 )
 
+// Process statuses
 const (
 	STATUS_SLEEPING   = 'S'
 	STATUS_RUNNING    = 'R'