qbit/go
1
0
Fork 0
mirror of https://github.com/golang/go synced 2024-09-24 23:20:12 -06:00
Code Releases Activity
18,768 Commits 58 Branches 402 Tags 522 MiB
967901a396
Commit Graph

1867 Commits

Author SHA1 Message Date
Andrew Gerrand
14b32ed7b2 doc: we support all recent versions of OS X 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/25370045
 2013-11-13 11:35:25 +11:00
Ian Lance Taylor
8d206d9d80 doc: update note about GCC 4.8.2 in gccgo instructions 
R=golang-dev, minux.ma
CC=golang-dev
https://golang.org/cl/22510043
 2013-11-06 13:58:35 -08:00
Andrew Gerrand
c1ef845a71 doc/go1.2: link to cgo documentation 
I know it's linked in the previous sentence, but this new link is where I want it to be while reading this sentence.

R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/21770043
 2013-11-05 13:54:48 +11:00
Rob Pike
95ae85fb82 doc/go1.2.html: delete repeated word 
TBR=rsc

R=golang-dev
CC=golang-dev
https://golang.org/cl/19840043
 2013-10-30 09:39:20 -07:00
Rob Pike
0f706d39d4 doc/go1.2.html: stack sizes, thread limits 
R=golang-dev, minux.ma, adg, rsc
CC=golang-dev
https://golang.org/cl/19600043
 2013-10-30 08:54:53 -07:00
Andrew Gerrand
8b0fad11e5 doc: update front page summary text 
R=rsc
CC=golang-dev
https://golang.org/cl/18080045
 2013-10-29 15:56:38 +09:00
Robert Griesemer
15da997c7e spec: clarify re-use of underlying arrays in slice operations 
Please note the slight rewording for append: The spec now
requires that append reuses the underlying array if it is
sufficiently large. Per majority sentiment.

This is technically a language change but the current
implementation always worked this way.

Fixes #5818.
Fixes #5180.

R=rsc, iant, r, ken, minux.ma, dan.kortschak, rogpeppe, go.peter.90
CC=golang-dev
https://golang.org/cl/14419054
 2013-10-16 16:16:54 -07:00
Shenghou Ma
244014e402 doc/effective_go.html: fix code example 
Fixes #6595.

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/14425062
 2013-10-15 21:30:49 -04:00
Oling Cat
6f53c4136b doc/contrib.html: fix some tags 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/14516057
 2013-10-15 18:41:23 +11:00
Shenghou Ma
26f43a089e doc: fix small HTML problems 
R=golang-dev, dave
CC=golang-dev
https://golang.org/cl/14629043
 2013-10-12 18:40:41 -04:00
Rob Pike
7f168f9ccf doc/effective_go.html: fix unescaped less-than character 
Why doesn't tidy complain about these?
Found by manlio.perillo.
Fixes #6571

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/14608044
 2013-10-11 16:39:40 -07:00
Ian Lance Taylor
db3374e24d doc/progs: don't try building cgo tests if CGO_ENABLED=0 
R=golang-dev, jsing, r
CC=golang-dev
https://golang.org/cl/14523056
 2013-10-11 08:55:13 -07:00
Rob Pike
beca0e124d doc/effective_go.html: fix a couple of cosmetic issues 
At the moment, godoc expands the example in the link, but in
the past it has not. Add a waffle word to allow either possibility.
Also change the order of cases in the switch in Compare to
be consistent with the other switch in the function.

R=golang-dev, iant
CC=golang-dev
https://golang.org/cl/14439055
 2013-10-10 17:26:03 -07:00
Andrew Gerrand
cf694aac34 doc: fix a few broken links 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/14494044
 2013-10-09 07:05:43 +11:00
Andrew Gerrand
0d676f3d1e doc/articles/wiki: fix path handling and clean up test process 
Fixes #6525.

R=r
CC=golang-dev
https://golang.org/cl/14383043
 2013-10-08 11:14:35 +11:00
Robert Griesemer
e121de2f01 spec: unsafe.Pointers are pointers 
But they cannot be dereferenced.
See also issue 6116.

