Fix formatting of go DESCR files. Some of the contents still leave a lot to be

desired.
This commit is contained in:
jperkin 2017-08-25 16:30:23 +00:00
parent c70530d870
commit 92e3e961e6
35 changed files with 164 additions and 71 deletions

View file

@ -2,4 +2,6 @@ Go client for etcd.
etcd now has an official Go client, which has a nicer API and better support.
We strongly suggest you use the official Go client instead of go-etcd in your new projects. For existing projects, we suggest you migrate to the official Go client.
We strongly suggest you use the official Go client instead of go-etcd in your
new projects. For existing projects, we suggest you migrate to the official Go
client.

View file

@ -1,7 +1,17 @@
Afero is an filesystem framework providing a simple, uniform and universal API interacting with any filesystem, as an abstraction layer providing interfaces, types and methods. Afero has an exceptionally clean interface and simple design without needless constructors or initialization methods.
Afero is an filesystem framework providing a simple, uniform and universal API
interacting with any filesystem, as an abstraction layer providing interfaces,
types and methods. Afero has an exceptionally clean interface and simple design
without needless constructors or initialization methods.
Afero is also a library providing a base set of interoperable backend filesystems that make it easy to work with afero while retaining all the power and benefit of the os and ioutil packages.
Afero is also a library providing a base set of interoperable backend
filesystems that make it easy to work with afero while retaining all the power
and benefit of the os and ioutil packages.
Afero provides significant improvements over using the os package alone, most notably the ability to create mock and testing filesystems without relying on the disk.
Afero provides significant improvements over using the os package alone, most
notably the ability to create mock and testing filesystems without relying on
the disk.
It is suitable for use in a any situation where you would consider using the OS package as it provides an additional abstraction that makes it easy to use a memory backed file system during testing. It also adds support for the http filesystem for full interoperability.
It is suitable for use in a any situation where you would consider using the OS
package as it provides an additional abstraction that makes it easy to use a
memory backed file system during testing. It also adds support for the http
filesystem for full interoperability.

View file

@ -1 +1,2 @@
Amber is an elegant templating engine for Go Programming Language It is inspired from HAML and Jade
Amber is an elegant templating engine for Go Programming Language. It is
inspired from HAML and Jade

View file

@ -1,5 +1,9 @@
Blackfriday is a Markdown processor implemented in Go. It is paranoid about its input (so you can safely feed it user-supplied data), it is fast, it supports common extensions (tables, smart punctuation substitutions, etc.), and it is safe for all utf-8 (unicode) input.
Blackfriday is a Markdown processor implemented in Go. It is paranoid about its
input (so you can safely feed it user-supplied data), it is fast, it supports
common extensions (tables, smart punctuation substitutions, etc.), and it is
safe for all utf-8 (unicode) input.
HTML output is currently supported, along with Smartypants extensions. An experimental LaTeX output engine is also included.
HTML output is currently supported, along with Smartypants extensions. An
experimental LaTeX output engine is also included.
It started as a translation from C of Sundown.

View file

@ -1 +1,2 @@
Buffruneio is a wrapper around bufio to provide buffered runes access with unlimited unreads.
Buffruneio is a wrapper around bufio to provide buffered runes access with
unlimited unreads.

View file

@ -1,3 +1 @@
Easy and safe casting from one type to another in Go
Dont Panic! ... Cast

View file

@ -1 +1,2 @@
Cobra is both a library for creating powerful modern CLI applications as well as a program to generate applications and command files.
Cobra is both a library for creating powerful modern CLI applications as well
as a program to generate applications and command files.

View file

@ -1,3 +1,4 @@
This package provides the consulapi package which attempts to provide programmatic access to the full Consul API.
This package provides the consulapi package which attempts to provide
programmatic access to the full Consul API.
Currently, all of the Consul APIs included in version 0.4 are supported.

View file

@ -6,4 +6,7 @@ if err != nil {
return err
}
which applied recursively up the call stack results in error reports without context or debugging information. The errors package allows programmers to add context to the failure path in their code in a way that does not destroy the original value of the error.
which applied recursively up the call stack results in error reports without
context or debugging information. The errors package allows programmers to add
context to the failure path in their code in a way that does not destroy the
original value of the error.

View file

@ -1,3 +1,6 @@
A fairly fast way to create a map from all the filenames to info objects for a given revision of a Git repo.
A fairly fast way to create a map from all the filenames to info objects for a
given revision of a Git repo.
This library uses os/exec to talk to Git. There are faster ways to do this by using some Go Git-lib or C bindings, but that adds dependencies I really don't want or need.
This library uses os/exec to talk to Git. There are faster ways to do this by
using some Go Git-lib or C bindings, but that adds dependencies I really don't
want or need.

