Brad Fitzpatrick
c0eb88029e
doc: add cmd/gofmt entry to go1.3.txt
...
R=golang-codereviews, minux.ma
CC=golang-codereviews
https://golang.org/cl/52240043
2014-01-14 12:27:51 -08:00
Rob Pike
82e2db70f6
spec: s/and/or/ for correctness and parallelism
...
No change to the meaning, just bad writing found by
Doug McIlroy.
Let's start the new year off with a bang.
R=golang-codereviews, bradfitz, dave
CC=golang-codereviews
https://golang.org/cl/47110044
2014-01-04 10:52:59 -08:00
Emil Hessman
13141315ad
spec: Fix broken type identity link
...
Fixes #7003 .
R=golang-codereviews, bradfitz
CC=golang-codereviews
https://golang.org/cl/47780043
2014-01-03 22:48:03 -08:00
David Symonds
8f3fc547d0
2014: Year of the Gopher.
...
R=adg, djd, mpvl, nigeltao
CC=golang-codereviews
https://golang.org/cl/46660043
2014-01-01 00:00:22 +11:00
Mihai Borobocea
8183ed19b9
spec: example shows wrong value for complex constant
...
Looks like a typo.
Fixes #7011 .
R=golang-codereviews, r, bradfitz
CC=golang-codereviews
https://golang.org/cl/45350043
2013-12-30 13:29:56 -08:00
Shawn Smith
2f5f193923
doc/contribute: golang-dev -> golang-codereviews
...
R=golang-codereviews, iant
CC=golang-codereviews
https://golang.org/cl/46320043
2013-12-29 11:11:28 -08:00
Alex Brainman
e8b7def7f4
doc/go1.3.txt: mention windows syscall.NewCallbackCDecl
...
R=golang-codereviews, r
CC=golang-codereviews
https://golang.org/cl/44160044
2013-12-21 12:52:53 +11:00
Josh Bleecher Snyder
de4ca13eac
doc: fix typo in Effective Go
...
R=adg, bradfitz
CC=golang-codereviews
https://golang.org/cl/44430043
2013-12-20 09:59:51 -08:00
Shenghou Ma
c184940d3f
doc/install-source.html: mention make.bash to skip tests
...
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/42590043
2013-12-15 21:03:12 -05:00
Aram Hăvărneanu
22a7b3442e
doc/articles/wiki: remove GNU make dependency
...
R=golang-dev, adg, minux.ma
CC=golang-dev
https://golang.org/cl/38410043
2013-12-15 17:51:03 -05:00
Ian Lance Taylor
8189605a96
doc: change "threads" to "goroutines"
...
R=golang-dev, minux.ma, rsc
CC=golang-dev
https://golang.org/cl/40510049
2013-12-12 18:48:40 -08:00
Andrew Gerrand
e8a1de720f
doc: add Go 1.2 to release history page
...
Fixes #6939 .
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/41540043
2013-12-13 09:31:49 +11:00
Rob Pike
0d624e1808
doc/go1.3.txt: first checkins: makerelease, liblink
...
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/40650047
2013-12-12 11:17:54 -08:00
Oling Cat
b349477eab
doc/effective_go.html: close some tags.
...
R=golang-dev, minux.ma
CC=golang-dev
https://golang.org/cl/37700043
2013-12-11 09:49:28 +11:00
Peter Collingbourne
a5cc5bab5a
doc: update list of gccgo import search paths
...
R=iant
CC=golang-dev
https://golang.org/cl/38560043
2013-12-06 13:33:10 -08:00
Rob Pike
b204448f7e
doc/go1.3.txt: add file to track significant CLs for 1.3
...
Nothing significant so far (right?), but let's lay the keystone.
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/36830043
2013-12-03 17:08:51 -08:00
Oling Cat
07d2195c66
doc/install.html: fix a tag.
...
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/30900044
2013-11-25 13:36:16 +11:00
Andrew Gerrand
c497c9ea4b
doc: update installation instructions
...
Clarify that GOROOT should only be set when using a custom install path.
Remove NetBSD from binary install page (we don't provide binaries).
Remove "What's next" links from installation instructions.
Emphasize "How to Write Go Code" page.
Fixes #6613 .
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/28700043
2013-11-21 07:55:29 +11:00
Russ Cox
a664b49457
doc/asm: more about SP, ARM R11
...
Also rename URL to /doc/asm.
R=golang-dev, minux.ma, r
CC=golang-dev
https://golang.org/cl/26170043
2013-11-13 21:29:34 -05:00
Russ Cox
7dd086e52d
encoding/gob: do not use MarshalText, UnmarshalText
...
This seems to be the best of a long list of bad ways to fix this issue.
Fixes #6760 .
R=r
CC=golang-dev
https://golang.org/cl/22770044
2013-11-13 21:29:19 -05:00
Rob Pike
2fbcb08192
doc/asm.html: new document, a brief guide to the assembler
...
Fixes #6060
R=golang-dev, iant, bradfitz, josharian, minux.ma, aram, rsc
CC=golang-dev
https://golang.org/cl/20930043
2013-11-12 20:04:22 -08:00
Robert Griesemer
f57bf7a556
spec: clarify rules for blank identifiers
...
This documents the status quo more precisely.
Not a language change.
Fixes #6006 .
R=r, rsc, iant, ken
CC=golang-dev
https://golang.org/cl/14415043
2013-11-12 21:06:54 -05:00
Andrew Gerrand
c72bce901e
doc: use the same wording for OS X as the other OSes
...
I used "and above" when I should have said "or later".
Sorry for the churn.
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/25670043
2013-11-13 11:53:01 +11:00
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
Andrew Gerrand
01cc462bfc
doc: fix wiki content error
...
Fixes #5898 .
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/11556043
2013-07-22 12:22:14 +10:00
Dave Cheney
deee03f17e
doc/effective_go: stamp out stray GOROOT reference
...
Replaced with something more appropriate.
R=adg, r, minux.ma
CC=golang-dev
https://golang.org/cl/11421043
2013-07-17 18:48:55 +10:00
Russ Cox
64054a40ad
encoding/json: coerce invalid UTF-8 to valid UTF-8 during Marshal
...
In practice, rejecting an entire structure due to a single invalid byte
in a string is just too picky, and too hard to track down.
Be consistent with the bulk of the standard library by converting
invalid UTF-8 into UTF-8 with replacement runes.
R=golang-dev, crawshaw
CC=golang-dev
https://golang.org/cl/11211045
2013-07-12 17:37:10 -04:00
Robert Griesemer
63f54ae3c2
spec: move decl in example closer to use
...
Fixes #5862 .
R=r
CC=golang-dev
https://golang.org/cl/11168043
2013-07-11 14:41:46 -07:00
Shenghou Ma
72faa4bc51
syscall: implement Sendfile for Darwin.
...
Update #5847
Summary: syscall: implement Sendfile for OpenBSD and NetBSD
R=golang-dev, rsc, dave
CC=golang-dev
https://golang.org/cl/10980043
2013-07-12 04:34:54 +08:00
Robert Griesemer
8268eadb9e
spec: define notion of named type
...
The notion of a named type is crucial for the definition
of type identity, assignability, definitions of methods.
Explicitly introduce the notion with an extra sentence.
Fixes #5682 .
R=r, rsc, iant
CC=golang-dev
https://golang.org/cl/11055043
2013-07-09 21:12:53 -07:00
Andrew Gerrand
1856286fc2
doc: update playground.js
...
R=dsymonds
CC=golang-dev
https://golang.org/cl/10933044
2013-07-04 14:24:21 +10:00
Rob Pike
f3aa009a12
doc/go1.2.txt: stable sort
...
R=golang-dev, dave
CC=golang-dev
https://golang.org/cl/10761048
2013-07-03 11:46:09 +10:00
Andrew Gerrand
493538adbf
cmd/godoc: set up playground for examples that are already visible
...
This fixes an issue where linking directly to an example makes it not
runnable and visible only in a tiny window. To see the bug in action,
visit this link: http://golang.org/pkg/strings/#example_Map
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/10679050
2013-07-02 08:44:25 +10:00
Rick Arnold
49b3301f4c
flag: add Getter interface; implement for all Value types
...
Fixes #5383 .
R=golang-dev, 0xjnml, r, rsc
CC=golang-dev
https://golang.org/cl/10472043
2013-06-27 15:30:45 -07:00
Rob Pike
4f2278d4db
doc/go1.2.txt: cmd/go and coverage; simple hash Sum functions
...
R=golang-dev, dave, rsc
CC=golang-dev
https://golang.org/cl/10631043
2013-06-27 09:20:02 -07:00
Robert Griesemer
de47f68c99
spec: fix spec on conversions to match implementations
...
The existing compilers convert empty strings to empty
but non-nil byte and rune slices. The spec required
a nil byte and rune slice in those cases. That seems
an odd additional requirement. Adjust the spec to
match the reality.
Also, removed over-specification for conversions of
nil []byte and []rune: such nil slices already act
like empty slices and thus don't need extra language.
Added extra examples instead.
Fixes #5704 .
R=rsc, r, iant
CC=golang-dev
https://golang.org/cl/10440045
2013-06-21 16:11:13 -07:00
Ian Lance Taylor
ffde4970d0
doc: update gccgo docs
...
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/10401046
2013-06-20 14:49:15 -07:00
Andrew Gerrand
7468b1d36a
doc: style tweaks in preparation for Google Feedback link
...
Fixes #5589 .
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/10272051
2013-06-18 15:26:15 +10:00
Andrew Gerrand
55511d2b34
doc: add go1.1.1 to the release notes
...
R=golang-dev, iant
CC=golang-dev
https://golang.org/cl/10236045
2013-06-13 12:43:26 +10:00
Shenghou Ma
06f55f5009
net: introduce netgo build tag to build a pure Go net package.
...
Fixes #4078 .
R=golang-dev, bradfitz, rsc, iant
CC=golang-dev
https://golang.org/cl/7100050
2013-06-11 02:55:16 +08:00
Shenghou Ma
bdac989ef7
doc/go_spec: more examples for unspecified cases of the evaluation order
...
R=golang-dev, bradfitz, gri, iant, rsc
CC=golang-dev
https://golang.org/cl/7235044
2013-06-11 02:52:07 +08:00
Shenghou Ma
177191237e
doc/install-source.html: recent ARM and 386 updates
...
R=golang-dev, dave, adg, remyoudompheng, r
CC=golang-dev
https://golang.org/cl/6845083
2013-06-09 23:15:39 +08:00
Patrick Higgins
6bf6cae28e
doc/contribute: add "Understanding the extension" section
...
Fixes #4996
R=golang-dev, r, bradfitz
CC=golang-dev
https://golang.org/cl/7547043
2013-06-05 21:09:43 -07:00
Adam Langley
2112fed743
crypto/tls: support TLS 1.1.
...
The significant change between TLS 1.0 and 1.1 is the addition of an explicit IV in the case of CBC encrypted records. Support for TLS 1.1 is needed in order to support TLS 1.2.
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/7880043
2013-06-04 20:02:22 -04:00
Andrew Gerrand
850d1026ad
doc: add Game of Life to playground toys
...
R=golang-dev, dsymonds, r
CC=golang-dev
https://golang.org/cl/9961043
2013-06-04 12:59:28 +10:00
Shenghou Ma
022818c142
doc/articles: use C90 standard functions in the cgo article.
...
R=golang-dev, iant
CC=golang-dev
https://golang.org/cl/9953043
2013-06-04 01:40:53 +08:00
Andrew Gerrand
ae43ea432d
doc: add Go 1.1 to release.html
...
Fixes #5468 .
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/9853051
2013-06-03 11:52:36 +10:00
Dave Cheney
ec1769ba7b
doc: update linux tarball version for Go 1.1
...
R=adg
CC=golang-dev
https://golang.org/cl/9819044
2013-06-03 11:47:42 +10:00
Shenghou Ma
1a145cd52d
doc/go1.2.txt: update for CL 8248043.
...
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/9949044
2013-06-03 03:09:47 +08:00
Oling Cat
5b7d422a05
doc/go1.1.html: remove extra space; close some tags.
...
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/9941043
2013-06-01 10:28:04 -04:00
Robert Griesemer
ab5c762a46
spec: better wording re: receiving from closed channels
...
As suggested by ej@evanjones.ca .
Fixes #5604 .
R=r
CC=golang-dev
https://golang.org/cl/9899043
2013-05-31 11:21:37 -07:00
Rob Pike
85fc2f70ac
doc/go1.2.txt: AllocsPerRun now quantized
...
R=golang-dev, khr, rsc
CC=golang-dev
https://golang.org/cl/9728045
2013-05-30 12:41:20 -04:00
Shenghou Ma
5d081792b6
cmd/5a, cmd/dist, runtime: support m/g in the assembler, drop support for R9/R10
...
to avoid unintentionally clobber R9/R10.
Thanks Lucio for the suggestion.
PS: yes, this could be considered a big change (but not an API change), but
as it turns out even temporarily changes R9/R10 in user code is unsafe and
leads to very hard to diagnose problems later, better to disable using R9/R10
when the user first uses it.
See CL 6300043 and CL 6305100 for two problems caused by misusing R9/R10.
R=golang-dev, khr, rsc
CC=golang-dev
https://golang.org/cl/9840043
2013-05-30 03:03:52 +08:00
Katrina Owen
605da0e2a2
doc: Fix typo in approximation of square root
...
See https://en.wikipedia.org/wiki/Newton%27s_method#Square_root_of_a_number
R=golang-dev, minux.ma, adg
CC=golang-dev
https://golang.org/cl/9145044
2013-05-29 13:49:51 +10:00
Brian G. Merrell
20c524c5e2
effective_go.html: Fix two links
...
This fixes two intra-page "type assertion" links that were broken in
different ways.
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/9797043
2013-05-27 11:00:12 +10:00
Rob Pike
7472ce0e58
fmt.Printf: introduce notation for random access to arguments.
...
This text is added to doc.go:
Explicit argument indexes:
In Printf, Sprintf, and Fprintf, the default behavior is for each
formatting verb to format successive arguments passed in the call.
However, the notation [n] immediately before the verb indicates that the
nth one-indexed argument is to be formatted instead. The same notation
before a '*' for a width or precision selects the argument index holding
the value. After processing a bracketed expression [n], arguments n+1,
n+2, etc. will be processed unless otherwise directed.
For example,
fmt.Sprintf("%[2]d %[1]d\n", 11, 22)
will yield "22, 11", while
fmt.Sprintf("%[3]*[2].*[1]f", 12.0, 2, 6),
equivalent to
fmt.Sprintf("%6.2f", 12.0),
will yield " 12.00". Because an explicit index affects subsequent verbs,
this notation can be used to print the same values multiple times
by resetting the index for the first argument to be repeated:
fmt.Sprintf("%d %d %#[1]x %#x", 16, 17)
will yield "16 17 0x10 0x11".
The notation chosen differs from that in C, but I believe it's easier to read
and to remember (we're indexing the arguments), and compatibility with
C's printf was never a strong goal anyway.
While we're here, change the word "field" to "arg" or "argument" in the
code; it was being misused and was confusing.
R=rsc, bradfitz, rogpeppe, minux.ma, peter.armitage
CC=golang-dev
https://golang.org/cl/9680043
2013-05-24 15:49:26 -07:00
Russ Cox
30fde1b279
doc: start go 1.2 notes
...
This is a file of hints, not a file of polished text.
Let's not try to do polished text until we start the
release process.
R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/9750043
2013-05-24 16:34:50 -04:00
Ian Lance Taylor
452f3bc759
doc: GCC 4.8.1 is not updated to Go 1.1
...
I will try again for 4.8.2.
R=golang-dev, minux.ma
CC=golang-dev
https://golang.org/cl/9663045
2013-05-22 13:05:31 -07:00
David Symonds
c912150761
doc/go_faq: fix example.
...
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/9564044
2013-05-22 12:28:58 +10:00
Robert Griesemer
6a3859f433
spec: removed old or invalid TODOs
...
Several old TODOs are either resolved now (e.g. when is a return
needed), or are from a time the language wasn't frozen (^ for uints
only). Consolidated the others.
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/9599044
2013-05-20 14:01:07 -07:00
Robert Griesemer
bb3a32ef6e
spec: fix language about "range" clause
...
Fixes #5434 .
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/9595044
2013-05-20 13:27:53 -07:00
Shenghou Ma
df29cdd33d
doc/go_spec: fix typos
...
Fixes #5456 .
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/9400044
2013-05-15 03:50:27 +08:00
Nigel Tao
0ae5036b26
doc: add a "New packages" section to the 1.1 release notes.
...
R=adg, r
CC=golang-dev
https://golang.org/cl/9344044
2013-05-12 21:58:27 -07:00
Robert Griesemer
2d846f6521
spec: fix incorrect example
...
Fixes #5430 .
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/9305043
2013-05-08 10:42:08 -07:00
Andrew Gerrand
f0c3d26473
doc: pull front page featured articles using new blog JSON feed
...
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/9288045
2013-05-08 09:23:50 -07:00
Rob Pike
2f326da27e
effective_go.html: be more accepting in the guidelines for interface names
...
Fixes #5421 .
R=golang-dev, bradfitz, adg
CC=golang-dev
https://golang.org/cl/9274043
2013-05-07 11:41:36 -07:00
Andrew Gerrand
61dbc3401a
doc: add FAQ entry about language changes
...
R=golang-dev, dsymonds, r
CC=golang-dev
https://golang.org/cl/9244043
2013-05-06 15:02:56 -07:00
Shenghou Ma
6de184b385
syscall: fix prototype of Fchflags (API change)
...
API change, but the old API is obviously wrong.
R=golang-dev, iant, r, rsc
CC=golang-dev
https://golang.org/cl/9157044
2013-05-07 05:20:00 +08:00
Andrew Gerrand
48c4a87a94
doc: fix formatting in effective go code snippet
...
Fixes #5403 .
R=golang-dev, minux.ma
CC=golang-dev
https://golang.org/cl/9100046
2013-05-03 15:24:05 -04:00
Russ Cox
a941491b4e
doc: only U+FEFF is a byte-order mark; U+FFFE is not
...
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/9103046
2013-05-02 15:01:31 -04:00
Andrew Gerrand
3bd076991b
doc: link to Go 1.1 release notes
...
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/9047045
2013-05-01 10:00:05 -04:00
Andrew Gerrand
e2b2e0d8d1
doc/go1.1: remove discussion of "go run" change
...
Update #5164
R=golang-dev, dave
CC=golang-dev
https://golang.org/cl/9049043
2013-04-30 09:47:23 -04:00
Shenghou Ma
7bec1a6033
all: fix typos
...
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/8896045
2013-04-24 04:46:14 +08:00
Oling Cat
e680710d0e
doc/code.html: remove doubled word; modify the tab to space.
...
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/8919043
2013-04-23 13:13:51 -07:00
Jeremy Jackins
2dd0c03427
doc: fix typo in race_detector.html
...
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/8625044
2013-04-23 13:11:58 -07:00
Shenghou Ma
ed19ab47c3
doc/effective_go.html: fix syntax error in code example
...
Fixes #5333 .
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/8698046
2013-04-24 03:51:31 +08:00
Andrew Gerrand
994c486aa9
doc: fix typo in Effective Go
...
Fixes #5329 .
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/8897044
2013-04-22 16:57:23 +02:00
Jonathan Rudenberg
b0cd458605
doc: add missing <code> to go1.1.html
...
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/8880043
2013-04-21 13:10:19 +02:00
Brad Fitzpatrick
10cdb92000
doc: fix another broken link
...
Fixes #5316
R=golang-dev, r, minux.ma
CC=golang-dev
https://golang.org/cl/8871043
2013-04-19 12:00:40 -07:00
Rob Pike
1f4055a0ec
doc/go1.1.html: document io.ErrNoProgress
...
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/8833050
2013-04-18 17:37:09 -07:00
Brad Fitzpatrick
db6ddff842
doc: fix another broken link
...
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/8763045
2013-04-18 14:48:54 -07:00
Brad Fitzpatrick
12566a60d7
doc: misc tweaks, new links, fix broken links
...
I read docs and wrote a crawler + link checker on the plane,
which also checks for #fragments. I'll send that out later
when it's less gross.
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/8729050
2013-04-18 12:43:23 -07:00
Brad Fitzpatrick
32f2fd15df
doc/go1.1.html, mime/multipart: document quoted-printable decoding
...
Fixes #5293
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/8840043
2013-04-17 13:25:28 -07:00
Rob Pike
a9c695204d
doc: more doubled words
...
I wrote a tool.
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/8695047
2013-04-16 14:20:06 -07:00
Rob Pike
f29013d19b
doc/effective_go: another doubled word
...
It's clear that that should never happen.
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/8798045
2013-04-16 13:59:10 -07:00
Shenghou Ma
86cd1d9e15
doc/effective_go.html: fix typo
...
Fixes #5296 .
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/8682044
2013-04-17 04:41:28 +08:00
Shenghou Ma
80de7ab190
doc/reference.html: update list of sub-repositories.
...
R=golang-dev, bradfitz, r
CC=golang-dev
https://golang.org/cl/8766043
2013-04-16 04:31:25 +08:00
Stefan Nilsson
0009210b2e
doc: fix typo
...
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/8729045
2013-04-14 09:22:57 +10:00
Rob Pike
548c65a568
spec: add another sentence about BOMs
...
Although one may argue that they should be legal, gc (at least)
disallows byte order marks that are not the first code point
in the file. Added a sentence to the "Implementation restriction"
clause in the "Source code representation" section to document
this better.
Lifting this restriction (again - the rule has changed at least
twice already) would not break any existing programs, should
we later decide yet again to fiddle the rules about these little
fly specks.
R=golang-dev, dsymonds, gri
CC=golang-dev
https://golang.org/cl/8649043
2013-04-11 11:33:25 -07:00
Jonathan Rudenberg
f9af491307
doc: fix typos in go1.1.html
...
R=golang-dev, adg, adg
CC=golang-dev
https://golang.org/cl/8488047
2013-04-08 12:04:50 +10:00
Andrew Gerrand
78c4d50d25
doc: document go1.1 build tag
...
Fixes #5235 .
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/8426048
2013-04-08 11:41:01 +10:00
Kamil Kisiel
13d6f8f7f3
godoc: enable visibility of element linked from URL hash
...
Expands the example when visiting a URL such as
http://golang.org/pkg/net/http/#example_Hijacker
Fixes #5212 .
R=golang-dev, bradfitz, adg
CC=golang-dev
https://golang.org/cl/8378043
2013-04-05 08:04:02 +11:00
Andriy Lytvynov
a854535556
doc/code.html: fix typos
...
Fixed example program's output to match program's code.
Fixes #5204 .
R=golang-dev, minux.ma
CC=golang-dev
https://golang.org/cl/8365043
2013-04-04 11:11:54 -07:00
Duncan Holm
52700d24bc
doc: use the already defined GOPATH in PATH
...
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/8248044
2013-04-04 16:36:10 +11:00
Dave Cheney
19cc9f91fa
doc/go1.1.html: mention cgo and cross compilation
...
R=r, minux.ma, bradfitz
CC=golang-dev
https://golang.org/cl/8304043
2013-04-04 16:13:29 +11:00
Andrew Gerrand
485c066222
doc: mention availability of race detector in go1.1 doc
...
R=r
CC=golang-dev
https://golang.org/cl/8301044
2013-04-04 16:10:30 +11:00
Jonathan Rudenberg
2a99f2fb2a
cmd/go: run main package when no files are listed
...
Fixes 5164.
R=golang-dev, iant, adg
CC=golang-dev
https://golang.org/cl/8119049
2013-04-04 12:04:35 +11:00
Dmitriy Vyukov
72d99aec88
doc: fix typos in go1.1
...
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/8342044
2013-04-03 17:03:42 -07:00
Alexei Sholik
5977e34741
doc: fix typos and trailing spaces
...
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/8285044
2013-04-03 16:44:03 -07:00
Andrew Gerrand
e798cd857c
doc: mention godoc.org in "How to Write Go Code"
...
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/8344043
2013-04-04 08:56:11 +11:00
Andrew Gerrand
ee923e3f90
doc: simplify How to write Go code article
...
This version just tells you what to do, rather
than trying to teach you how it all works.
Should be much better for newcomers.
R=dave, gary.burd, alcosholik, r
CC=golang-dev
https://golang.org/cl/8247044
2013-04-04 08:19:24 +11:00
Rob Pike
c4e82bb923
doc: link the race detector document into the release notes
...
Also:
- put GORACE into the go env command
- do minor housekeeping on the race detector article
Fixes #4995 .
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/8319044
2013-04-03 13:56:24 -07:00
Rob Pike
a9e1c8fb41
doc/go1.1.html: document the state of gccgo
...
Fixes #5053 .
R=adg, iant
CC=golang-dev
https://golang.org/cl/8337043
2013-04-03 13:29:06 -07:00
Rob Pike
e0f338cca5
doc/go1.1.html: document os/signal.Stop
...
Also fix the sort order of the laundry list.
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/8325044
2013-04-03 10:59:36 -07:00
Rob Pike
91cb9995c3
doc/go1.1.html: state that the heap is bigger on 64-bit machines
...
Be deliberately vague, since the precise details should not be depended upon.
Fixes #5155 .
R=golang-dev, gri, adg
CC=golang-dev
https://golang.org/cl/8283044
2013-04-03 10:40:33 -07:00
Robert Griesemer
b34f055138
spec: Go has no 'reference types'
...
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/8288044
2013-04-02 23:17:37 -07:00
Dave Cheney
839c4f0159
doc/go1.1.html: additional tweaks
...
R=r, adg, minux.ma
CC=golang-dev
https://golang.org/cl/8250043
2013-04-03 16:49:17 +11:00
Andrew Gerrand
062a86b07d
doc: add prominent download button to getting started page
...
Also remove the introduction, which says what the rest of the
page says anyway.
Fixes #5182 .
R=golang-dev, kamil.kisiel, r
CC=golang-dev
https://golang.org/cl/8281044
2013-04-03 15:59:17 +11:00
Brad Fitzpatrick
751a24e86e
net: delete DialOpt and DialOption; add struct Dialer
...
Per discussions on golang-nuts and golang-dev:
"Some concerns with DialOpt"
https://groups.google.com/d/msg/golang-nuts/Hfh9aqhXyUw/W3uYi8lOdKcJ
https://groups.google.com/d/msg/golang-dev/37omSQeWv4Y/KASGIfPpXh0J
R=golang-dev, google, r
CC=golang-dev
https://golang.org/cl/8274043
2013-04-02 13:24:16 -07:00
Brad Fitzpatrick
4432be3b28
compress/gzip: add Writer.Flush to call flate.Writer's Flush
...
From a discussion on golang-nuts.
R=golang-dev, dsymonds, nigeltao, coocood, adg
CC=golang-dev
https://golang.org/cl/8251043
2013-04-02 09:07:43 -07:00
Dave Cheney
54faecac0b
doc/go1.1.html: add a note about additional platforms
...
Mention support for NetBSD, OpenBSD, and cgo for linux/arm.
R=golang-dev, dvyukov, r, minux.ma, adg, bradfitz, adg
CC=golang-dev
https://golang.org/cl/8152043
2013-04-02 15:08:28 +11:00
Rob Pike
b91ae5c27c
doc/codewalk/markov: fix slice error in description
...
Fixes #5176 .
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/8118046
2013-04-01 15:52:15 -07:00
Shenghou Ma
6e054190f7
doc/go1.1: mention (*testing.B).ReportAllocs()
...
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/8198043
2013-03-31 02:17:25 +08:00
Elias Naur
c1786a9e3b
doc: fix typo in effective_go.html
...
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/7548045
2013-03-29 10:28:37 -07:00
Robert Griesemer
04341b246e
cmd/godoc: cleanups
...
- removed gratuitous empty lines that creeped into command line output
- changed comment color to a dark green so that links don't visually melt into them
- removed some TODOs
- updated doc.go
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/8108044
2013-03-28 13:05:30 -07:00
Rob Pike
48ecfc979f
faq: update with some links and 1.1-specific details
...
R=golang-dev, remyoudompheng, iant
CC=golang-dev
https://golang.org/cl/8038048
2013-03-27 15:26:57 -07:00
Jonathan Rudenberg
0657e7df9f
doc: fix go1.1.html typos
...
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/7635049
2013-03-27 11:09:14 -07:00
Dave Cheney
24c2c88b90
doc: consistent path names in example
...
Always use /home/you for $HOME in examples.
Trivial enough that someone else can integrate this change if they are editing go1.1.html
R=r
CC=golang-dev
https://golang.org/cl/8025043
2013-03-27 09:22:23 +11:00
Rob Pike
a101bfc620
doc/go1.1.html: net/mail, net/smtp
...
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/7835049
2013-03-26 11:47:27 -07:00
Rob Pike
237b8b8b66
doc/go1.1.html: describe Zone and other net changes
...
Mild adaptation of rsc's 8021043, which I was unable to clpatch.
(rsc is offline)
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/7741049
2013-03-26 10:54:55 -07:00
Andrew Gerrand
a52855535a
doc: fix typo in go 1.1 doc
...
R=golang-dev, iant
CC=golang-dev
https://golang.org/cl/7725049
2013-03-26 09:37:17 -07:00
David Symonds
1e0e65ea59
doc/articles: update reference to obsolete "package documentation".
...
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/7475048
2013-03-26 13:01:24 +11:00
Rob Pike
4529c047b8
doc/go1.1.html: introduction
...
R=golang-dev, adg, bradfitz
CC=golang-dev
https://golang.org/cl/7696045
2013-03-25 17:41:12 -07:00
Brad Fitzpatrick
35c85321cc
doc: add summary of net/http additions to Go 1.1
...
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/7812050
2013-03-25 15:17:44 -07:00
Brad Fitzpatrick
fc4c5b14ef
doc: add DialOpt and friends to go1.1.html
...
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/7725048
2013-03-25 10:31:19 -07:00
Rob Pike
4c48e4ecb5
doc/go1.1.html: performance
...
An overview is all that's required.
R=golang-dev, remyoudompheng, bradfitz, adg
CC=golang-dev
https://golang.org/cl/7577050
2013-03-23 08:29:59 -07:00
Robert Griesemer
259e8cec7a
doc/go1.1.html: fix broken links
...
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/7834049
2013-03-22 16:41:27 -07:00
Rob Pike
bfeb79bae5
doc/go1.1.html: blockprofile, method values, ListenUnixgram, etc.
...
R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/7496051
2013-03-22 15:45:16 -07:00
Robert Griesemer
462a17e0f3
spec: remove most §links for the now more common in-text links
...
Also:
- more consistenly use "xxx" statement rather than <code>xxx</code> statement
- fix/remove unnecessary links
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/7821050
2013-03-22 15:36:04 -07:00
Rob Pike
7191ef7199
doc/go1.1.html: return requirements
...
R=golang-dev, rsc, jeremyjackins, gri
CC=golang-dev
https://golang.org/cl/7838045
2013-03-22 14:51:22 -07:00
Rob Pike
d02089101c
spec: add example showing missing return statement
...
Will help people find the rules by searching the spec by
having a comment saying "missing return";
"terminating statement" does not evoke the rule to the
uninitiated.
R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/7838044
2013-03-22 10:03:55 -07:00
Rob Pike
d88133137b
go1.1.html: bufio.Scanner and reflect; more about surrogates
...
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/7958043
2013-03-21 22:37:13 -07:00
Russ Cox
aafc444b74
debug/elf: restore Go 1.0 semantics for (*File).Symbols
...
Also adjust the implementation of applyRelocationsAMD64
so that the test added in CL 6848044 still passes.
R=golang-dev, minux.ma
CC=golang-dev
https://golang.org/cl/7686049
2013-03-21 17:01:39 -04:00
Rob Pike
178d8d4f7a
doc/go1.1.html: more TODOs done
...
Only the net stuff remains as significant work in the "minor changes" section.
R=golang-dev, dave, elias.naur, rsc
CC=golang-dev
https://golang.org/cl/7933044
2013-03-21 13:51:49 -07:00
Rob Pike
b636f192e2
spec: fix description of initialization
...
The analysis does not depend on the values of the items.
Fixes #4648 .
R=golang-dev, gri, rsc
CC=golang-dev
https://golang.org/cl/7593050
2013-03-20 15:05:28 -07:00
Russ Cox
6e15683cae
spec: define method values
...
Fixes #2280 .
R=golang-dev, r, bradfitz, iant, andybalholm, gri
CC=golang-dev
https://golang.org/cl/7816045
2013-03-20 16:54:07 -04:00
Rob Pike
ee5a794fbb
doc/go1.1.html: add links to the text, write some new sections
...
R=golang-dev, rsc, dave
CC=golang-dev
https://golang.org/cl/7914043
2013-03-19 16:40:19 -07:00
Rob Pike
b89a2bcf01
doc/go1.1.html: document the surrogate and BOM changes
...
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/7853048
2013-03-18 22:50:32 -07:00
Rob Pike
f005eddb3a
doc/go1.1.html: document some of the library changes.
...
Still much to do, but this is a start.
R=golang-dev, adg, bradfitz, remyoudompheng
CC=golang-dev
https://golang.org/cl/7729046
2013-03-18 15:27:05 -07:00
Robert Griesemer
58e21ddaf9
spec: remove special int rule for shifts
...
The rule is not concistently followed by gc.
It appears that gccgo is ignoring it. go/types
does not implement this rule. However, both
gccgo and now go/types can compile/type-check
the entire std library (and thus all the shift
expressions occuring in it) w/o errors. For
more details see the discussion in issue 4883.
Fixes #4880 .
Fixes #4881 .
Fixes #4883 .
R=rsc, r, iant, ken, ken, mtj, rogpeppe
CC=golang-dev
https://golang.org/cl/7707043
2013-03-15 13:55:50 -07:00
Herbert Georg Fischer
99021b767f
doc: explain why cmd/go uses https for repositories and how to work around it
...
Fixes #3418 .
R=golang-dev, r
CC=adg, golang-dev
https://golang.org/cl/7712045
2013-03-15 13:43:10 -07:00
Rob Pike
09cd13c51d
doc/go_faq.html: add entry about pointer to interface
...
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/7546050
2013-03-15 11:38:50 -07:00
Mike Rosset
b4afe88973
doc: clarify that gccgo is a GCC front-end
...
R=golang-dev, r, iant, iant
CC=golang-dev
https://golang.org/cl/6454072
2013-03-12 17:12:56 -07:00
Rob Pike
c34050fd53
spec: rewrite the description of panic and recover.
...
The old description was misleading and inaccurate.
Fixes #4774 .
R=iant, rsc, gri
CC=golang-dev
https://golang.org/cl/7761044
2013-03-12 14:28:16 -07:00
Rob Pike
9dfcfb9385
effective_go.html: fix semaphore example
...
It didn't work properly according to the Go memory model.
Fixes #5023 .
R=golang-dev, dvyukov, adg
CC=golang-dev
https://golang.org/cl/7698045
2013-03-12 10:53:01 -07:00
Robert Griesemer
b66df0e9ba
spec: typed indices must be of integer type
...
The same rules apply for make arguments.
R=r, rsc, iant, ken
CC=golang-dev
https://golang.org/cl/7656043
2013-03-11 09:20:52 -07:00
Robert Griesemer
c729ed631f
spec: result type of a comparison is always untyped bool
...
For details see the cited issue.
Fixes #4793 .
R=rsc, r, iant, ken
CC=golang-dev
https://golang.org/cl/7524044
2013-03-11 09:16:29 -07:00
Rick Arnold
cea78cb58e
doc/contribute: add instructions to fix codereview on windows
...
Tell Windows users how to update Mercurial's library.zip to add some missing dependencies.
Fixes #4745 .
R=golang-dev, patrick.allen.higgins, minux.ma, adg
CC=golang-dev
https://golang.org/cl/7558043
2013-03-11 12:14:42 +11:00
Rob Pike
33e8ca4d67
effective_go.html: add a section on type assertions
...
The information was missing, oddly enough.
R=golang-dev, rsc, iant
CC=golang-dev
https://golang.org/cl/7636044
2013-03-08 13:53:17 -08:00
Rob Pike
9e329a0d16
effective_go.html: move and rework the blank identifier section
...
Also rename the relevant examples and make sure the working one compiles.
R=golang-dev, bradfitz, adg, iant, rsc
CC=golang-dev
https://golang.org/cl/7597043
2013-03-08 10:41:20 -08:00
Robert Griesemer
51338095eb
spec: clarify unsafe.Offsetof
...
Fixes #4905 .
R=rsc, r, iant, ken
CC=golang-dev
https://golang.org/cl/7583043
2013-03-07 20:11:37 -08:00