Fixes #6358.

R=r, rsc, iant, ken
CC=golang-dev
https://golang.org/cl/14374046
 2013-10-07 10:43:28 -07:00
Mikio Hara
eb002c50f5 doc/go1.2.html: update a minor change to syscall 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/14379043
 2013-10-04 13:13:56 +09:00
Andrew Gerrand
48ba6fe553 doc: move spec and memory model back to /ref/ 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/14364043
 2013-10-04 09:45:06 +10:00
Robert Griesemer
4cc71e3363 spec: added additional links, added missing 'label' 
No semantic spec changes.

R=r
CC=golang-dev
https://golang.org/cl/14363043
 2013-10-03 16:38:22 -07:00
Robert Hencke
58d18e25af spec: fix small typo in comment for example 
R=golang-dev, mirtchovski, r
CC=golang-dev
https://golang.org/cl/14227043
 2013-10-03 12:46:02 -07:00
Russ Cox
fe1c92a203 doc: remove link to PackageVersioning wiki 
That page may be fine for experienced Go programmers
but it's not really targeting new programmers.
There's too much we don't know yet.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/14345043
 2013-10-03 13:53:16 -04:00
Russ Cox
dc8d903155 doc/faq: add a FAQ about versioning 
Fixes #5633.

R=golang-dev, r, tommi.virtanen, adg, nj
CC=golang-dev
https://golang.org/cl/14283044
 2013-10-03 09:18:47 -04:00
Rob Pike
d38ed2a9f2 doc/effective_go: fix server example that shares var between goroutines 
Use it as a teaching example about how to solve this problem.

Fixes #6501

R=golang-dev, adg, rsc
CC=golang-dev
https://golang.org/cl/14250043
 2013-10-02 11:35:25 -07:00
Andrew Gerrand
57d37b55b8 doc: rename @go_nuts to @golang 
Yay!

R=golang-dev, dave
CC=golang-dev
https://golang.org/cl/14256043
 2013-10-02 11:46:44 +10:00
Andrew Gerrand
1f7c8a9aed doc: update links to spec and memory model 
Fixes #6488.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/14004043
 2013-09-27 09:46:36 +10:00
Andrew Gerrand
bc0e51555c doc: mention the install locations for godoc, cover, and vet 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/13893043
 2013-09-25 18:15:29 +10:00
Rob Pike
4be17b7a7e doc/go1.2.html: add go/ast.SliceExpr.Slice3 
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/13877044
 2013-09-25 16:17:54 +10:00
Andrew Gerrand
bc5e77fef9 doc: fix typo in install-source.html 
R=golang-dev, minux.ma
CC=golang-dev
https://golang.org/cl/13892043
 2013-09-25 14:27:23 +10:00
Andrew Gerrand
b3caa86f91 doc: document installation of go.tools commands 
Fixes #5663.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/13891043
 2013-09-25 14:10:49 +10:00
Shenghou Ma
d00fb0a1ea doc/go1.2: document that godoc and vet will always be installed to their old locations (not $GOPATH/bin). 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/13830043
 2013-09-23 01:23:42 -04:00
Andrew Gerrand
d851c6d478 doc: mention os/exec StdinPipe change in Go 1.2 doc 
Fixes #6439.

R=r, minux.ma
CC=golang-dev
https://golang.org/cl/13478045
 2013-09-23 15:14:26 +10:00
Rob Pike
4977f9f926 doc/go1.2.html: fix 3-index slice example 
A number was wrong; adjust as suggested to make things clearer.
Fixes #6452

R=golang-dev, minux.ma
CC=golang-dev
https://golang.org/cl/13422046
 2013-09-23 14:41:20 +10:00
Dominik Honnef
f70116102b doc/go1.2.html: Go 1.2, not Go1.2 
R=r
CC=golang-dev
https://golang.org/cl/13735044
 2013-09-22 07:28:52 +10:00
Rob Pike
e4c1fffcb1 doc/go1.2.html: pre-emption; cgo and C++ 
These were bullet points that I had neglected to flesh out.

