minor adjustments to package comments for better synopsis.
R=rsc
CC=r
http://go/go-review/1026038
diff --git a/src/pkg/asn1/asn1.go b/src/pkg/asn1/asn1.go
index bc045e3..3afd6fb 100644
--- a/src/pkg/asn1/asn1.go
+++ b/src/pkg/asn1/asn1.go
@@ -2,8 +2,8 @@
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.
-// This package implements parsing of DER-encoded ASN.1 data structures,
-// as defined in ITU-T Rec. X.690.
+// The asn1 package implements parsing of DER-encoded ASN.1 data structures,
+// as defined in ITU-T Rec X.690.
//
// See also ``A Layman's Guide to a Subset of ASN.1, BER, and DER,''
// http://luca.ntop.org/Teaching/Appunti/asn1.html.
diff --git a/src/pkg/big/nat.go b/src/pkg/big/nat.go
index a795cd6..c8e69a3 100644
--- a/src/pkg/big/nat.go
+++ b/src/pkg/big/nat.go
@@ -6,9 +6,9 @@
// These are the building blocks for the operations on signed integers
// and rationals.
-// NOTE: PACKAGE UNDER CONSTRUCTION (use bignum for the time being)
+// NOTE: PACKAGE UNDER CONSTRUCTION.
//
-// This package implements multi-precision arithmetic (big numbers).
+// The big package implements multi-precision arithmetic (big numbers).
// The following numeric types are supported:
//
// - Int signed integers
diff --git a/src/pkg/bytes/bytes.go b/src/pkg/bytes/bytes.go
index c0a861f..ccaa71a 100644
--- a/src/pkg/bytes/bytes.go
+++ b/src/pkg/bytes/bytes.go
@@ -2,7 +2,7 @@
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.
-// A package of simple functions to manipulate arrays of bytes.
+// The bytes package implements functions for the manipulation of byte slices.
// Analagous to the facilities of the strings package.
package bytes
diff --git a/src/pkg/tabwriter/tabwriter.go b/src/pkg/tabwriter/tabwriter.go
index 67767f1..c469ae4 100644
--- a/src/pkg/tabwriter/tabwriter.go
+++ b/src/pkg/tabwriter/tabwriter.go
@@ -3,8 +3,9 @@
// license that can be found in the LICENSE file.
// The tabwriter package implements a write filter (tabwriter.Writer)
-// that translates tabbed columns in input into properly aligned text,
-// using the Elastic Tabstops algorithm described at
+// that translates tabbed columns in input into properly aligned text.
+//
+// The package is using the Elastic Tabstops algorithm described at
// http://nickgravgaard.com/elastictabstops/index.html.
//
package tabwriter
