qbit/go
1
0
Fork 0
mirror of https://github.com/golang/go synced 2024-11-20 10:44:41 -07:00
Code Releases Activity
15,830 Commits 58 Branches 402 Tags 522 MiB
4aeb0fc0a4
Commit Graph

1604 Commits

Author SHA1 Message Date
Robert Griesemer
8c058b32d1 spec: clarify expression statements 
Function and method calls are valid expression statements,
but calling certain built-in functions is not permitted.
Enumerate the built-ins.

Also: unsafe.Offsetof permits parenthesized selectors as
arguments.

This is simply documenting existing compiler behavior
(both gc and gccgo agree).

R=r, rsc, iant, ken
CC=golang-dev
https://golang.org/cl/6498138
 2012-09-18 11:25:53 -07:00
Oling Cat
e93891f348 doc/effective_go: Closed some tags; removed extra spaces. 
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/6488122
 2012-09-18 08:50:24 -07:00
Andrew Gerrand
218f08a987 doc: document OS X tarballs 
R=golang-dev
CC=golang-dev
https://golang.org/cl/6506129
 2012-09-17 17:01:09 -07:00
Robert Griesemer
c7631f555f spec: unsafe.Alignof/Sizeof also accept non-variable arguments 
Both gc and gccgo permit calls such as unsafe.Sizeof(42). The
spec only permits variable arguments. This is a (backward-compatible)
spec change reflecting the status quo. Seems preferrable over
restricting the compilers.

R=r, rsc, iant, ken
CC=golang-dev
https://golang.org/cl/6494140
 2012-09-17 12:23:41 -07:00
Robert Griesemer
cc06593c68 spec: clarify section on string types 
Strings happen to be represented similarly to
byte slices internally, but they don't quite
behave like them: While strings can be indexed,
sliced, and have their len() taken like byte
slices, string elements are not addressable,
make() and cap() is not supported, range loops
operate differently, and they are immutable (and
thus behave like values rather then references).

Fixes #4018.

R=r, rsc, iant, ken
CC=golang-dev
https://golang.org/cl/6503116
 2012-09-14 11:31:56 -07:00
Rob Pike
f3fc0090f4 effective_go: use html/template instead of text/template 
Should have done this a long time ago.
Fixes #3811.

R=golang-dev, adg, rsc
CC=golang-dev
https://golang.org/cl/6488120
 2012-09-13 13:41:13 -07:00
Andrew Gerrand
e7d7ea21d4 undo CL 6493071 / 56c7453d488f 
This change messes with anchor links. It obscures the item being linked to.
I don't see a way around it. Undoing for now.

      Fixes #4071.

      ««« original CL description
      doc css: topbar sticks to the top of large windows.
      Rationale: for large screens, the convenience of not having to scroll
      to the top of the page to do a search outweighs having less vertical
      space.
      Tested with Chrome, Firefox, Safari with various window and text sizes.

      R=adg
      CC=gobot, golang-dev
      https://golang.org/cl/6493071

      Committer: Andrew Gerrand <adg@golang.org>
      »»»

R=golang-dev, r, dsymonds
CC=golang-dev
https://golang.org/cl/6488121
 2012-09-13 11:14:20 +10:00
Russ Cox
1b4e37a43c spec: make bitwise operators stand out 
The (and not) arguably sounds like it is trying to say something - and not what?.

Just an idea, won't be hurt if it gets rejected.

R=gri, dsymonds, r
CC=golang-dev
https://golang.org/cl/6498115
 2012-09-12 12:05:24 -04:00
Brian Slesinskya
56e1384aa0 doc css: topbar sticks to the top of large windows. 
Rationale: for large screens, the convenience of not having to scroll
to the top of the page to do a search outweighs having less vertical
space.
Tested with Chrome, Firefox, Safari with various window and text sizes.

R=adg
CC=gobot, golang-dev
https://golang.org/cl/6493071
 2012-09-11 11:38:47 +10:00
David Symonds
aecf5033df doc: Don't imply incorrect guarantees about data races. 
A race between
        a = "hello, world"
and
        print(a)
is not guaranteed to print either "hello, world" or "".
Its behaviour is undefined.

Fixes #4039.

R=rsc
CC=dvyukov, gobot, golang-dev, r
https://golang.org/cl/6489075
 2012-09-11 08:47:30 +10:00
Rob Pike
4be9b83eb6 faq: go does not have duck typing 
R=golang-dev, 0xjnml, iant, adonovan, aram
CC=golang-dev
https://golang.org/cl/6500092
 2012-09-07 14:01:02 -07:00
Rob Pike
91f2a34ddc faq: mercurial vs. git 
Fixes #4052.

R=golang-dev, bradfitz, iant, rsc
CC=golang-dev
https://golang.org/cl/6490092
 2012-09-07 11:19:01 -07:00
Rob Pike
488350ac42 spec: an initial BOM can be ignored 
After further deliberation, let's back down to the Unicode proposal.
Ignoring aBOMinations anywhere means that things like
        grep unsafe *.go
might fail because there's a BOM in the middle: unBOMsafe.

R=golang-dev, rsc, 0xjnml, gri, bradfitz
CC=golang-dev
https://golang.org/cl/6490091
 2012-09-07 10:28:24 -07:00
Rob Pike
0cab7d52d5 faq: another way to solve the closure/variable/range complaint 
It's easier just to declare a new variable.

R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/6501103
 2012-09-07 09:11:39 -07:00
Rob Pike
afac01df48 spec: ignore BOMS outside of string and rune literals. 
Happy Birthday UTF-8.

R=golang-dev, rsc, 0xjnml
CC=golang-dev
https://golang.org/cl/6506083
 2012-09-06 10:37:13 -07:00
Oling Cat
845f4d6b47 doc/go_spec: fix a typo 
R=nigeltao
CC=golang-dev
https://golang.org/cl/6499075
 2012-09-05 14:53:13 +10:00
Andrew Gerrand
d353d43d36 doc: fix typo in Concurrency Patterns article 
Fixes #3178.

R=golang-dev, iant
CC=golang-dev
https://golang.org/cl/6506064
 2012-09-04 15:28:09 +10:00
Andrew Gerrand
997a11ae6a doc: link to references from docs page 
Fixes #3667.