View file

@ -1 +1,2 @@
This provides the lru package which implements a fixed-size thread safe LRU cache. It is based on the cache in Groupcache.
This provides the lru package which implements a fixed-size thread safe LRU
cache. It is based on the cache in Groupcache.

View file

@ -2,7 +2,10 @@ goorgeous is a Go Org to HTML Parser.
Pronounced: Go? Org? Yes!
"Org mode is for keeping notes, maintaining TODO lists, planning projects, and authoring documents with a fast and effective plain-text system."
"Org mode is for keeping notes, maintaining TODO lists, planning projects,
and authoring documents with a fast and effective plain-text system."
orgmode.org
The purpose of this package is to come as close as possible as parsing an *.org document into HTML, the same way one might publish with org-publish-html from Emacs.
The purpose of this package is to come as close as possible as parsing an
*.org document into HTML, the same way one might publish with org-publish-html
from Emacs.

View file

@ -1,5 +1,12 @@
This is a Go library for detecting the user's home directory without the use of cgo, so the library can be used in cross-compilation environments.
This is a Go library for detecting the user's home directory without the use of
cgo, so the library can be used in cross-compilation environments.
Usage is incredibly simple, just call homedir.Dir() to get the home directory for a user, and homedir.Expand() to expand the ~ in a path to the home directory.
Usage is incredibly simple, just call homedir.Dir() to get the home directory
for a user, and homedir.Expand() to expand the ~ in a path to the home
directory.
Why not just use os/user? The built-in os/user package requires cgo on Darwin systems. This means that any Go code that uses that package cannot cross compile. But 99% of the time the use for os/user is just to retrieve the home directory, which we can do for the current user without cgo. This library does that, enabling cross-compilation.
Why not just use os/user? The built-in os/user package requires cgo on Darwin
systems. This means that any Go code that uses that package cannot cross
compile. But 99% of the time the use for os/user is just to retrieve the home
directory, which we can do for the current user without cgo. This library does
that, enabling cross-compilation.

View file

@ -1,8 +1,9 @@
go-i18n is a Go package and a command that helps you translate Go programs into multiple languages.
Supports pluralized strings for all 200+ languages in the Unicode Common Locale Data Repository (CLDR).
Code and tests are automatically generated from CLDR data
Supports strings with named variables using text/template syntax.
Translation files are simple JSON, TOML or YAML.
Documented and tested!
go-i18n is a Go package and a command that helps you translate Go programs into
multiple languages.
* Supports pluralized strings for all 200+ languages in the Unicode Common
Locale Data Repository (CLDR).
* Code and tests are automatically generated from CLDR data
* Supports strings with named variables using text/template syntax.
* Translation files are simple JSON, TOML or YAML.
* Documented and tested!

View file

@ -1,11 +1,15 @@
Provides the iradix package that implements an immutable radix tree. The package only provides a single Tree implementation, optimized for sparse nodes.
Provides the iradix package that implements an immutable radix tree. The
package only provides a single Tree implementation, optimized for sparse nodes.
As a radix tree, it provides the following:
O(k) operations. In many cases, this can be faster than a hash table since the hash function is an O(k) operation, and hash tables have very poor cache locality.
Minimum / Maximum value lookups
Ordered iteration
* O(k) operations. In many cases, this can be faster than a hash table since
the hash function is an O(k) operation, and hash tables have very poor cache
locality.
* Minimum / Maximum value lookups
* Ordered iteration
A tree supports using a transaction to batch multiple updates (insert, delete) in a more efficient manner than performing each operation one at a time.
A tree supports using a transaction to batch multiple updates (insert, delete)
in a more efficient manner than performing each operation one at a time.
For a mutable variant, see go-radix.

View file

@ -1,19 +1,23 @@
jWalterWeatherman
Seamless printing to the terminal (stdout) and logging to a io.Writer (file) thats as easy to use as fmt.Println.
Seamless printing to the terminal (stdout) and logging to a io.Writer (file)
that's as easy to use as fmt.Println.
JWW is primarily a wrapper around the excellent standard log library. It provides a few advantages over using the standard log library alone.
JWW is primarily a wrapper around the excellent standard log library. It
provides a few advantages over using the standard log library alone.
1. Ready to go out of the box.
2. One library for both printing to the terminal and logging (to files).
3. Really easy to log to either a temp file or a file you specify.
I really wanted a very straightforward library that could seamlessly do the following things.
I really wanted a very straightforward library that could seamlessly do the
following things.
1. Replace all the println, printf, etc statements thought my code with something more useful
1. Replace all the println, printf, etc statements thought my code with
something more useful
2. Allow the user to easily control what levels are printed to stdout
3. Allow the user to easily control what levels are logged
4. Provide an easy mechanism (like fmt.Println) to print info to the user which can be easily logged as well
4. Provide an easy mechanism (like fmt.Println) to print info to the user
which can be easily logged as well
5. Due to 2 & 3 provide easy verbose mode for output and logs
6. Not have any unnecessary initialization cruft. Just use it.

