all: fix up missing or malformatted package doc comments

blas/gonum/doc.go

@@ -5,7 +5,7 @@
 // Ensure changes made to blas/native are reflected in blas/cgo where relevant.
 
 /*
-Package native is a Go implementation of the BLAS API. This implementation
+Package gonum is a Go implementation of the BLAS API. This implementation
 panics when the input arguments are invalid as per the standard, for example
 if a vector increment is zero. Note that the treatment of NaN values
 is not specified, and differs among the BLAS implementations.

fourier/doc.go

@@ -2,5 +2,5 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
-// Package fourier provides functions to perform fourier transforms.
+// Package fourier provides functions to perform Discrete Fourier Transforms.
 package fourier // import "gonum.org/v1/gonum/fourier"

fourier/internal/fftpack/doc.go

@@ -0,0 +1,7 @@
+// Copyright ©2018 The Gonum Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+// Package fftpack implements Discrete Fourier Transform functions
+// ported from the Fortran implementation of FFTPACK.
+package fftpack // import "gonum.org/v1/gonum/fourier/internal/fftpack"

graph/formats/dot/internal/errors/doc.go

@@ -0,0 +1,6 @@
+// Copyright ©2018 The Gonum Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+// Package error provides generated internal error functions for DOT parsing.
+package errors // import "gonum.org/v1/gonum/graph/formats/dot/internal/errors"

graph/formats/dot/internal/lexer/doc.go

@@ -0,0 +1,6 @@
+// Copyright ©2018 The Gonum Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+// Package lexer provides generated internal lexer functions for DOT parsing.
+package lexer // import "gonum.org/v1/gonum/graph/formats/dot/internal/lexer"

graph/formats/dot/internal/parser/doc.go

@@ -0,0 +1,6 @@
+// Copyright ©2018 The Gonum Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+// Package parser provides generated internal parsing functions for DOT parsing.
+package parser // import "gonum.org/v1/gonum/graph/formats/dot/internal/parser"

graph/formats/dot/internal/token/doc.go

@@ -0,0 +1,6 @@
+// Copyright ©2018 The Gonum Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+// Package token provides generated internal tokenizing functions for DOT parsing.
+package token // import "gonum.org/v1/gonum/graph/formats/dot/internal/token"

graph/formats/dot/internal/util/doc.go

@@ -0,0 +1,6 @@
+// Copyright ©2018 The Gonum Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+// Package util provides generated internal utility functions for DOT parsing.
+package util // import "gonum.org/v1/gonum/graph/formats/dot/internal/util"

graph/path/internal/testgraphs/doc.go

@@ -0,0 +1,7 @@
+// Copyright ©2018 The Gonum Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+// Package testsgraphs provides a number of graphs used for testing
+// routines in the path and path/dynamic packages.
+package testgraphs // import "gonum.org/v1/gonum/graph/path/internal/testgraphs"

lapack/doc.go

@@ -0,0 +1,6 @@
+// Copyright ©2018 The Gonum Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+// Package lapack provides interfaces for the LAPACK linear algebra standard.
+package lapack // import "gonum.org/v1/gonum/lapack"

lapack/lapack.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.
 
-package lapack // import "gonum.org/v1/gonum/lapack"
+package lapack
 
 import "gonum.org/v1/gonum/blas"
 

mathext/internal/amos/doc.go

@@ -2,5 +2,5 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
-// package amos implements functions originally in the Netlab code by Donald Amos.
+// Package amos implements functions originally in the Netlib code by Donald Amos.
 package amos // import "gonum.org/v1/gonum/mathext/internal/amos"

mathext/internal/gonum/doc.go

@@ -2,6 +2,6 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
-// package gonum contains functions implemented by the gonum team. It is here to
+// Package gonum contains functions implemented by the gonum team.
-// avoid circular imports and/or double coding of functions.
+// It is here to avoid circular imports and/or double coding of functions.
 package gonum // import "gonum.org/v1/gonum/mathext/internal/gonum"