summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* spec: add comment marker for consistency.David Symonds2014-12-041-1/+1
| | | | | | | LGTM=r R=gri, r CC=golang-codereviews https://codereview.appspot.com/185830043
* doc: tidy up "Projects" page; add Go 1.4Andrew Gerrand2014-11-251-13/+8
| | | | | | | LGTM=r R=r CC=golang-codereviews https://codereview.appspot.com/182750043
* doc/go1.4.html: rewrite first sentence to make it clearerRob Pike2014-11-181-5/+5
| | | | | | | | | The grammar was atrocious, probably the victim of an editing error. LGTM=bradfitz R=bradfitz CC=golang-codereviews https://codereview.appspot.com/178910043
* doc: fix small typo in docYasuhiro Matsumoto2014-11-141-1/+1
| | | | | | | | | LGTM=adg R=golang-codereviews, adg CC=golang-codereviews https://codereview.appspot.com/170660043 Committer: Andrew Gerrand <adg@golang.org>
* spec: method selectors don't auto-deref named pointer typesRobert Griesemer2014-11-111-26/+42
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Language clarification. The existing rules for selector expressions imply automatic dereferencing of pointers to struct fields. They also implied automatic dereferencing of selectors denoting methods. In almost all cases, such automatic dereferencing does indeed take place for methods but the reason is not the selector rules but the fact that method sets include both methods with T and *T receivers; so for a *T actual receiver, a method expecting a formal T receiver, also accepts a *T (and the invocation or method value expression is the reason for the auto-derefering). However, the rules as stated so far implied that even in case of a variable p of named pointer type P, a selector expression p.f would always be shorthand for (*p).f. This is true for field selectors f, but cannot be true for method selectors since a named pointer type always has an empty method set. Named pointer types may never appear as anonymous field types (and method receivers, for that matter), so this only applies to variables declared of a named pointer type. This is exceedingly rare and perhaps shouldn't be permitted in the first place (but we cannot change that). Amended the selector rules to make auto-deref of values of named pointer types an exception to the general rules and added corresponding examples with explanations. Both gc and gccgo have a bug where they do auto-deref pointers of named types in method selectors where they should not: See http://play.golang.org/p/c6VhjcIVdM , line 45. Fixes issue 5769. Fixes issue 8989. LGTM=r, rsc R=r, rsc, iant, ken CC=golang-codereviews https://codereview.appspot.com/168790043
* doc/gopher: add jpgs of the 5th anniversary imageRob Pike2014-11-111-0/+0
| | | | | | | LGTM=adg R=golang-codereviews, adg CC=golang-codereviews https://codereview.appspot.com/172980043
* doc: update go1.4.html's minor library changes.Nigel Tao2014-11-111-0/+55
| | | | | | | LGTM=r R=r CC=golang-codereviews https://codereview.appspot.com/173920043
* all: use golang.org/x/... import pathsAndrew Gerrand2014-11-107-105/+115
| | | | | | | LGTM=rsc, r R=r, rsc CC=golang-codereview, golang-codereviews https://codereview.appspot.com/168050043
* doc/go1.4.html: leave stack size at 2 kBRuss Cox2014-11-061-1/+0
| | | | | | | LGTM=r R=khr, r CC=golang-codereviews https://codereview.appspot.com/165590043
* doc: change "/s/..." links to be on golang.orgRuss Cox2014-11-061-8/+8
| | | | | | | | | | | | | | | People viewing this locally will not have a /s/ on their local godoc. tip.golang.org doesn't have one either. Also change all golang.org links to https, to avoid mixed content warnings when viewing https://golang.org/. Fixes issue 9028. LGTM=bradfitz, r R=r, bradfitz CC=adg, golang-codereviews https://codereview.appspot.com/168250043
* doc/go1.4.html: document new subrepo import pathsRuss Cox2014-11-051-9/+27
| | | | | | | LGTM=r, adg R=adg, r, 0xjnml, dr.volker.dobler CC=golang-codereviews https://codereview.appspot.com/166980044
* doc: document go get -f flag in 1.4 release notesAndrew Gerrand2014-11-031-0/+9
| | | | | | | LGTM=r, rsc R=r, rsc, adg CC=golang-codereviews https://codereview.appspot.com/168890043
* doc/go1.4.html: tweak http.Transport.DialTLS wordingBrad Fitzpatrick2014-10-301-2/+2
| | | | | | | | | It doesn't simplify, because it wasn't even possible before. LGTM=r R=r CC=golang-codereviews https://codereview.appspot.com/164250043
* doc/go1.4.html: fix typoMikio Hara2014-10-301-1/+1
| | | | | | | LGTM=adg R=r, adg CC=golang-codereviews https://codereview.appspot.com/165890043
* doc/go1.4.html: final library changesRob Pike2014-10-291-21/+129
| | | | | | | | | First draft now complete. LGTM=rsc R=golang-codereviews, rsc CC=golang-codereviews https://codereview.appspot.com/170750043
* doc/go1.4.html: gccgo statusRob Pike2014-10-291-9/+8
| | | | | | | LGTM=iant, cmang R=cmang, iant, rsc CC=golang-codereviews https://codereview.appspot.com/169760043
* doc/go1.4.html: half of the small library changesRob Pike2014-10-291-31/+135
| | | | | | | LGTM=rsc R=golang-codereviews, rsc CC=golang-codereviews https://codereview.appspot.com/165090043
* doc/go1.4.html: GODEBUG and assembler changesRob Pike2014-10-281-9/+56
| | | | | | | LGTM=rsc R=golang-codereviews, rsc CC=golang-codereviews https://codereview.appspot.com/160660046
* doc/go1.4.html: breaking compiler change, no plugins in miscRob Pike2014-10-281-6/+50
| | | | | | | LGTM=rsc R=golang-codereviews, rsc CC=golang-codereviews https://codereview.appspot.com/166850043
* doc/asm: explain coordination with garbage collectorRuss Cox2014-10-281-20/+111
| | | | | | | | | | | Also a few other minor changes. Fixes issue 8712. LGTM=r R=r CC=golang-codereviews https://codereview.appspot.com/164150043
* doc/go1.4.html: new portsRob Pike2014-10-281-8/+31
| | | | | | | LGTM=rsc, aram, minux R=golang-codereviews, aram, minux, rsc CC=golang-codereviews https://codereview.appspot.com/162370045
* doc/go1.4.html: vanity imports and internal packagesRob Pike2014-10-281-14/+93
| | | | | | | LGTM=rsc R=golang-codereviews, rsc CC=golang-codereviews https://codereview.appspot.com/165800043
* doc/go1.4.html: much of the go command's changesRob Pike2014-10-271-38/+114
| | | | | | | | | still need to do internal and import comments LGTM=adg R=golang-codereviews, adg CC=golang-codereviews https://codereview.appspot.com/160600043
* doc/go1.4.html: runtime and performanceRob Pike2014-10-271-4/+77
| | | | | | | LGTM=adg, rsc R=golang-codereviews, adg, bradfitz, dave, rsc CC=golang-codereviews https://codereview.appspot.com/164090044
* doc/go_mem.html: don't be cleverRob Pike2014-10-271-0/+23
| | | | | | | | | | | | Add a short introductory section saying what most Go programmers really need to know, which is that you shouldn't have to read this document to understand the behavior of your program. LGTM=bradfitz, adg, tracey.brendan, iant, rsc, dsymonds R=golang-codereviews, bradfitz, tracey.brendan, adg, iant, rsc, dsymonds CC=golang-codereviews https://codereview.appspot.com/158500043
* spec: permit parentheses around builtin function namesRobert Griesemer2014-10-271-11/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Not a language change. This is simply documenting the status quo which permits builtin function names to be parenthesized in calls; e.g., both len(s) and (((len)))(s) are accepted by all compilers and go/types. Changed the grammar by merging the details of BuiltinCall with ordinary Calls. Also renamed the Call production to Arguments which more clearly identifies that part of the grammar and also matches better with its counterpart on the declaration side (Parameters). The fact that the first argument can be a type (for builtins) or cannot be a type (for regular function calls) is expressed in the prose, no need to make the grammar more complicated. Fixes issue 9001. LGTM=iant, r, rsc R=r, rsc, iant, ken, dave CC=golang-codereviews https://codereview.appspot.com/160570043
* doc/go1.4.html: first pieces of release notesRob Pike2014-10-272-53/+256
| | | | | | | | | | Move the release notes into an HTML file. Start writing the text. LGTM=rsc R=golang-codereviews, bradfitz, kamil.kisiel, tracey.brendan, rsc CC=golang-codereviews https://codereview.appspot.com/161350043
* doc/go_faq.html: fix a couple of nitsRob Pike2014-10-261-2/+2
| | | | | | | | | Wrong article, one stylistic point that bothers someone (but not me). LGTM=bradfitz R=golang-codereviews, bradfitz CC=golang-codereviews https://codereview.appspot.com/156680043
* doc/go1.4.txt: unsafe is outside go1 compatibility guaranteesRob Pike2014-10-241-1/+2
| | | | | CC=golang-codereviews https://codereview.appspot.com/164770043
* unsafe: document that unsafe programs are not protectedRob Pike2014-10-241-0/+8
| | | | | | | | | | | | The compatibility guideline needs to be clear about this even though it means adding a clause that was not there from the beginning. It has always been understood, so this isn't really a change in policy, just in its expression. LGTM=bradfitz, gri, rsc R=golang-codereviews, bradfitz, gri, rsc CC=golang-codereviews https://codereview.appspot.com/162060043
* doc/go1.4: encoding/csvRuss Cox2014-10-241-0/+1
| | | | | CC=golang-codereviews https://codereview.appspot.com/162140043
* spec: minimal documention of unsafe.Pointer conversionsRobert Griesemer2014-10-231-5/+6
| | | | | | | | | | | | Per suggestion from rsc as a result of the dicussion of (abandoned) CL 153110044. Fixes issue 7192. LGTM=r, rsc, iant R=r, rsc, iant, ken CC=golang-codereviews https://codereview.appspot.com/163050043
* gccgo_install.html: the 4.9 release series supports Go 1.2Ian Lance Taylor2014-10-221-0/+4
| | | | | | | LGTM=bradfitz R=golang-codereviews, bradfitz CC=golang-codereviews https://codereview.appspot.com/163760043
* doc/go1.4.txt: add compress/* Reset noteBrad Fitzpatrick2014-10-201-0/+1
| | | | | CC=golang-codereviews https://codereview.appspot.com/156430043
* doc/go1.4.txt: flags can now be set at most onceRob Pike2014-10-191-0/+1
| | | | | CC=golang-codereviews https://codereview.appspot.com/161820043
* spec: define "variable"Robert Griesemer2014-10-161-25/+78
| | | | | | | | | Fixes issue 8496. LGTM=rsc, r, iant R=r, rsc, iant, ken CC=golang-codereviews https://codereview.appspot.com/148580043
* go1.4: add note about change to bufio.SplitFunc at EOFIan Lance Taylor2014-10-121-0/+1
| | | | | CC=golang-codereviews https://codereview.appspot.com/159800044
* doc: use "keyed" instead of "tagged" in Go 1 compatibility docAndrew Gerrand2014-10-081-5/+5
| | | | | | | LGTM=bradfitz, r R=r, bradfitz CC=golang-codereviews https://codereview.appspot.com/156730043
* doc/go1.4.txt: useless change to tickle buildersBrad Fitzpatrick2014-10-061-1/+1
| | | | | | | | Debugging the builders and need a commit to make them run. R=adg CC=golang-codereviews https://codereview.appspot.com/149600043
* doc/go1.4.txt: GOOS suffixes require underscores to act as build tagsRob Pike2014-10-061-0/+1
| | | | | CC=golang-codereviews https://codereview.appspot.com/151490043
* doc/go1.4: document memory consumption reductionDmitriy Vyukov2014-10-041-1/+1
| | | | | | R=golang-codereviews, bradfitz CC=golang-codereviews https://codereview.appspot.com/149370043
* doc/go1.4.txt: fmt: document printing of &map rather than just pointerRob Pike2014-10-031-0/+1
| | | | | CC=golang-codereviews https://codereview.appspot.com/152160043
* doc/go1.4: mention that we are going to need a new version of SWIGIan Lance Taylor2014-10-031-0/+1
| | | | | | | Update issue 8750 CC=golang-codereviews https://codereview.appspot.com/153950044
* doc/go_faq.html: explain the policy about unused imports a little betterRob Pike2014-10-011-5/+8
| | | | | | | | | This new text won't stop the whining but it might focus the whining a little more. LGTM=adg R=golang-codereviews, adg CC=golang-codereviews https://codereview.appspot.com/146680044
* doc: document go1.3.3Andrew Gerrand2014-10-011-0/+5
| | | | | | | LGTM=r R=r CC=golang-codereviews https://codereview.appspot.com/149280044
* spec: clarify variable declaration type rulesRobert Griesemer2014-09-301-33/+48
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Not a language change. Several inaccuracies were fixed: 1) A variable declaration may declare more than just one variable. 2) Variable initialization follows the rules of assignments, including n:1 assignments. The existing wording implied a 1:1 or n:n rule and generally was somewhat unspecific. 3) The rules for variable declarations with no types and untyped initialization expressions had minor holes (issue 8088). 4) Clarified the special cases of assignments of untyped values (we don't just have untyped constants, but also untyped bools, e.g. from comparisons). The new wording is more direct. To that end, introduced the notion of an untyped constant's "default type" so that the same concept doesn't have to be repeatedly introduced. Fixes issue 8088. LGTM=iant, r, rsc R=r, rsc, iant, ken CC=golang-codereviews https://codereview.appspot.com/142320043
* spec: specify variable initialization order explicitlyRobert Griesemer2014-09-291-16/+37
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The existing spec rules on package initialization were contradictory: They specified that 1) dependent variables are initialized in dependency order, and 2) independent variables are initialized in declaration order. This 2nd rule cannot be satisfied in general. For instance, for var ( c = b + 2 a = 0 b = 1 ) because of its dependency on b, c must be initialized after b, leading to the partial order b, c. Because a is independent of b but is declared before b, we end up with the order: a, b, c. But a is also independent of c and is declared after c, so the order b, c, a should also be valid in contradiction to a, b, c. The new rules are given in form of an algorithm which outlines initialization order explicitly. gccgo and go/types already follow these rules. Fixes issue 8485. LGTM=iant, r, rsc R=r, rsc, iant, ken, gordon.klaus, adonovan CC=golang-codereviews https://codereview.appspot.com/142880043
* doc/faq: update for 1.4Rob Pike2014-09-271-15/+38
| | | | | | | LGTM=iant R=golang-codereviews, bradfitz, iant CC=golang-codereviews https://codereview.appspot.com/150190043
* doc/go1.4: go test builds + links all test files (CL 150980043)Russ Cox2014-09-261-0/+1
| | | | | CC=golang-codereviews https://codereview.appspot.com/144660043
* doc/go1.4: add some cmd/go changesRuss Cox2014-09-261-0/+2
| | | | | CC=golang-codereviews https://codereview.appspot.com/143650043
View Lorry Controller Status