View file

@ -1,3 +1,8 @@
mapstructure is a Go library for decoding generic map values to structures and vice versa, while providing helpful error handling.
mapstructure is a Go library for decoding generic map values to structures and
vice versa, while providing helpful error handling.
This library is most useful when decoding values from some data stream (JSON, Gob, etc.) where you don't quite know the structure of the underlying data until you read a part of it. You can therefore read a map[string]interface{} and use this library to decode it into the proper underlying native Go structure.
This library is most useful when decoding values from some data stream (JSON,
Gob, etc.) where you don't quite know the structure of the underlying data
until you read a part of it. You can therefore read a map[string]interface{}
and use this library to decode it into the proper underlying native Go
structure.

View file

@ -1 +1,3 @@
Nitro is a quick and easy performance analyzer library for golang. It is useful for comparing A/B against different drafts of functions or different functions.
Nitro is a quick and easy performance analyzer library for golang. It is
useful for comparing A/B against different drafts of functions or different
functions.

View file

@ -1,7 +1,11 @@
Extensions to the "os" package.
Find the current Executable and ExecutableFolder.
There is sometimes utility in finding the current executable file that is running. This can be used for upgrading the current executable or finding resources located relative to the executable file. Both working directory and the os.Args[0] value are arbitrary and cannot be relied on; os.Args[0] can be "faked".
There is sometimes utility in finding the current executable file that is
running. This can be used for upgrading the current executable or finding
resources located relative to the executable file. Both working directory and
the os.Args[0] value are arbitrary and cannot be relied on; os.Args[0] can be
"faked".
Multi-platform and supports:

View file

@ -1,5 +1,9 @@
pflag is a drop-in replacement for Go's flag package, implementing POSIX/GNU-style --flags.
pflag is a drop-in replacement for Go's flag package, implementing
POSIX/GNU-style --flags.
pflag is compatible with the GNU extensions to the POSIX recommendations for command-line options. For a more precise description, see the "Command-line flag syntax" section below.
pflag is compatible with the GNU extensions to the POSIX recommendations for
command-line options. For a more precise description, see the "Command-line
flag syntax" section below.
pflag is available under the same style of BSD license as the Go language, which can be found in the LICENSE file.
pflag is available under the same style of BSD license as the Go language,
which can be found in the LICENSE file.

View file

@ -1,11 +1,20 @@
properties is a Go library for reading and writing properties files.
It supports reading from multiple files or URLs and Spring style recursive property expansion of expressions like ${key} to their corresponding value. Value expressions can refer to other keys like in ${key} or to environment variables like in ${USER}. Filenames can also contain environment variables like in /home/${USER}/myapp.properties.
It supports reading from multiple files or URLs and Spring style recursive
property expansion of expressions like ${key} to their corresponding value.
Value expressions can refer to other keys like in ${key} or to environment
variables like in ${USER}. Filenames can also contain environment variables
like in /home/${USER}/myapp.properties.
Properties can be decoded into structs, maps, arrays and values through struct tags.
Properties can be decoded into structs, maps, arrays and values through struct
tags.
Comments and the order of keys are preserved. Comments can be modified and can be written to the output.
Comments and the order of keys are preserved. Comments can be modified and can
be written to the output.
The properties library supports both ISO-8859-1 and UTF-8 encoded data.
Starting from version 1.3.0 the behavior of the MustXXX() functions is configurable by providing a custom ErrorHandler function. The default has changed from panic to log.Fatal but this is configurable and custom error handling functions can be provided. See the package documentation for details.
Starting from version 1.3.0 the behavior of the MustXXX() functions is
configurable by providing a custom ErrorHandler function. The default has
changed from panic to log.Fatal but this is configurable and custom error
handling functions can be provided. See the package documentation for details.

View file

@ -1 +1,2 @@
Purell is a tiny Go library to normalize URLs. It returns a pure URL. Pure-ell. Sanitizer and all. Yeah, I know...
Purell is a tiny Go library to normalize URLs. It returns a pure URL. Pure-ell.
Sanitizer and all. Yeah, I know...

View file

@ -1,5 +1,7 @@
Package sanitized_anchor_name provides a func to create sanitized anchor names.
Its logic can be reused by multiple packages to create interoperable anchor names and links to those anchors.
Its logic can be reused by multiple packages to create interoperable anchor
names and links to those anchors.
At this time, it does not try to ensure that generated anchor names are unique, that responsibility falls on the caller.
At this time, it does not try to ensure that generated anchor names are unique,
that responsibility falls on the caller.

