1
0
mirror of https://github.com/golang/go synced 2024-11-18 16:04:44 -07:00
The Go programming language
Go to file
Russ Cox 662ff54212 io: guarantee err == nil for full reads in ReadFull and ReadAtLeast
This is a backwards compatible API change that fixes broken code.

In Go 1.0, ReadFull(r, buf) could return either len(buf), nil or len(buf), non-nil.
Most code expects only the former, so do that and document the guarantee.

Code that was correct before is still correct.
Code that was incorrect before, by assuming the guarantee, is now correct too.

The same applies to ReadAtLeast.

Fixes #4544.

R=golang-dev, bradfitz, minux.ma
CC=golang-dev
https://golang.org/cl/7235074
2013-01-31 13:46:12 -08:00
api cmd/api: normalize byte to uint8 and rune to int32 2013-01-28 16:45:45 -08:00
doc doc/codewalk: gofmt pig.go 2013-01-31 13:42:26 -08:00
include include: Plan 9: hide any previous definition of Runemax 2013-01-30 07:56:08 -08:00
lib codereview: show 'not lgtms' in hg p output (with lgtms) 2013-01-29 09:32:49 -08:00
misc go/misc/dist: Keep file modes when copying. 2013-01-29 15:17:39 -08:00
src io: guarantee err == nil for full reads in ReadFull and ReadAtLeast 2013-01-31 13:46:12 -08:00
test cmd/gc: Error out on division by constant zero. 2013-01-30 20:21:08 +01:00
.hgignore build: update Makefile to track source code dependencies better 2012-03-13 03:31:11 +08:00
.hgtags tag go1.0.3 2012-09-24 13:15:33 -05:00
AUTHORS A+C: Robert Daniel Kortschak (individual CLA) 2013-01-30 17:53:07 -08:00
CONTRIBUTORS A+C: Robert Daniel Kortschak (individual CLA) 2013-01-30 17:53:07 -08:00
favicon.ico godoc: update favicon 2012-10-11 17:02:36 +11:00
LICENSE doc: update licensing text one more time 2012-03-27 15:09:13 +11:00
PATENTS LICENSE: separate, change PATENTS text 2010-12-06 16:31:59 -05:00
README build: update, streamline documentation for new $GOBIN 2010-08-24 20:00:50 -04:00
robots.txt godoc: serve robots.txt raw 2011-02-19 05:46:20 +11:00

This is the source code repository for the Go programming language.  

For documentation about how to install and use Go,
visit http://golang.org/ or load doc/install.html in your web browser.

After installing Go, you can view a nicely formatted
doc/install.html by running godoc --http=:6060
and then visiting http://localhost:6060/doc/install.html.

Unless otherwise noted, the Go source files are distributed
under the BSD-style license found in the LICENSE file.

--

Binary Distribution Notes

If you have just untarred a binary Go distribution, you need to set
the environment variable $GOROOT to the full path of the go
directory (the one containing this README).  You can omit the
variable if you unpack it into /usr/local/go, or if you rebuild
from sources by running all.bash (see doc/install.html).
You should also add the Go binary directory $GOROOT/bin
to your shell's path.

For example, if you extracted the tar file into $HOME/go, you might
put the following in your .profile:

    export GOROOT=$HOME/go
    export PATH=$PATH:$GOROOT/bin

See doc/install.html for more details.