R=golang-dev, iant
CC=golang-dev
https://golang.org/cl/6492078
 2012-09-04 15:26:51 +10:00
Shenghou Ma
5b7562dd6f doc/progs: use test/run.go for testing on Windows 
cgo[1-4].go, go1.go couldn't be tested now
(cgo[1-4].go can only be tested when cgo is enabled, go1.go
contain a list of filenames in the current directory)

R=golang-dev, alex.brainman, rsc
CC=golang-dev
https://golang.org/cl/6218048
 2012-09-03 03:49:03 +08:00
Rob Pike
9dfc6f6427 go_spec.html: clarify rune and string literals 
No changes to the meaning, just clearer language and more
examples, including illegal rune and string literals.
In particular, "character literal" and "character constant"
are now called "rune literal" and "rune constant" and the
word "character" always refers to the source text, not
program values.

R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/6448137
 2012-08-29 14:46:57 -07:00
Shenghou Ma
2701046798 doc/install: we only need command line tools for Xcode on OS X 
Fixes #3973.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/6464078
 2012-08-20 21:21:09 +08:00
Robert Griesemer
95a00cae2e go_spec: unary + and - are also defined for complex types 
R=r, rsc, iant, ken, iant
CC=golang-dev
https://golang.org/cl/6450150
 2012-08-17 11:36:21 -07:00
Robert Griesemer
f05a91e18b spec: clarify evaluation order 
Fixes #3852.

R=r, rsc, iant, ken
CC=golang-dev
https://golang.org/cl/6441102
 2012-08-09 11:50:16 -07:00