R=golang-dev, dvyukov
CC=golang-dev
https://golang.org/cl/13816043
 2013-09-21 17:53:44 +10:00
Rob Pike
2a5dcfafec effective_go: add a discussion of labeled break and continue 
Fixes #5725.

R=golang-dev, iant
CC=golang-dev
https://golang.org/cl/13705044
 2013-09-17 07:41:45 +10:00
Rob Pike
cec0954dd0 spec: add example for continue to label 
Make the break example slightly more interesting
Update #5725
Effective Go will be updated in a separate CL.

R=golang-dev, iant
CC=golang-dev
https://golang.org/cl/13368054
 2013-09-17 07:41:11 +10:00
Nigel Tao
765479ccb0 doc/go1.2.html: add a "New packages" section similar to 
http://golang.org/doc/go1.1#new_packages

R=r
CC=golang-dev
https://golang.org/cl/13368053
 2013-09-16 16:26:07 +10:00
Andrew Gerrand
5dd74175d4 doc: re-organize golang.org site content 
Remove "References" section.
Remove most articles and redirect to blog.golang.org.
Move /ref/spec and /ref/mem to /doc/spec and /doc/mem.
Remove duplicate links from the remaining
"Documents", "The Project", and "Help" pages.
Defer to the wiki for more links and community content.
Update command reference and mention cover tool.
Add "Pop-out" text to the front page.
Pick one of four videos at random to feature on the front page.

Fixes #2547.
Fixes #5561.
Fixes #6321.

R=r, dominik.honnef
CC=golang-dev
https://golang.org/cl/13724043
 2013-09-16 15:47:13 +10:00
Rob Pike
83da0fd989 doc/go1.2.html: compiler changes 
Document the semantic changes within the gc toolchain.

Also delete the mention of unbalanced right delims in template
That change was rolled back.

Absent typos, things we've forgotten, and new things that happen,
the release notes are ready.

R=golang-dev, adg, dominik.honnef
CC=golang-dev
https://golang.org/cl/13368052
 2013-09-16 13:03:00 +10:00
Andrew Gerrand
f43b6d470e doc: add uninstallation instructions 
Fixes #5821.

R=golang-dev, kamil.kisiel
CC=golang-dev
https://golang.org/cl/13720043
 2013-09-16 11:20:07 +10:00
Rob Pike
d237f3ce6f doc/go1.2.html: net/http, encoding, performance, library changes 
Everything is done except compiler changes and additional platforms, if any.

R=golang-dev, dominik.honnef, adg
CC=golang-dev
https://golang.org/cl/13484045
 2013-09-16 10:28:53 +10:00
Rob Pike
ea78a4a7a2 doc/go1.2.html: cover, template, vet 
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/13373053
 2013-09-12 16:46:08 +10:00
Mikio Hara
28a8e9ba2f doc/go1.2.html: happy eyeballs on net 
Also fix trivial nits.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/13532046
 2013-09-12 15:12:40 +09:00
Robert Griesemer
e333b96529 spec: define s[i:j:k] 
R=rsc, r, iant, ken
CC=golang-dev
https://golang.org/cl/10243046
 2013-09-11 17:18:52 -07:00
Rob Pike
c0ac667531 doc/go1.2.html: status of gccgo's support for 1.2 
R=iant, minux.ma
CC=golang-dev
https://golang.org/cl/13669043
 2013-09-12 10:12:26 +10:00
Rob Pike
a97a7c5eb6 doc/go1.2.html: some library changes (fmt, template) 
Also link it to the landing page for docs.

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/13652045
 2013-09-12 09:08:59 +10:00
Rob Pike
6cbc5387c3 doc/go1.2.html: introduction, language changes 
R=golang-dev, remyoudompheng, dominik.honnef, adg
CC=golang-dev
https://golang.org/cl/13341049
 2013-09-10 15:13:45 +10:00
Rob Pike
5863b7d2ce doc/go1.2.html: first cut 
Lay out the doc and write text for the minor changes.
(I left the net ones for someone who understands them better,
or for someone to describe them to me better so I can write them.)
Much still to do.

Delete go1.2.txt so there's only one thing to update.

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/13597044
 2013-09-09 13:29:08 +10:00
