Updates #317

Fixes #318

On successful queries (on errors ReadAll runs in CheckResponse), the
Response.Body is not read all the way to the EOF as json.Decoder is used,
which stops at the end of the object, which is probably followed by a \n.

Then, Response.Body.Close() is called.  When that happens with a non-drained
Body, the TCP/TLS connection is closed (which makes sense, in case there was
still a lot to read from the network), stopping the Transport from reusing
it.  Also, a library user can't drain the Body themselves because Close() is
called before passing the Response to the user.

Since we know GitHub API responses only carry a single JSON object, draining
before closing is free, and saving all those handshakes causes huge savings
in latency, bandwidth and CPU for both the client and the poor GitHub
servers.

Here's the result of running the benchmark below on a ADSL connection:

    before: 2m3.001599093s
    after: 33.753543928s

    func main() {
    	ts := oauth2.StaticTokenSource(
    		&oauth2.Token{AccessToken: os.Getenv("GITHUB_TOKEN")},
    	)
    	tc := oauth2.NewClient(oauth2.NoContext, ts)
    	gh := github.NewClient(tc)
    	start := time.Now()
    	for i := 0; i < 100; i++ {
    		gh.Repositories.Get("FiloSottile", "gvt")
    		fmt.Print(".")
    	}
    	fmt.Printf("\n%s\n", time.Now().Sub(start))
    }

Fixes #215.

Change-Id: Ic17192cc0b1dbe02745e4c7f76bd81457f73141a

Fixes #191.

Change-Id: I2fbcca9913cd20df75e9b5a5272a50879025d526

The Migrations API is the GitHub equivalent of Google TakeOut.
It allows you to create an archive of one or more repositories
that you can download and later use for import purposes.

See: https://help.github.com/enterprise/2.4/admin/guides/migrations/exporting-the-github-com-organization-s-repositories/
for more information.

Fixes #292.

Change-Id: Id20624acb4f16a2aade9143e723c8eb85ec75402

If a redirect to AWS occurs, then the redirect will be canceled and
the redirect Location will be returned in redirectURL and the
io.ReadCloser will be nil. At this point, the user would need to
perform the http.Get with the redirectURL in a different http.Client
(without the GitHub authentication transport).

Note that this is a breaking API change.

Fixes #246.

Change-Id: I4fe2dfc9cd0ce81934a07f11a6296e71c7dd51a0

Fixes #306.

Change-Id: I3b42c946f8255e165c3bbd83b1566675d21fb0e8

Fixes #311.

Change-Id: I334b9e22e748d96a62b0c7f59690c1a998a3c802

Fixes #308.
Fixes #309.

Change-Id: I71d1422c90f32cc6e6834ed428a311a2b2b88778

Print defaults for multiples

Check if the default value supplied is a slice and not nil, if so
print the list of values supplied.
Test case for slice argument with and without default values.
Default values for slices was not printed because slice is not
comparable, but the zero value for slices is nil.

Change-Id: Ic6c776632587436d8b2a7810521f1a5ca1eae815

Additional fields (html_url, labels_url, id, closed_at) pulled from
https://developer.github.com/v3/issues/milestones/

Fixes #295

Fixes #297
Fixes #298

Change-Id: Ib17c43b368a0d0ee1a33690c17ad7c0f4dab55e5

Fixes #228
Fixes #301

Change-Id: I43d414332baa87b430487ea03d125633f8e40bd5

Change-Id: I385c22c290dd550c37ee7b3632a1a690cfaa36d7

Change-Id: I68a0d4fc72a4bd298298759ac70c0a2e8d83c00a

Defaults for multiples, intended behaviour

In V3 of the GitHub API, pull request comments are created in two ways. The
first way is to create a comment on a specific line of a file in a commit
with the following parameters:

| Name      | Type    | Description                                            |
|-----------|---------|--------------------------------------------------------|
| body      | string  | Required. The text of the comment                      |
| commit_id | string  | Required. The SHA of the commit to comment on.         |
| path      | string  | Required. The relative path of the file to comment on. |
| position  | integer | Required. The line index in the diff to comment on.    |

And the second way is through a reply to an existing comment with the following
parameters:

| Name        | Type    | Description                           |
|-------------|---------|---------------------------------------|
| body        | string  | Required. The text of the comment     |
| in_reply_to | integer | Required. The comment id to reply to. |

This commit adds support for the second (or "Alternative Input" according to
the GitHub docs) way.

This commit fixes a bug where if a multiple value argument (slice) has default
values, the submitted values will be appended to the default. Not
overriding them as expected.

make it possible to override the name of the program

Change-Id: Ia4888efa18c557a31af7093cfa449a67650afa20

Change-Id: I013dcbfb58ec10756c7b4e4bae6fe79b5e7c0062
Fixes #287

- simplify CLA text slightly
- clarify naming convention for .go files
- add "Maintainer's Guide" to document how I handle merging in
  contributions

fixes #283

Fixes #279.

Change-Id: I55ffdadfe5970d664ac94048e8bc2b8f5d935903

Fixes #152.

Add tests for RateLimitError.

Refactor populateRate into a more general parseRate.

Rate is now a method, not a field.

Mention RateLimits rather than RateLimit since the latter is deprecated.

Use Go convention for marking deprecated identifiers. See
257114af91.

fixes: #131,#271

fixes #274

fixes #272

Fixes #263.

Closes #265.