1
0
mirror of https://github.com/golang/go synced 2024-11-17 22:14:43 -07:00
Commit Graph

1763 Commits

Author SHA1 Message Date
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