Adam Langley
3fca983872 doc/go1.2.txt: crypto/{x509,tls} changes 
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/13335050
 2013-09-03 16:19:41 -04:00
Brad Fitzpatrick
379096de05 doc/go1.2.txt: add compress/gzip and database/sql lines 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/13316044
 2013-08-30 17:39:58 -07:00
Rob Pike
5d6ea6f70e doc/go1.2.txt: compress/flate changes 
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/13324046
 2013-08-30 15:32:51 +10:00
Rob Pike
1d7699e99c doc/go1.2.txt: text/template's if-else 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/13334043
 2013-08-29 10:09:23 +10:00
Rob Pike
c0148303af doc/go1.2.txt: dereference pointer values when evaluating args for escape funcs 
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/13262043
 2013-08-27 14:33:05 +10:00
Rob Pike
61f3fdcaec doc/go_faq.html: fix non-grammatical sentence 
With my apologies.

R=golang-dev, alex.brainman
CC=golang-dev
https://golang.org/cl/12984045
 2013-08-25 23:50:44 +10:00
Jan Mercl
ad50f6b213 doc: correct a minor go_mem.html mistake 
Fixes #6227

R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/13183043
 2013-08-23 10:40:01 -05:00
Andrew Gerrand
a48702eb39 doc: hide playground on front page if playground disabled 
Fixes #5630.

R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/12884046
 2013-08-22 11:12:44 +10:00
Elias Naur
c1dd7f4322 doc/go1.2.txt: cmd/5l: support for external linking for linux/arm 
R=r
CC=golang-dev
https://golang.org/cl/13019044
 2013-08-21 17:45:35 +10:00
Rob Pike
a83b17c0b7 doc/go1.2.txt: text/template: add comparison functions 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/12801045
 2013-08-21 12:55:09 +10:00
Mikio Hara
b3424a7850 doc/go1.2.txt: net: performance improvement on BSD 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/12975044
 2013-08-21 09:53:17 +09:00
Rob Pike
478c871f02 doc/go1.2.txt: archive/tar's fixed FileInfo 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/13140043
 2013-08-21 08:37:32 +10:00
Brad Fitzpatrick
8738dd3cce doc: remove a insignificant line from go1.2.txt 
Not a user-visible API change.  Just a minor garbage
win in contrived cases.

Also, the package is io/ioutil.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/12987044
 2013-08-20 15:35:07 -07:00
Rob Pike
0d5bc0cff5 doc/go_faq.html: link to the SPLASH talk near the top 
It's a full answer to the first question; let's let readers know that.

R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/12788048
 2013-08-20 06:44:41 +10:00
Dmitriy Vyukov
a96d850a5b doc: describe halt_on_error race detector parameter 
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/13067043
 2013-08-16 22:42:54 +04:00
Rob Pike
8814b4a4c6 doc/go1.2.txt: testing: add TB interface 
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/12890044
 2013-08-16 15:38:18 +10:00
Rob Pike
9c248e3406 doc/go1.2.txt: delete 'go doc' 
It's nearly useless and for plain 'go doc', 'godoc .' works fine.

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/13004044
 2013-08-16 10:35:22 +10:00
Rob Pike
de2cf5113b doc/go1.2.txt: three-index slices are going into 1.2 
R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/12931044
 2013-08-16 10:30:31 +10:00
Russ Cox
5ce78b7cd2 spec: &x panics if x does 
See golang.org/s/go12nil for the extended version.

R=golang-dev, r, adonovan
CC=golang-dev
https://golang.org/cl/12964043
 2013-08-15 14:33:26 -04:00
Rémy Oudompheng
826a739658 doc: update go1.2.txt 
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/12960043
 2013-08-15 10:31:18 +02:00
Rob Pike
15e6ce2351 go_spec.html: clarify that tags are part of struct type identity 
One sentence says they're ignored, another says they take part.
Fix the first.

R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/12741046
 2013-08-15 13:15:55 +10:00
Andrew Gerrand
89ecedab26 doc: update go1.2.txt 
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/12957044
 2013-08-15 08:13:38 +10:00
