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 bc045e31f9b27bd837f4cec29de6867a8bb7f10b..3afd6fbb1e90fbf42bdc4662cad89bf652b20761 100644 (file)
--- 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 a795cd6267f2f01cf9ac9f2f1e3dbce8ce046c15..c8e69a382643c6b397142a381b21bfcb0110e959 100644 (file)
--- 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 c0a861f7ff1855663734b3e5110541f023538fbd..ccaa71a933d3d5b429a1e4252ff50c535d61d136 100644 (file)
--- 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 67767f18cacc17360fef8da9486ae9de97b59d1d..c469ae41dbfd34f53b0554d443a8b779018bb459 100644 (file)
--- 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