1
0
mirror of https://github.com/golang/go synced 2024-11-20 00:44:45 -07:00
The Go programming language
Go to file
Russ Cox d03611f628 allow copy of struct containing unexported fields
An experiment: allow structs to be copied even if they
contain unexported fields.  This gives packages the
ability to return opaque values in their APIs, like reflect
does for reflect.Value but without the kludgy hacks reflect
resorts to.

In general, we trust programmers not to do silly things
like *x = *y on a package's struct pointers, just as we trust
programmers not to do unicode.Letter = unicode.Digit,
but packages that want a harder guarantee can introduce
an extra level of indirection, like in the changes to os.File
in this CL or by using an interface type.

All in one CL so that it can be rolled back more easily if
we decide this is a bad idea.

Originally discussed in March 2011.
https://groups.google.com/group/golang-dev/t/3f5d30938c7c45ef

R=golang-dev, adg, dvyukov, r, bradfitz, jan.mercl, gri
CC=golang-dev
https://golang.org/cl/5372095
2011-11-15 12:20:59 -05:00
doc allow copy of struct containing unexported fields 2011-11-15 12:20:59 -05:00
include lib9: add ctime 2011-11-07 13:15:16 -05:00
lib codereview: show LGTMs in hg p 2011-10-19 15:08:33 -04:00
misc misc/notepadplus: error and rune support 2011-11-14 11:19:08 -08:00
src allow copy of struct containing unexported fields 2011-11-15 12:20:59 -05:00
test allow copy of struct containing unexported fields 2011-11-15 12:20:59 -05:00
.hgignore .hgignore: ignore src/pkg/exp/ebnflint/ebnflint 2011-10-26 22:22:33 +11:00
.hgtags fix .hgtags 2011-11-09 11:22:25 +11:00
AUTHORS A+C: Michał Derkacz (individual CLA) 2011-11-09 16:00:17 -05:00
CONTRIBUTORS A+C: Michał Derkacz (individual CLA) 2011-11-09 16:00:17 -05:00
favicon.ico add a favicon plus a couple of hi-res versions of gordon 2009-10-26 10:13:07 -07:00
LICENSE LICENSE: separate, change PATENTS text 2010-12-06 16:31:59 -05: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.