Brad Fitzpatrick
61f5c63103 doc: update go1.2.txt 
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/12953043
 2013-08-14 14:56:31 -07:00
Russ Cox
f5806a9007 doc: update go1.2.txt 
Will submit once I can fill in the CL XXX number.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/12912044
 2013-08-14 15:37:23 -04:00
Dmitriy Vyukov
d1cefd6b6d doc: update go1.2.txt 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/12851043
 2013-08-13 17:21:33 +04:00
Andrew Gerrand
f7ab3917f9 doc: release notes for go1.1.2 
R=golang-dev, go.peter.90, rsc, r
CC=golang-dev
https://golang.org/cl/12016043
 2013-08-13 15:08:10 +10:00
Rob Pike
306c29e963 doc/go1.2.txt: bufio.{Writer,Reader}.Reset 
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/12830043
 2013-08-13 13:39:45 +10:00
Rob Pike
9baac2bf15 doc/go1.2.txt: json and ampersands 
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/12698047
 2013-08-12 11:28:25 +10:00
Russ Cox
207289660a doc: update go1.2.txt 
I skimmed the submitted CLs back to Monday.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/12696045
 2013-08-09 22:25:49 -04:00
Pieter Droogendijk
e486cefec2 doc/go1.2.txt: Added missing changes since 1st of August 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/12714043
 2013-08-10 09:48:43 +10:00
Pieter Droogendijk
2f0acc1e80 doc/go1.2.txt: document previously committed features 
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/12585044
 2013-08-08 09:57:31 -07:00
Rob Pike
fc714594d7 doc/go1.2.txt: flag now exports CommandLine 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/12642043
 2013-08-08 12:40:09 +10:00
Rob Pike
a4eac94b57 doc/articles/laws_of_reflection.html: fix name of variable 
Thanks to c.emil.hessman@gmail.com for pointing out the error.

R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/12572043
 2013-08-07 09:34:39 +10:00
Russ Cox
10ebb84d48 runtime: remove debugging knob to turn off preemption 
It's still easy to turn off, but the builders are happy.
Also document.

R=golang-dev, iant, dvyukov
CC=golang-dev
https://golang.org/cl/12371043
 2013-08-05 16:06:24 -04:00
Rob Pike
c43cca7d92 doc/progs/slices.go: fix typo in comment 
Fixes #6025.

R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/12387046
 2013-08-05 13:35:42 +10:00
Rob Pike
38a77ff03f doc/effective_go.html: remove spurious word 
Fixes #6003.

R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/12387045
 2013-08-05 11:24:27 +10:00
Andrew Gerrand
ffb62d58a3 doc: remove jquery.js and style.css 
Somehow missed these. Moved to go.tools/cmd/godoc/template.

R=golang-dev
CC=golang-dev
https://golang.org/cl/12234043
 2013-08-01 17:36:45 +10:00
Robert Griesemer
2961d229de spec: clarify index and selector expressions 
(Replacement for CL 11884043.)

1) Explain a[i] and a[i:j] where a is of type *A as
   shortcut for (*a)[i] and (*a)[i:j], respectively.

2) Together with 1), because len() of nil slices is
   well defined, there's no need to special case nil
   operands anymore.

3) The result of indexing or slicing a constant string
   is always a non-constant byte or string value.

4) The result of slicing an untyped string is a value
   of type string.

5) If the operand of a valid slice a[i:j] is nil (i, j
   must be 0 for it to be valid - this already follows
   from the in-range rules), the result is a nil slice.

Fixes #4913.
Fixes #5951.

R=r, rsc, iant, ken
CC=golang-dev
https://golang.org/cl/12198043
 2013-07-31 22:25:47 -07:00
Andrew Gerrand
461f82526a doc: remove godocs.js and playground.js from core repo 
These are moved to code.google.com/p/go.tools/cmd/godoc.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/12220043
 2013-08-01 15:09:18 +10:00
Robert Daniel Kortschak
64cb2cf5cc doc: don't invoke go build with -o /dev/null during test 
Fixes #5998.