Andrew Gerrand
0bc952c8cc doc: add 'Get Started with Go' video, remove some older videos 
(I also updated the wiki's GoTalks page with all the latest videos.)

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/6441113
 2012-08-09 08:50:13 +10:00
Shenghou Ma
edc7b4739d doc: fix some HTML syntax errors 
R=adg
CC=golang-dev
https://golang.org/cl/6458043
 2012-08-07 11:12:54 +08:00
Andrew Gerrand
67d8a2d4c1 doc: remove mention of weekly tag from source install doc 
R=golang-dev, dsymonds, bradfitz
CC=golang-dev
https://golang.org/cl/6442062
 2012-07-30 15:36:56 +10:00
Andrew Gerrand
4087c1b842 doc: add two I/O talks to "Talks" section 
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/6422056
 2012-07-22 16:35:53 -07:00
Rob Pike
8de5080f34 faq: add status section 
Fixes #3822.

R=golang-dev, r, dsymonds, minux.ma, adg
CC=golang-dev
https://golang.org/cl/6395043
 2012-07-16 13:31:15 -07:00
Rémy Oudompheng
2b4cc6ccb5 spec: correct typo in string conversion examples. 
R=golang-dev, dave, r
CC=golang-dev, remy
https://golang.org/cl/6378046
 2012-07-11 20:26:51 +02:00
Dave Cheney
82cbcb0dd5 website: various html fixes 
Fixes #3424.

R=fullung, adg
CC=golang-dev
https://golang.org/cl/6343088
 2012-07-11 09:41:08 -07:00
Matthew William Jibson
f83a47cbb9 doc: various "the the" and other typos 
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/6355076
 2012-07-08 11:57:04 +10:00
Shenghou Ma
d9c4cef670 doc/debugging_with_gdb: mention how to disable gc optimization 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/6353055
 2012-07-03 12:50:03 -04:00
Robert Griesemer
71de83b733 go spec: clean up section on selectors 
- point out difference between selectors and qualified identifiers
- differentiate between illegal selectors and run-time panics
- use "indirect" as opposed to "dereference" consistently
- add extra links

Fixes #3779.

R=r, rsc, iant, ken
CC=golang-dev
https://golang.org/cl/6326059
 2012-06-28 12:22:24 -07:00
Robert Griesemer
809e06babc go spec: clean up use of QualifiedIdent production. 
Fixes #3763.

R=r, rsc, iant, ken
CC=golang-dev
https://golang.org/cl/6333066
 2012-06-26 11:49:19 -07:00
Andrew Gerrand
c42a1d4906 doc: drop video title from homepage 
It's just stutter.

R=golang-dev, dsymonds, r
CC=golang-dev
https://golang.org/cl/6334053
 2012-06-25 14:54:26 -07:00
Robert Griesemer
689931c5b0 spec: clarify receive operator 
- receiving from a closed channel returns immediately
- in the ,ok form, the 2nd result is of type bool, not
  just boolean (gc and ggcgo agree).

Per dsymonds' suggestion.

R=r, rsc, ken, iant, dsymonds
CC=golang-dev
https://golang.org/cl/6333057
 2012-06-25 11:28:24 -07:00
Andrew Gerrand
dd6db9b7ba doc: put A Tour of Go video on the front page 
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/6337047
 2012-06-22 10:22:01 -07:00
Shenghou Ma
5d2cfc2faa doc/articles/slices_usage_and_internals: fix typo 
Fixes #3753.

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/6304097
 2012-06-20 01:22:03 +08:00
Shenghou Ma
18b281978c doc: delete Mercurial Queues doc 
Fixes #3716.

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/6310044
 2012-06-16 02:24:44 +08:00
Andrew Gerrand
00e8a3ae91 doc: document go1.0.2 
R=golang-dev, dave, rsc
CC=golang-dev
https://golang.org/cl/6298079
 2012-06-14 11:44:00 +10:00
Andrew Gerrand
9115a8bca4 doc/install: mention GOPATH and point to code.html 
Fixes #3469.

R=golang-dev, kevlar, rsc, r
CC=golang-dev
https://golang.org/cl/6304049
 2012-06-13 10:33:02 +10:00
Robert Griesemer
787adb6eb3 go spec: clarify promotion rules for methods/fields of anonymous fields 
Fixes #3635.

R=rsc, r, iant, kevlar, iant
CC=golang-dev
https://golang.org/cl/6217045
 2012-06-04 14:24:10 -07:00
Joel Sing
5131deeeb2 cgo: enable cgo on netbsd/386 and netbsd/amd64 
R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/6261056
 2012-06-05 01:43:04 +10:00
Andrew Gerrand
3238705f0c doc: mention 'hg update default' in contribution guidelines 
Fixes #3634.

R=golang-dev, bsiegert, rsc
CC=golang-dev
https://golang.org/cl/6270047
 2012-06-05 00:55:45 +10:00
Russ Cox
9723de5d8b doc/install: we don't print 'The compiler is 6g' anymore 
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/6273050
 2012-06-04 10:41:30 -04:00
Robert Griesemer
2dde4f5d29 spec: clarify evaluation order of "i, x[i] = range ..." 
Part of fix for issue 3464.

R=golang-dev, rsc, mirtchovski, iant, r
CC=golang-dev
https://golang.org/cl/6246045
 2012-05-24 10:59:48 -07:00
Shenghou Ma
ab708e3578 doc/install: document minimum system requirements 
Partly copied from CL 5685076.

R=golang-dev, adg, r
CC=golang-dev
https://golang.org/cl/6112064
 2012-05-16 14:54:48 +10:00
David Symonds
9ce770afad old/regexp, old/template: delete. 
Both of these have replacements.

R=golang-dev, r, rsc, r, adg
CC=golang-dev
https://golang.org/cl/5979046
 2012-04-27 15:12:24 +10:00
Andrew Gerrand
314df5226a doc: go1.0.1 release notes 
R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/6123055
 2012-04-26 12:02:06 -07:00
David Symonds
4d3db77c69 doc: update wiki article to use html/template properly. 
Fixes #3569.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/6116055
 2012-04-26 17:50:44 +10:00
Nigel Tao
b28431ec8e doc: simplify the image_draw article example for converting an image to 
RGBA.

R=adg, r, bsiegert
CC=golang-dev
https://golang.org/cl/6119054
 2012-04-26 17:39:04 +10:00
Andrew Gerrand
f8dde60e2b doc: don't wrap package names in directory listing 
Fixes #3522.

R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/6063054
 2012-04-20 10:04:13 -04:00
Benny Siegert
e03dd509d4 doc/articles/image_draw.html: Change ColorImage to Uniform 
Fixes #3474.

R=nigeltao
CC=golang-dev
https://golang.org/cl/6048050
 2012-04-19 11:04:42 +10:00
Shenghou Ma
50d5cf6bc9 doc/code: mention $GOBIN 
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/5989045
 2012-04-17 02:41:27 +10:00
Andrew Gerrand
0e596024c2 doc: update Mercurial installation instructions 
R=r
CC=golang-dev
https://golang.org/cl/6031046
 2012-04-14 13:27:11 +10:00
Jongmin Kim
08f919f462 doc/effective_go.html: fixed the Request channel parameter 
R=golang-dev, r
CC=golang-dev, gri
https://golang.org/cl/6010051
 2012-04-13 15:22:40 +10:00
Dave Cheney
d7bc644ba2 doc: fix minor typo in Go 1 release notes 
Fixes #3478.

R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/5986074
 2012-04-11 10:59:03 +10:00
Shenghou Ma
25e02d519d doc/code: update newmath.Sqrt test case to make sure test succeed 
Fixes #3445.

R=golang-dev, rsc, mtj
CC=golang-dev
https://golang.org/cl/5975061
 2012-04-10 01:55:51 +08:00
Shenghou Ma
9bc8dd3985 doc/go_spec: fix a typo 
R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/5989065
 2012-04-10 01:50:46 +08:00
Hong Ruiqi
8374e67876 doc/go_spec: fix typo 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/5990043
 2012-04-05 22:37:07 +10:00
Andrew Gerrand
b16ec46c2f doc: shorten project dashboard link 
Fixes #3420.
(which was already fixed)

R=golang-dev, bradfitz, dsymonds
CC=golang-dev
https://golang.org/cl/5987043
 2012-04-05 11:17:18 +10:00
Andrew Gerrand
f1a39ff003 doc: sync playground.js 
R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/5956043
 2012-04-03 08:10:21 +10:00
Peter Weinberger
a978ead6e1 doc/code.html: change 'affect' to 'effect'. 
Fixes #3429.

R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/5966047
 2012-04-02 13:05:09 -04:00
Aaron Kemp
cb871ce3e0 doc/effective_go.html: Add missing '...' for fmt.Sprintf() 
The '...' was missing on a call to fmt.Sprintf() which would result in
the slice being printed instead of the correct result.

R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/5967051
 2012-03-30 17:51:24 -07:00
Shenghou Ma
c24daa222f doc/codewalk/markov: fix syntax and broken link 
Part of issue 3424.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5955050
 2012-03-30 15:00:23 +08:00
Shenghou Ma
2a3dbb01d7 doc/code.html: fix broken dashboard link 
Fixes #3420.
        Part of issue 3424.

R=golang-dev, cldorian, adg, r
CC=golang-dev
https://golang.org/cl/5958046
 2012-03-30 14:07:40 +08:00
Shenghou Ma
c80a32b581 doc/go1: minor fixes 
Fixes #3427.
        Part of issue 3424.

R=golang-dev, bradfitz, r
CC=golang-dev
https://golang.org/cl/5959045
 2012-03-30 14:06:12 +08:00
Shenghou Ma
2195f1aa04 doc/go_spec: fix broken link 
Part of issue 3424

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5955049
 2012-03-30 14:04:03 +08:00
Andrew Gerrand
3895b5051d weekly.2012-03-27 2012-03-28 23:41:03 +11:00
Francisco Souza
18f1a71dc2 doc: added The Go image package article 
Orignally published on The Go Programming Language, September 21, 2011.

http://blog.golang.org/2011/09/go-image-package.html

Update #2547

R=adg, nigeltao
CC=golang-dev
https://golang.org/cl/5933049
 2012-03-28 14:20:51 +11:00
Russ Cox
9d7076b178 cmd/go: respect $GOBIN always 
Another attempt at https://golang.org/cl/5754088.

Before, we only consulted $GOBIN for source code
found in $GOROOT, but that's confusing to explain
and less useful.  The new behavior lets users set
GOBIN=$HOME/bin and have all go-compiled binaries
installed there.

Tested a few cases in test.bash.

Ran all.bash with and without $GOBIN and it works.
Even so, I expect it to break the builders,
like it did last time, we can debug from there.

Fixes #3269 (again).
Fixes #3396.
Fixes #3397.

R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/5927051
 2012-03-27 11:57:39 -04:00
Andrew Gerrand
14da5298cd doc: use relative links in Laws of Reflection article 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5924050
 2012-03-27 20:53:16 +11:00
Andrew Gerrand
cafc2b6a24 doc: use relative links in draw package article 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5924051
 2012-03-27 20:52:48 +11:00
Andrew Gerrand
d98507f1c4 doc: update wiki tutorial templates, and template discussion 
Fixes #3384.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5915044
 2012-03-27 16:07:46 +11:00
Francisco Souza
603a44c50f doc: fix concurrency patterns rawhtml generation 
The Makefile target was broken due to the rename of the HTML file.

R=golang-dev
CC=golang-dev
https://golang.org/cl/5918045
 2012-03-27 14:03:46 +11:00
Andrew Gerrand
8d5b324afc doc: move /ref/cmd to /doc/cmd 
Fixes #3400.

R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/5926043
 2012-03-27 13:46:16 +11:00
Francisco Souza
a786fe8e13 doc: add JSON-RPC: a tale of interfaces article 
Originally published on The Go Programming Language Blog, Abril 27, 2010.

http://blog.golang.org/2010/04/json-rpc-tale-of-interfaces.html

R=adg, r
CC=golang-dev
https://golang.org/cl/5920044
 2012-03-27 13:35:40 +11:00
Andrew Gerrand
9031f952e2 doc: remove cov and prof from /ref/cmd 
Update #3400

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5921044
 2012-03-27 12:46:46 +11:00
Andrew Gerrand
98155bd6a9 doc: move gdb doc back to /doc/ and de-emphasize on references page 
Fixes #3399.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5919044
 2012-03-27 11:42:01 +11:00
Andrew Gerrand
11441285db doc: add doc/articles/index.html 
Fixes #3402.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5923043
 2012-03-27 11:40:17 +11:00
Andrew Gerrand
1b89d514d7 doc: describe the Windows MSI installer as experimental 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5921043
 2012-03-27 11:19:30 +11:00
Andrew Gerrand
d2991229bc doc: add Terms of Service 
R=r
CC=golang-dev
https://golang.org/cl/5913044
 2012-03-27 09:27:43 +11:00
Benny Siegert
f4ec146454 doc: Change id of footer 
The heading "Copyright" uses id="copyright" as the anchor name.
However, there is also a <div id="copyright"> at the bottom.
Using the same ID value twice in the same file is illegal
(http://www.w3.org/TR/html401/struct/links.html#h-12.2.3).

R=golang-dev, bradfitz, rsc
CC=golang-dev
https://golang.org/cl/5909045
 2012-03-26 09:12:15 -07:00
Andrew Gerrand
0b762d9523 godoc: make 'Overview' section collapsable 
This makes packages with lengthly package comments easier to browse.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5901055
 2012-03-26 14:10:27 +11:00
Andrew Gerrand
ce06e15e2a doc: make installation instructions more skim-friendly 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5908052
 2012-03-26 13:59:30 +11:00
Rob Pike
7b8f8bf5b5 doc/reference-cmd: use vet as example, not fmt 
"go tool fmt" doesn't work, "go tool vet" does.

R=golang-dev, rogpeppe, r, minux.ma, bradfitz
CC=golang-dev
https://golang.org/cl/5900049
 2012-03-25 11:35:16 +11:00
Rob Pike
4074795e15 effective_go: cleanups and fixes 
Also explain the situation with recursive String methods more accurately,
and clean up the code now that the fmt package is more careful.

R=golang-dev, minux.ma, bradfitz
CC=golang-dev
https://golang.org/cl/5907047
 2012-03-25 11:34:51 +11:00
Rob Pike
73b5eb38c1 docs/articles/wiki: minor fixes 
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/5900046
 2012-03-24 10:14:25 +11:00
Rob Pike
c5f695e863 doc/go1: add mention of packaged releases 
Fixes #3245.

R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/5905045
 2012-03-24 10:14:07 +11:00
Rob Pike
b73046407f doc/reference-cmd.html: new introduction 
Compare and explain go, go cmd, and go tool cmd.
The situation is not concisely explained elsewhere in the main docs.

R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/5906043
 2012-03-24 09:29:08 +11:00
Rob Pike
ae8d8abfeb codewalk/sharemem.xml: fix references to files 
R=golang-dev, iant
CC=golang-dev
https://golang.org/cl/5877064
 2012-03-24 08:12:52 +11:00
Shenghou Ma
54a2e63a60 doc/reference-cmd: doc/fmt can be invoked by cmd/go but also available as independent command 
R=golang-dev, iant, r
CC=golang-dev
https://golang.org/cl/5877050
 2012-03-23 23:21:52 +08:00
Rob Pike
76cf6bac07 doc/articles/defer_panic_recover.html: minor tweaks 
Delete () from function names and change the reference to some
functions to the correct term, methods.

R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/5874063
 2012-03-23 17:40:27 +11:00
Rob Pike
fc9f65a6a0 doc/articles/image_draw.html: fix circle example 
It was showing the same snippet twice instead of the type definition and snippet.

R=golang-dev, iant
CC=golang-dev
https://golang.org/cl/5875045
 2012-03-23 17:02:21 +11:00
Yasuhiro Matsumoto
782feeb765 doc/godoc.js: fix error on IE8. 
* implement simple getElementsByClassName for IE8.
        * remove some lint warnings.

Fixes #3318.

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/5881054
 2012-03-23 12:23:53 +11:00
Andrew Gerrand
145c48c1d1 weekly.2012-03-22 
R=golang-dev, r, dave
CC=golang-dev
https://golang.org/cl/5876068
 2012-03-23 11:56:54 +11:00
Ian Lance Taylor
5ac186975c doc/articles/c_go_cgo.html: correct "C" comment to mention #cgo 
Also fix invalid apostrophe characters.

R=r, gri, adg
CC=golang-dev
https://golang.org/cl/5874058
 2012-03-22 17:44:28 -07:00
Rob Pike
a99e9c5db5 doc/articles: rename concurrency patterns article 
The old name, automatically generated, was ludicrously verbose.
Also clean up an example to use time.Second.

R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/5876051
 2012-03-23 07:51:16 +11:00
Rob Pike
2795a15c0c doc/articles/gobs_of_data.html: delete extra word 
Putt putt putt our way towards felicity.

R=golang-dev, bsiegert
CC=golang-dev
https://golang.org/cl/5874048
 2012-03-22 19:20:03 +11:00
Francisco Souza
289a357104 doc: add JSON and Go article 
Originally published on The Go Programming Language Blog, January 25, 2011.

http://blog.golang.org/2011/01/json-and-go.html

R=adg
CC=golang-dev
https://golang.org/cl/5846044
 2012-03-22 18:25:40 +11:00
Rob Pike
cec67568e9 doc/articles/go_command.html: nits 
Fix some English mistakes and minor inaccuracies.

R=golang-dev, jsing
CC=golang-dev
https://golang.org/cl/5885046
 2012-03-22 17:59:06 +11:00
Francisco Souza
2b3d6cb5e6 doc: fix typo in The Laws of Reflection article 
R=golang-dev, gri, r
CC=golang-dev
https://golang.org/cl/5876047
 2012-03-21 16:42:04 -07:00
Robert Griesemer
b8b308d184 doc/effective_go.html: undo local font change 
R=r
CC=golang-dev
https://golang.org/cl/5876043
 2012-03-21 14:29:16 -07:00
Shenghou Ma
0532f4d382 doc/effective_go: minor corrections 
R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/5848063
 2012-03-21 09:33:55 -07:00
Brad Fitzpatrick
e5102b35f6 doc: remove reference to deleted os.ENOSPC 
R=golang-dev, gri, r, r
CC=golang-dev
https://golang.org/cl/5866046
 2012-03-20 16:50:51 -07:00
Ian Lance Taylor
a84e3baf9a doc: general update of gccgo_install 
Fixes #3325.

R=golang-dev, bradfitz, minux.ma, r
CC=golang-dev
https://golang.org/cl/5858043
 2012-03-20 14:16:34 -07:00
Shenghou Ma
9dbfda5857 doc/debugging_with_gdb: format & content update 
R=adg, lvd
CC=golang-dev
https://golang.org/cl/5845065
 2012-03-21 00:42:53 +08:00
Andrew Gerrand
abdb4dbe2c cmd/godoc: inform users that the playground doesn't work via local godoc 
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/5843065
 2012-03-20 14:11:38 +11:00
Andrew Gerrand
58aac1d0ff doc: remove defunct playground.html 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/5846071
 2012-03-20 14:11:17 +11:00
Andrew Gerrand
2a5879d1e2 doc: replace mentions of 6g with gc or the go command 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5846070
 2012-03-20 13:50:05 +11:00
Shenghou Ma
d05b386928 doc: update format for "C? Go? Cgo!" article 
R=adg
CC=golang-dev
https://golang.org/cl/5841050
 2012-03-19 22:54:06 +08:00
Andrew Gerrand
6230569e84 doc: move sub-repos lower on reference page 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5846065
 2012-03-19 13:52:26 +11:00
Jeremy Jackins
7e054266c9 doc: various typos, remove apostrophes from ordinals 
R=golang-dev, r, r
CC=golang-dev
https://golang.org/cl/5845059
 2012-03-19 08:26:36 +11:00
Rob Pike
883a96d950 spec: delete references to unsafe.Reflect,Typeof,Unreflect 
They have been deleted from package unsafe.
Also delete their appearance in exp/types.

Fixes #3338.

R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/5847056
 2012-03-17 22:50:59 +11:00
Shenghou Ma
1dd78b7e7b doc/install: remove reference to "Go Tutorial" 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5841054
 2012-03-17 18:13:02 +08:00
Shenghou Ma
c3eaef71ab doc/go_faq: minor update 
R=adg, r
CC=golang-dev
https://golang.org/cl/5849052
 2012-03-17 15:53:40 +08:00
David Symonds
e5cc09a75d doc: use time.Duration in Effective Go. 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5841044
 2012-03-16 14:27:11 +11:00
Francisco Souza
9e03dcb3fa doc: add Gobs of data article 
Originally published on The Go Programming Language Blog, March 24, 2011.

http://blog.golang.org/2011/03/gobs-of-data.html

R=adg
CC=golang-dev
https://golang.org/cl/5834043
 2012-03-16 08:21:13 +11:00
Stefan Nilsson
ed77d6f04d doc: add missing quotation mark 
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/5833047
 2012-03-15 14:06:15 -04:00
Yasuhiro Matsumoto
aec01c3627 doc/play: use []rune insetead of []int. 
R=golang-dev
CC=golang-dev
https://golang.org/cl/5823058
 2012-03-15 19:28:07 +11:00
Andrew Gerrand
d528f52d87 cmd/godoc: add toys, tour button to playground 
Fixes #3241.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5835043
 2012-03-15 17:44:47 +11:00
Francisco Souza
235863cb12 doc: add "Godoc: documenting Go code" article 
Originally published on The Go Programming Language Blog, March 31, 2011.

http://blog.golang.org/2011/03/godoc-documenting-go-code.html

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/5830043
 2012-03-15 14:51:44 +11:00
Stefan Nilsson
f00872527b doc: add reference to FAQ to explain warning about concrete type 
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/5820048
 2012-03-15 09:15:16 +11:00
Andrew Gerrand
9d08068d21 godoc: style example headings like links 
R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/5819048
 2012-03-15 08:09:54 +11:00
Francisco Souza
5659826e43 doc: add Go Concurrency Patterns: Timing out, moving on article 
Originally published on The Go Programming Language Blog, September 23, 2010.

http://blog.golang.org/2010/09/go-concurrency-patterns-timing-out-and.html

Update #2547.

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/5815044
 2012-03-14 13:03:11 +11:00
Johan Euphrosine
fef92cbbac doc: add Go image/draw package article and convert code snippets to Go1. 
Originally published on The Go Programming Language Blog, September 29, 2011.

http://blog.golang.org/2011/09/go-imagedraw-package.html

Update #2547.

R=golang-dev, adg, rsc
CC=golang-dev
https://golang.org/cl/5755057
 2012-03-14 11:27:41 +11:00
Andrew Gerrand
9ef03fdf77 weekly.2012-03-13 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/5754097
 2012-03-13 16:39:52 +11:00
Andrew Gerrand
f4bf4c3b2f doc: update weekly notes, untag weekly 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/5783093
 2012-03-13 16:32:23 +11:00
Andrew Gerrand
f0aeac1ac8 weekly.2012-03-12 
R=golang-dev, nigeltao, bradfitz
CC=golang-dev
https://golang.org/cl/5783077
 2012-03-13 15:09:51 +11:00
Andrew Gerrand
c9f1f56143 doc: increase h3 size 
This makes h3 and h4 more distinct, and h2 and h3 the same size.
The h2 and h3 styles may be distinguished h2's background styles.

This means that almost all text on the site is either 16px, 20px,
or 24px. (with a smattering of 14px)

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5754095
 2012-03-13 15:02:36 +11:00
Andrew Gerrand
cf46040784 doc: windows zip archive installation instructions 
Fixes #3254.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5794071
 2012-03-13 15:02:14 +11:00
Francisco Souza
6033a48b77 doc: add Go's declaration syntax article 
Originally published on The Go Programming Language Blog, July 7, 2010.

I did not put any go file in doc/progs. Shoul I include Go files
with those declarations?

http://blog.golang.org/2010/07/gos-declaration-syntax.html

Update #2547.

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/5795068
 2012-03-13 14:46:08 +11:00
Robert Griesemer
82fc28c0f5 go spec: fix inaccuracy in type identity definition 
Pointed out by Steven Blenkinsop (steven099@gmail.com)
via golang-nuts.

R=r, dsymonds
CC=golang-dev
https://golang.org/cl/5783087
 2012-03-12 20:27:27 -07:00
Andrew Gerrand
881907730f doc: update reference gopher 
R=golang-dev
CC=golang-dev
https://golang.org/cl/5754094
 2012-03-13 13:43:41 +11:00
Francisco Souza
170301d44b godoc: added alt and title attributes to the "pop out" button 
R=adg
CC=golang-dev
https://golang.org/cl/5777071
 2012-03-13 12:57:48 +11:00
Andrew Gerrand
d2d7de974c doc/progs: skip cgo1 and cgo2 on freebsd 
FreeBSD's srandom has a different signature to darwin/linux.

R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/5795067
 2012-03-13 11:55:16 +11:00
Andrew Gerrand
e8636a64a2 godoc: change link styles, add 'pop out' button 
Remove underlines from all links, show underline on link hover.
Change all non-link headings to h4, a slight visual cue.

R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/5783088
 2012-03-13 11:00:11 +11:00
Andrew Gerrand
2b8bc93f32 godoc: use elastic layout for most pages 
We use the absence of a Title to detect the front page.
I can't find other pages without titles, so this seems reasonable.

R=golang-dev, bradfitz, gri
CC=golang-dev
https://golang.org/cl/5797076
 2012-03-13 10:17:10 +11:00
Francisco Souza
60b98d6208 doc: add C? Go? Cgo! article 
Originally published on The Go Programming Language Blog, March 17, 2011.

http://blog.golang.org/2011/03/c-go-cgo.html

Update #2547.

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/5777054
 2012-03-13 09:07:37 +11:00
Russ Cox
bf09a8c970 undo CL 5754088 / cae9a7c0db06 
broke builders

««« original CL description
cmd/go: respect $GOBIN always

Before, we only consulted $GOBIN for source code
found in $GOROOT, but that's confusing to explain
and less useful.  The new behavior lets users set
GOBIN=$HOME/bin and have all go-compiled binaries
installed there.

Fixes #3269.

R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/5754088
»»»

TBR=bradfitz
CC=golang-dev
https://golang.org/cl/5794065
 2012-03-12 17:03:29 -04:00
Russ Cox
bccafa7210 cmd/go: respect $GOBIN always 
Before, we only consulted $GOBIN for source code
found in $GOROOT, but that's confusing to explain
and less useful.  The new behavior lets users set
GOBIN=$HOME/bin and have all go-compiled binaries
installed there.

Fixes #3269.

R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/5754088
 2012-03-12 16:49:12 -04:00
Jeremy Jackins
959d0c7ac0 doc: fix typo in contribute.html 
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/5795050
 2012-03-10 15:13:34 -08:00
Russ Cox
a40065ac68 cmd/godoc: add support for serving templates 
doc: convert to use godoc built-in templates

tmpltohtml is gone, to avoid having a second copy of the code.
Instead, godoc -url /doc/go1.html will print the actual HTML
served for that URL.  "make" will generate files named go1.rawhtml
etc, which can be fed through tidy.

It can be hard to tell from the codereview diffs, but all the
tmpl files have been renamed to be html files and then
have "Template": true added.

R=golang-dev, adg, r, gri
CC=golang-dev
https://golang.org/cl/5782046
 2012-03-08 08:39:20 -05:00
Andrew Gerrand
5ca13f6378 doc: fix metadata in go_mem.html 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/5781053
 2012-03-08 22:50:05 +11:00
Andrew Gerrand
b6618c118f doc: drop google +1 button from the home page 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5784048
 2012-03-08 17:31:20 +11:00
Robert Griesemer
11d8b155ce go_spec: no known implementation differences anymore 
R=r, rsc, iant, ken
CC=golang-dev
https://golang.org/cl/5781048
 2012-03-07 22:17:40 -08:00
Rob Pike
1cd272d16a doc/go1: template packages have changed since r60 
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/5787049
 2012-03-08 17:15:23 +11:00
Andrew Gerrand
c9836be112 doc: link to go1 and go1compat from docs index 
Fixes #3239.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5782049
 2012-03-08 16:10:55 +11:00
Andrew Gerrand
70db237169 doc: add go command notes to the Go 1 doc 
Fixes #2912.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5783048
 2012-03-08 16:09:49 +11:00
Andrew Gerrand
94f233574b doc: pngcrush and remove old, unused images 
R=golang-dev, nigeltao
CC=golang-dev
https://golang.org/cl/5758047
 2012-03-08 14:18:28 +11:00
Shenghou Ma
d56e0e7e94 doc: fix freebsd build 
Also rename it to test.bash, for naming consistency.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5784045
 2012-03-08 12:04:49 +09:00
Andrew Gerrand
cfe007e1b6 doc: link to sub-repositories from reference page 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5752049
 2012-03-08 13:36:38 +11:00
Alex Brainman
a93047aa72 doc/go1.tmpl: small change left behind from abf39116ffac 
R=r
CC=golang-dev
https://golang.org/cl/5752072
 2012-03-08 10:01:15 +11:00
Shenghou Ma
6b770f05ad doc/go_mem: init-created goroutine behavior changes for Go 1 
They can start execution even before all init functions end.

R=rsc, r, adg
CC=golang-dev
https://golang.org/cl/5732061
 2012-03-08 03:56:31 +08:00
Russ Cox
a6ce691bd4 doc: give up on OS X Leopard 
Fixes #3206.

R=golang-dev, gri, bradfitz
CC=golang-dev
https://golang.org/cl/5769046
 2012-03-07 13:57:57 -05:00
Russ Cox
562bccf89e doc: update effective_go.tmpl 
Forgot this half in https://golang.org/cl/5764044

R=gri
CC=golang-dev
https://golang.org/cl/5770044
 2012-03-07 11:57:54 -05:00
Russ Cox
e8d1852d6a doc: update Effective Go init section 
Goroutines are no longer excluded from init.

Fixes #3232.

R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/5764044
 2012-03-07 11:38:39 -05:00
Russ Cox
40807282ac doc: delete faq question about 6g 
Fixes #3230.

R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/5753071
 2012-03-07 11:37:56 -05:00
Alex Brainman
5aee1f3a0f exp/wingui: getting relocated to 
go get code.google.com/p/gowingui

R=golang-dev, minux.ma, r
CC=golang-dev
https://golang.org/cl/5752067
 2012-03-07 17:48:09 +11:00
Rob Pike
0130a31366 go_faq: a simple binary is a little smaller now 
About 10% for hello, world.
Maybe more reductions will come.
Also clarify that we're comparing printf against Printf
(gcc can optimize aggressively, making this a different
sort of comparison).

R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/5756070
 2012-03-07 15:29:26 +11:00
Ian Lance Taylor
25f15d5f22 doc: add note about import . to Go 1 compatibility notes 
R=r
CC=golang-dev
https://golang.org/cl/5752065
 2012-03-06 17:50:11 -08:00
Johan Euphrosine
26dc17ce78 doc: fix typos in laws_of_reflection article, add copyright notice. 
Update #2547.

R=golang-dev, minux.ma, r, r, adg
CC=golang-dev
https://golang.org/cl/5755051
 2012-03-07 11:24:00 +11:00
Shenghou Ma
97b13acb67 doc: update links 
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/5754051
 2012-03-07 08:15:47 +11:00
Shenghou Ma
efbd79ce5a doc: remove unsued progs and makehtml script, update progs/run 
Due to removal of go_tutorial, unused programs are removed.
        makehtml is unnecessary (it also gives wrong messages when
        the destination file doesn't exist)
        progs/run now compiles all remaining programs under doc/progs.
        Fixes #3076 (again)

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/5755053
 2012-03-07 08:05:10 +11:00
Andrew Gerrand
73b8ccb0b0 doc: add "The go command" article based on Russ' mail 
This is a philosophical document. We can soup it up at a later stage,
but for now it's nice to have a URL to point to that isn't a mailing
list post.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5676061
 2012-03-07 07:40:21 +11:00
Andrew Gerrand
f35fa85a3f doc/gopher: flip frontpage gopher's eyes 
R=r, r
CC=golang-dev
https://golang.org/cl/5759045
 2012-03-06 16:56:30 +11:00
Andrew Gerrand
d70627e5d0 doc: update install docs for Windows and Go 1, add golang-announce to /project 
R=golang-dev, bradfitz, r, rsc
CC=golang-dev
https://golang.org/cl/5758044
 2012-03-06 15:16:02 +11:00
Andrew Gerrand
f200b72a7c doc: add more gophers 
R=golang-dev, bradfitz, r
CC=golang-dev
https://golang.org/cl/5753047
 2012-03-06 12:50:52 +11:00
Andrew Gerrand
80cb47b706 doc: fix download link on front page 
R=golang-dev
CC=golang-dev
https://golang.org/cl/5730053
 2012-03-05 17:07:10 +11:00
Andrew Gerrand
56208edb8d weekly.2012-03-04 
R=golang-dev, dsymonds, bradfitz, minux.ma
CC=golang-dev
https://golang.org/cl/5732058
 2012-03-05 15:45:50 +11:00
Andrew Gerrand
a22b0f82a2 doc: add command docs page, canonicalize reference paths 
R=golang-dev, kyle, r
CC=golang-dev
https://golang.org/cl/5728055
 2012-03-05 15:30:27 +11:00
Andrew Gerrand
539178bd01 doc: add help page, update project page 
R=golang-dev, kyle, r, bradfitz
CC=golang-dev
https://golang.org/cl/5729053
 2012-03-05 15:07:43 +11:00
Andrew Gerrand
f78d50c6e5 doc: clean up docs page, refer to wiki, change install doc paths 
R=golang-dev, minux.ma, r
CC=golang-dev
https://golang.org/cl/5728051
 2012-03-05 14:31:27 +11:00
Rob Pike
f5a1dd888d doc/progs: update for go 1 
Fixes #3076.

R=golang-dev, dsymonds, r
CC=golang-dev
https://golang.org/cl/5727056
 2012-03-05 12:49:31 +11:00
Shenghou Ma
4d7017dcd0 doc/effective_go: minor fix 
We have 'gofmt' and 'go fmt', but not 'go tool fmt'.

R=golang-dev, kyle, r
CC=golang-dev
https://golang.org/cl/5739043
 2012-03-05 11:12:58 +11:00
Andrew Gerrand
d1e726c583 doc: change menu, tweak front page 
R=golang-dev, kyle, r
CC=golang-dev
https://golang.org/cl/5729052
 2012-03-05 10:34:22 +11:00
Francisco Souza
54875a7a7f doc: fix another typo in article on defer, panic and recover 
Fixes #3177

R=adg
CC=golang-dev
https://golang.org/cl/5728057
 2012-03-04 14:40:14 +11:00
Francisco Souza
b1b0b73738 doc: fixed minor typo in article on defer 
Fixes #3176.

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/5737043
 2012-03-04 11:34:21 +11:00
Andrew Gerrand
120c223822 doc: remove roadmap document 
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/5726047
 2012-03-03 12:53:37 +11:00
Andrew Gerrand
aabf2ee8e1 doc: change wording on references page 
R=golang-dev
CC=golang-dev
https://golang.org/cl/5728050
 2012-03-03 12:48:35 +11:00
Rob Pike
95d7d3d658 doc/install-source.html: update for go tool 
Make some updates, get rid of mentions of make.
There remain a number of open questions.

R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/5720057
 2012-03-03 09:36:09 +11:00
Shenghou Ma
6a005cb03f doc/go1: minor corrections 
Set dagger looks very much like t in some fonts, so superscript it.
        os/signal is no longer in exp.

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/5720049
 2012-03-03 00:47:11 +08:00
Sanjay Menakuru
4d7d3f5328 doc: fix some HTML errors in code.html 
R=golang-dev, rsc
CC=adg, golang-dev
https://golang.org/cl/5720050
 2012-03-02 11:29:09 -05:00
Andrew Gerrand
718de6f4c6 doc: expand code.html to discuss the go tool in more depth 
R=golang-dev, balasanjay, r
CC=golang-dev
https://golang.org/cl/5640045
 2012-03-02 15:35:36 +11:00
Andrew Gerrand
47d614e667 doc: update go1 for html changes 
R=golang-dev, rsc, r
CC=golang-dev
https://golang.org/cl/5713054
 2012-03-02 11:52:46 +11:00
Russ Cox
9996f7f17a doc: describe API changes to go/build 
R=golang-dev, gri, r
CC=golang-dev
https://golang.org/cl/5711059
 2012-03-01 18:17:28 -05:00
Robert Griesemer
103c9db747 spec: clarifications around exports, uniqueness of identifiers 
- Define what it means for two identifiers to be unique.

- The current spec is incorrect about exported
identifiers: for instance, it excluded fields
of non-exported types of exported variables
from being exported. It is easier to leave
the detailed specification away and let the
rest of the spec govern access of exported
identifiers.

- The current spec is incorrect about qualified
identifiers: It simply required that an identifier
be exported to be valid in a qualified identifier.
However, qualified identifiers can only access
exported identifiers declared in the package
block of the imported package.

Fixes #1551.

R=r, rsc, iant, ken
CC=golang-dev
https://golang.org/cl/5711043
 2012-03-01 13:57:49 -08:00
Robert Griesemer
953f2dec89 spec: minor tweaks 
- more idiomatic examples of pointer types
- show use of _ in examples of function types
- remove "legal:" qualification in examples
  for consistency

R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/5711054
 2012-03-01 10:35:15 -08:00
Shenghou Ma
cb6c09a75a doc: update link to self-hosted "The Laws of Reflection" article 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5717046
 2012-03-01 14:54:35 +08:00
Stefan Nilsson
c50074e510 doc: add a bunch of missing <p> tags 
R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/5707065
 2012-02-29 15:07:52 -08:00
Johan Euphrosine
6652b0b866 doc: add The Laws of Reflection article 
Originally published on The Go Programming Language Blog, September 6, 2011.

http://blog.golang.org/2011/09/laws-of-reflection.html

Update #2547

R=golang-dev, r, adg
CC=golang-dev
https://golang.org/cl/5689054
 2012-03-01 10:05:51 +11:00
Russ Cox
8e38b17a90 spec: apply method sets, embedding to all types, not just named types 
When we first wrote the method set definition, we had long
discussions about whether method sets applied to all types
or just named types, and we (or at least I) concluded that it
didn't matter: the two were equivalent points of view, because
the only way to introduce a new method was to write a method
function, which requires a named receiver type.

However, the addition of embedded types changed this.
Embedding can introduce a method without writing an explicit
method function, as in:

        var x struct {
                sync.Mutex
        }

        var px *struct {
                sync.Mutex
        }

        var _, _ sync.Locker = &x, px

The edits in this CL make clear that both &x and px satisfy
sync.Locker.  Today, gccgo already works this way; 6g does not.

R=golang-dev, gri, iant, r
CC=golang-dev
https://golang.org/cl/5702062
 2012-02-29 15:54:06 -05:00
Russ Cox
0201e373e5 spec: shorten heading for complex, real, imag 
In the current TOC it sticks out quite a bit.

R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/5705053
 2012-02-29 15:20:11 -05:00
Robert Griesemer
7c1cb37b55 spec: use the term "lexical token" (rather then "lexical symbol") 
Fix for minor inconsistency.

R=golang-dev, iant
CC=golang-dev
https://golang.org/cl/5709058
 2012-02-29 10:39:20 -08:00
Robert Griesemer
da633714fd spec: fix sentence 
R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/5706065
 2012-02-29 09:06:05 -08:00
Andrew Gerrand
5fea39d0b4 doc: remove Go for C++ Programmers 
Now available at the Go Wiki:
http://code.google.com/p/go-wiki/wiki/GoForCPPProgrammers

Fixes #2913.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5705049
 2012-02-29 13:23:07 +11:00
Robert Griesemer
2c9e1637d2 go spec: inside functions, variables must be evaluated. 
Fixes #1612.

R=r, rsc, iant, ken, remyoudompheng, ken, r
CC=golang-dev
https://golang.org/cl/5700068
 2012-02-28 17:44:24 -08:00
Ian Lance Taylor
b69fa69a8b doc: update Go For C++ Programmers 
Minor cleanups to look more like current Go.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5707053
 2012-02-28 16:49:57 -08:00
Rob Pike
9e7e6d9ea4 doc/go1: tweaks to address rsc's comments 
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/5706054
 2012-02-29 11:29:33 +11:00
Stefan Nilsson
bfdc3baa1e doc/style.css: make selectors more selective. 
Change #foo to div#foo to avoid selecting headings
with anchor foo, such as <h1 id="foo">.

(A more extensive change would be to use class
selectors for styling. Perhaps this is better, since id:s
should be unique within a document according to
http://www.w3.org/TR/CSS2/selector.html#id-selectors)

R=golang-dev, gri, adg
CC=golang-dev
https://golang.org/cl/5702044
 2012-02-29 09:38:58 +11:00