View file

@ -1 +1,2 @@
Package shuffle provides primitives for shuffling slices and user-defined collections.
Package shuffle provides primitives for shuffling slices and user-defined
collections.

View file

@ -1,5 +1,10 @@
HCL (HashiCorp Configuration Language) is a configuration language built by HashiCorp. The goal of HCL is to build a structured configuration language that is both human and machine friendly for use with command-line tools, but specifically targeted towards DevOps tools, servers, etc.
HCL (HashiCorp Configuration Language) is a configuration language built by
HashiCorp. The goal of HCL is to build a structured configuration language that
is both human and machine friendly for use with command-line tools, but
specifically targeted towards DevOps tools, servers, etc.
HCL is also fully JSON compatible. That is, JSON can be used as completely valid input to a system expecting HCL. This helps makes systems interoperable with other systems.
HCL is also fully JSON compatible. That is, JSON can be used as completely
valid input to a system expecting HCL. This helps makes systems interoperable
with other systems.
HCL is heavily inspired by libucl, nginx configuration, and others similar.

View file

@ -1,4 +1,3 @@
A statistics package with many functions missing from the Golang standard library. See the CHANGELOG.md for API changes and tagged releases you can vendor into your projects.
Statistics are used much like a drunk uses a lamppost: for support, not illumination. - Vin Scully
A statistics package with many functions missing from the Golang standard
library. See the CHANGELOG.md for API changes and tagged releases you can
vendor into your projects.

View file

@ -1 +1,2 @@
The Gorilla WebSocket package provides a complete and tested implementation of the WebSocket protocol. The package API is stable.
The Gorilla WebSocket package provides a complete and tested implementation of
the WebSocket protocol. The package API is stable.

View file

@ -1 +1,2 @@
The sftp package provides support for file system operations on remote ssh servers using the SFTP subsystem.
The sftp package provides support for file system operations on remote ssh
servers using the SFTP subsystem.

View file

@ -1,10 +1,10 @@
go-md2man
** Work in Progress ** This still needs a lot of help to be complete, or even usable!
** Work in Progress ** This still needs a lot of help to be complete, or even
usable!
Uses blackfriday to process markdown into man pages.
Usage
./md2man -in /path/to/markdownfile.md -out /manfile/output/path

View file

@ -1 +1,3 @@
Mmark is a powerful markdown processor Go geared towards writing IETF document.s It is, however, also suited for writing books and other technical documentation.
Mmark is a powerful markdown processor Go geared towards writing IETF
documents. It is, however, also suited for writing books and other technical
documentation.

View file

@ -1 +1,4 @@
prose is Go library for text (primarily English at the moment) processing that supports tokenization, part-of-speech tagging, named-entity extraction, and more. The library's functionality is split into subpackages designed for modular use. See the documentation for more information.
prose is Go library for text (primarily English at the moment) processing that
supports tokenization, part-of-speech tagging, named-entity extraction, and
more. The library's functionality is split into subpackages designed for
modular use. See the documentation for more information.

View file

@ -1 +1,2 @@
Ace is an HTML template engine for Go. This is inspired by Slim and Jade. This is a refinement of Gold.
Ace is an HTML template engine for Go. This is inspired by Slim and Jade. This
is a refinement of Gold.

View file

@ -1 +1,2 @@
GoHTML is an HTML formatter for Go. You can format HTML source codes by using this package.
GoHTML is an HTML formatter for Go. You can format HTML source codes by using
this package.

View file

@ -1 +1,5 @@
TOML stands for Tom's Obvious, Minimal Language. This Go package provides a reflection interface similar to Go's standard library json and xml packages. This package also supports the encoding.TextUnmarshaler and encoding.TextMarshaler interfaces so that you can define custom data representations.
TOML stands for Tom's Obvious, Minimal Language. This Go package provides a
reflection interface similar to Go's standard library json and xml packages.
This package also supports the encoding.TextUnmarshaler and
encoding.TextMarshaler interfaces so that you can define custom data
representations.

View file

@ -1 +1,5 @@
TOML stands for Tom's Obvious, Minimal Language. This Go package provides a reflection interface similar to Go's standard library json and xml packages. This package also supports the encoding.TextUnmarshaler and encoding.TextMarshaler interfaces so that you can define custom data representations.
TOML stands for Tom's Obvious, Minimal Language. This Go package provides a
reflection interface similar to Go's standard library json and xml packages.
This package also supports the encoding.TextUnmarshaler and
encoding.TextMarshaler interfaces so that you can define custom data
representations.