R=golang-dev, khr
CC=golang-dev
https://golang.org/cl/12149043
 2013-08-01 11:03:13 +10:00
Brad Fitzpatrick
727901410a doc/go1.2.txt: add time zone offsets with seconds 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/12174043
 2013-07-31 14:33:34 -07:00
Rob Pike
bd65404eef spec: clarify a couple of issues about channels 
1. They are FIFOs.
2. They are safe for concurrent access.

Fixes #5911.

R=golang-dev, dvyukov, adg
CC=golang-dev
https://golang.org/cl/11549043
 2013-08-01 07:12:32 +10:00
Robert Griesemer
9f75dd7f25 undo CL 11884043 / bfd5ed8236d5 
CL submitted prematurely by mistake.

««« original CL description
spec: clarify index and selector expressions

1) Explain a[i] and a[i:j] where a is of type *A as
   shortcut for (*a)[i] and (*a)[i:j], respectively.

2) Together with 1), because len() of nil slices is
   well defined, there's no need to special case nil
   operands anymore.

3) The result of indexing or slicing a constant string
   is always a non-constant byte or string value.

4) The result of slicing an untyped string is a value
   of type string.

5) If the operand of a valid slice a[i:j] is nil (i, j
   must be 0 for it to be valid - this already follows
   from the in-range rules), the result is a nil slice.

Fixes #4913.
Fixes #5951.

R=rsc, r, iant, ken
CC=golang-dev
https://golang.org/cl/11884043
»»»

R=r
CC=golang-dev
https://golang.org/cl/12170046
 2013-07-31 14:10:46 -07:00
Robert Griesemer
58d2960655 spec: clarify index and selector expressions 
1) Explain a[i] and a[i:j] where a is of type *A as
   shortcut for (*a)[i] and (*a)[i:j], respectively.

2) Together with 1), because len() of nil slices is
   well defined, there's no need to special case nil
   operands anymore.

3) The result of indexing or slicing a constant string
   is always a non-constant byte or string value.

4) The result of slicing an untyped string is a value
   of type string.

5) If the operand of a valid slice a[i:j] is nil (i, j
   must be 0 for it to be valid - this already follows
   from the in-range rules), the result is a nil slice.

Fixes #4913.
Fixes #5951.

R=rsc, r, iant, ken
CC=golang-dev
https://golang.org/cl/11884043
 2013-07-31 13:40:01 -07:00
Andrew Gerrand
d920d8d849 doc: don't block page load on JavaScript fetch 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/12050045
 2013-07-30 14:22:14 +10:00
Andrew Gerrand
fc32bfa9cc doc/codewalk: test source code 
Fixes #2648.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/11331043
 2013-07-30 09:42:53 +10:00
Andrew Gerrand
f6dd45bf82 doc/articles: state that slices/arrays start at the 0th element 
Fixes #5881.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/11892043
 2013-07-29 18:33:39 +10:00
Rémy Oudompheng
d26d5e6403 effective_go.html: make snippets look formatted. 
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/11991043
 2013-07-29 00:57:19 +02:00
Robert Griesemer
f331012427 spec: update prose in Constants section 
Fixes #5952.

R=r, rsc
CC=golang-dev
https://golang.org/cl/11812043
 2013-07-25 09:35:55 -07:00
Andrew Bonventre
f652bc4acf doc/go1.2.txt: document new functions/types added to image/gif and image/draw. 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/11492045
 2013-07-24 12:41:52 +10:00
Rob Pike
ac94c06d1e doc/go1.2.txt: document new function unicode.In 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/11745044
 2013-07-24 10:54:33 +10:00
Rob Pike
abe384f68a all: be more idiomatic when documenting boolean return values. 
Phrases like "returns whether or not the image is opaque" could be
describing what the function does (it always returns, regardless of
the opacity) or what it returns (a boolean indicating the opacity).
Even when the "or not" is missing, the phrasing is bizarre.

Go with "reports whether", which is still clunky but at least makes
it clear we're talking about the return value.

These were edited by hand. A few were cleaned up in other ways.

R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/11699043
 2013-07-23 11:59:49 +10:00