qbit/go
1
0
Fork 0
mirror of https://github.com/golang/go synced 2024-11-21 16:54:46 -07:00
Code Releases Activity
12,363 Commits 58 Branches 402 Tags 522 MiB
a22b0f82a2
Commit Graph

1284 Commits

Author SHA1 Message Date
Andrew Gerrand
4068e3fc70 doc: remove file.go from run (fix windows build) 
R=golang-dev, r, alex.brainman, r
CC=golang-dev
https://golang.org/cl/5479069
 2011-12-12 16:14:38 +11:00
Rob Pike
b78a7b7dab doc/go_tutorial: make clear the file example is Unix-specific 
Fixes #2553.

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/5472074
 2011-12-11 21:03:49 -08:00
Andrew Gerrand
49d82b4ca1 doc: add Defer, Panic, and Recover article 
Originally published on The Go Programming Language Blog, August 4 2010.

http://blog.golang.org/2010/08/defer-panic-and-recover.html

Update #2547

R=golang-dev, r, r
CC=golang-dev
https://golang.org/cl/5479053
 2011-12-12 13:15:29 +11:00
Lucio De Re
90913cf170 Housekeeping: Cleaning up the clean-up process. 
src/clean.bash:
        Add clean-ups for previously overlooked directories.
doc/codelab/wiki/Makefile:
        Dropped "index.html" from CLEANFILES so it will not be
        deleted on cleaning.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5476050
 2011-12-11 09:23:17 -08:00
Robert Hencke
1084ab98b7 spec: adjust complex constant example 
Fixes https://golang.org/cl/5444053/#msg41

R=golang-dev, iant
CC=golang-dev
https://golang.org/cl/5478058
 2011-12-10 10:04:33 -08:00
Rob Pike
71ccf73a74 doc/go1: syscalls, strconv 
R=rsc
CC=golang-dev
https://golang.org/cl/5472054
 2011-12-09 14:12:51 -08:00
Rob Pike
2e338fa69f doc/go1: the rest of the language changes 
R=rsc
CC=golang-dev
https://golang.org/cl/5478047
 2011-12-09 08:31:57 -08:00
Rob Pike
940c25faa4 tmpltohtml: feature for easier snippet extraction 
Lines that end with OMIT are omitted from the output.
A comment such as
        // Example stops here. OMIT
can be used as a marker but not appear in the output.

R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/5477050
 2011-12-09 08:31:04 -08:00
Russ Cox
ef1c535727 spec: examples of untyped boolean, string constants 
This is a spec correction, not a language change.
The implementations have behaved like this for years
(and there are tests to that effect), and elsewhere in
the spec true and false are defined to be untyped
boolean constants.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5477047
 2011-12-09 00:13:19 -05:00
Russ Cox
6a47bb4974 spec: remove redundant, outdated definition of default literal types 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5480047
 2011-12-09 00:12:49 -05:00
Russ Cox
d7f050a73e spec: rune is now an alias for int32 
R=golang-dev, dsymonds, r
CC=golang-dev
https://golang.org/cl/5467048
 2011-12-09 00:11:43 -05:00
Charles L. Dorian
9a358df947 spec: fix typo in example comment 
R=rsc, golang-dev
CC=golang-dev
https://golang.org/cl/5475046
 2011-12-08 22:27:14 -05:00
Russ Cox
a933635579 spec: var x = 'a' defaults to type rune 
R=gri, r, r, adg, iant, ken
CC=golang-dev
https://golang.org/cl/5444053
 2011-12-08 21:48:19 -05:00
Rob Pike
136c04f71a doc/go1: most of the simple language changes 
R=rsc, adg, r
CC=golang-dev
https://golang.org/cl/5477044
 2011-12-08 16:39:05 -08:00
Rob Pike
9d59c40eab doc/go1: document rearranged package hierarchy 
Some exciting HTML and CSS here.

R=remyoudompheng, rsc, r
CC=golang-dev
https://golang.org/cl/5460047
 2011-12-08 11:35:28 -08:00
Rob Pike
1ddedbae31 tmpltohtml: put a DO NOT EDIT mark automatically in the output 
R=r, rsc, r
CC=golang-dev
https://golang.org/cl/5469045
 2011-12-08 11:26:49 -08:00
Rob Pike
2fa987b6cd doc/go1: map deletion 
This CL is in part a proposal for how to write these sections:
- Brief discussion of change
- No attempt to analyze the thinking about it
- Old code
- New code, runnable if possible
- How to update old programs

R=golang-dev, remyoudompheng, gri, adg
CC=golang-dev
https://golang.org/cl/5454044
 2011-12-07 16:11:17 -08:00
Rob Pike
bab4dec142 doc: skeleton for release note document 
No content yet other than titles and an introductory paragraph.
Once this is in, content can arise as separate manageable CLs.

R=rsc
CC=golang-dev
https://golang.org/cl/5435090
 2011-12-07 14:33:37 -08:00
Andrew Gerrand
8d1da1c66a doc: fix weekly.2011-12-06 release notes typo 
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/5453072
 2011-12-07 13:33:59 +11:00
Andrew Gerrand
0367eebb05 weekly.2011-12-06 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5453070
 2011-12-07 13:15:10 +11:00
Russ Cox
2666b815a3 use new strconv API 
All but 3 cases (in gcimporter.go and hixie.go)
are automatic conversions using gofix.

No attempt is made to use the new Append functions
even though there are definitely opportunities.

R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/5447069
 2011-12-05 15:48:46 -05:00
Russ Cox
98553f1422 spec: remove contentious composite literal shortening 
R=gri, r, gustavo, r
CC=golang-dev
https://golang.org/cl/5451099
 2011-12-05 14:22:23 -05:00
Russ Cox
5f49456465 spec: additional composite literal shortenings per Go 1 plan 
R=golang-dev, gri, r, r
CC=golang-dev
https://golang.org/cl/5449067
 2011-12-02 14:12:53 -05:00
Russ Cox
8a8445ba71 spec: pointer to array can be sliced 
This has always been true, but we lost it from the spec
somewhere along the way, probably when we disallowed
the general 'pointer to anything sliceable' slice case.

R=gri
CC=golang-dev
https://golang.org/cl/5437121
 2011-12-02 13:11:30 -05:00
Russ Cox
da5a251dde doc: do not slice array literal 
The special case in the spec is that you can take the
address of a composite literal using the & operator.

A composite literal is not, however, generally addressable,
and the slice operator requires an addressable argument,
so [3]int{1,2,3}[:] is invalid.  This tutorial code and one bug
report are the only places in the tree where it appears.

R=r, gri
CC=golang-dev
https://golang.org/cl/5437120
 2011-12-02 12:30:37 -05:00
Russ Cox
4dfe976d97 spec: avoid slice of array literal 
R=gri
CC=golang-dev
https://golang.org/cl/5451078
 2011-12-02 12:30:20 -05:00
Andrew Gerrand
517503dab8 doc: correct weekly snapshot notes on hash.Hash change 
I had the wrong idea when I wrote this.

R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/5437111
 2011-12-02 13:36:21 +11:00
Andrew Gerrand
7af813a7f2 weekly.2011-12-02 
R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/5447067
 2011-12-02 08:09:49 +11:00
Volker Dobler
a6729b3085 go/doc: Detect headings in comments and format them as h3 in html. 
To structure larger sections of comments in html output headings
are detected in comments and formated as h3 in the generated html.
A simple heuristic is used to detect headings in comments:
A heading is a non-blank, non-indented line preceded by a blank
line. It is followed by a blank and a non-blank, non-indented line.
A heading must start with an uppercase letter and end with a letter,
digit or a colon.  A heading may not contain punctuation characters.

R=jan.mercl, gri, adg, rsc, r
CC=golang-dev
https://golang.org/cl/5437056
 2011-12-01 09:49:58 -08:00
Andrew Gerrand
9dd07f680a weekly.2011-12-01 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5448067
 2011-12-01 16:17:24 +11:00
David Symonds
72a2979ef0 spec: update spacing to match gofmt, where reasonable. 
R=gri, rsc
CC=golang-dev
https://golang.org/cl/5327053
 2011-11-29 15:47:36 -08:00
Christopher Wedgwood
62203141ac doc/tmptohtml: output fix 
R=r, gri
CC=golang-dev
https://golang.org/cl/5441047
 2011-11-28 09:50:40 -08:00
Rob Pike
d1324d8a7a effective_go: remove unused variable from a couple of examples 
Fixes #2481.

R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/5435068
 2011-11-24 08:51:47 -08:00
Rob Pike
f56db6f534 text/template: new, simpler API 
The Set type is gone. Instead, templates are automatically associated by
being parsed together; nested definitions implicitly create associations.
Only associated templates can invoke one another.

This approach dramatically reduces the breadth of the construction API.

For now, html/template is deleted from src/pkg/Makefile, so this can
be checked in. Nothing in the tree depends on it. It will be updated next.

R=dsymonds, adg, rsc, r, gri, mikesamuel, nigeltao
CC=golang-dev
https://golang.org/cl/5415060
 2011-11-23 20:17:22 -08:00
Rob Pike
422e247332 tutorial: update go_tutorial.html 
There's version skew with respect to the programs in doc/progs.

R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/5433048
 2011-11-22 11:53:30 -08:00
Russ Cox
6e3e380923 allow direct conversion between string and named []byte, []rune 
The allowed conversions before and after are:
        type Tstring string
        type Tbyte []byte
        type Trune []rune

        string <-> string  // ok
        string <-> []byte  // ok
        string <-> []rune // ok
        string <-> Tstring // ok
        string <-> Tbyte // was illegal, now ok
        string <-> Trune // was illegal, now ok

        Tstring <-> string  // ok
        Tstring <-> []byte  // ok
        Tstring <-> []rune // ok
        Tstring <-> Tstring // ok
        Tstring <-> Tbyte // was illegal, now ok
        Tstring <-> Trune // was illegal, now ok

Update spec, compiler, tests.  Use in a few packages.

We agreed on this a few months ago but never implemented it.

Fixes #1707.

R=golang-dev, gri, r
CC=golang-dev
https://golang.org/cl/5421057
 2011-11-22 12:30:02 -05:00
Andrew Gerrand
3af28bd886 weekly.2011-11-18 
R=golang-dev, dsymonds, r
CC=golang-dev
https://golang.org/cl/5416045
 2011-11-19 07:20:02 +11:00
Russ Cox
ab957154b6 codereview: undo last night's rollback 
Update version check from 1.4 to 1.9.  Suggest 2.0.

R=golang-dev, r, r
CC=golang-dev
https://golang.org/cl/5413046
 2011-11-18 12:58:44 -05:00
Andrew Gerrand
0bbbb44e99 doc: link to Chinese translation of A Tour of Go 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/5415046
 2011-11-18 15:22:48 +11:00
Russ Cox
d03611f628 allow copy of struct containing unexported fields 
An experiment: allow structs to be copied even if they
contain unexported fields.  This gives packages the
ability to return opaque values in their APIs, like reflect
does for reflect.Value but without the kludgy hacks reflect
resorts to.

In general, we trust programmers not to do silly things
like *x = *y on a package's struct pointers, just as we trust
programmers not to do unicode.Letter = unicode.Digit,
but packages that want a harder guarantee can introduce
an extra level of indirection, like in the changes to os.File
in this CL or by using an interface type.

All in one CL so that it can be rolled back more easily if
we decide this is a bad idea.

Originally discussed in March 2011.
https://groups.google.com/group/golang-dev/t/3f5d30938c7c45ef

R=golang-dev, adg, dvyukov, r, bradfitz, jan.mercl, gri
CC=golang-dev
https://golang.org/cl/5372095
 2011-11-15 12:20:59 -05:00
Joel Sing
6687e52ab1 doc/install: add openbsd 
Add openbsd to the $GOOS list.

R=golang-dev, r, rsc
CC=golang-dev
https://golang.org/cl/4964053
 2011-11-14 07:52:36 -08:00
Alex Brainman
36494b0acd doc/progs: fix windows version to satisfy new error 
R=rsc
CC=golang-dev
https://golang.org/cl/5376089
 2011-11-14 20:53:03 +11:00
Russ Cox
efb74460c3 spec: disallow general func, map comparisons 
R=golang-dev, gri, r, r
CC=golang-dev
https://golang.org/cl/5369090
 2011-11-13 22:57:45 -05:00
Russ Cox
c017a8299f syscall: use error 
- syscall (not os) now defines the Errno type.
- the low-level assembly functions Syscall, Syscall6, and so on
  return Errno, not uintptr
- syscall wrappers all return error, not uintptr.

R=golang-dev, mikioh.mikioh, r, alex.brainman
CC=golang-dev
https://golang.org/cl/5372080
 2011-11-13 22:44:52 -05:00
Rob Pike
a50ee009f7 tutorial: describe unidirectional channels 
R=golang-dev, adg, gri
CC=golang-dev
https://golang.org/cl/5370058
 2011-11-10 14:02:14 -08:00
Rob Pike
bb66164542 effective_go: a little more about comma ok and type assertion 
Fixes #2416.

R=golang-dev, iant
CC=golang-dev
https://golang.org/cl/5370049
 2011-11-09 16:14:18 -08:00
Rob Pike
a9aef26a55 effective_go: fix up the description of cipher blocks and streams 
R=golang-dev, r, agl, dsymonds
CC=golang-dev
https://golang.org/cl/5374046
 2011-11-09 14:40:49 -08:00
Rob Pike
217408abf3 crypto: update incorrect references to Cipher interface; should be Block. 
R=gri, rsc, r
CC=golang-dev
https://golang.org/cl/5372050
 2011-11-09 14:22:44 -08:00
Rob Pike
f6615f1b5d FAQ: rearrange and expand the discussion of testing 
R=gri, r, bradfitz, rsc
CC=golang-dev
https://golang.org/cl/5369052
 2011-11-09 13:19:23 -08:00
Russ Cox
98321731f2 doc: htmlescape weekly notes 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5370046
 2011-11-09 13:52:02 -05:00
David Symonds
e5373c01f8 doc: fix anchor ID in weekly.html. 
R=adg, rsc
CC=golang-dev
https://golang.org/cl/5359055
 2011-11-09 15:43:21 +11:00
Rob Pike
8649444002 FAQ: update 
R=bradfitz, r, dsymonds, edsrzf, rsc
CC=golang-dev
https://golang.org/cl/5345055
 2011-11-08 16:26:03 -08:00
Andrew Gerrand
d83cc435e4 weekly.2011-11-09 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5344055
 2011-11-09 10:57:09 +11:00
Rob Pike
f9489bed72 renaming_4: gofix -r everything/but/src/pkg 
R=rsc
CC=golang-dev
https://golang.org/cl/5338043
 2011-11-08 15:43:02 -08:00
Rob Pike
6ab6c49fce renaming_1: hand-edited files for go 1 renaming 
This contains the files that required handiwork, mostly
Makefiles with updated TARGs, plus the two packages
with modified package names.
html/template/doc.go needs a separate edit pass.
test/fixedbugs/bug358.go is not legal go so gofix fails on it.

R=rsc
CC=golang-dev
https://golang.org/cl/5340050
 2011-11-08 15:38:47 -08:00
Andrew Gerrand
4b39d115a0 weekly.2011-11-08 
R=r
CC=golang-dev
https://golang.org/cl/5351049
 2011-11-09 10:27:22 +11:00
Vincent Vanackere
eb1717e035 all: rename os.EOF to io.EOF in various non-code contexts 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5334050
 2011-11-03 14:01:30 -07:00
Rob Pike
e223eedc8b spec: delete spurious article 
A profound change to christen the new tag.

R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/5327062
 2011-11-01 20:57:17 -07:00
Andrew Gerrand
ede44c68a4 weekly.2011-11-02 
R=golang-dev, bradfitz, rsc
CC=golang-dev
https://golang.org/cl/5308077
 2011-11-02 12:00:13 +09:00
Russ Cox
492098eb75 all: rename os.Error to error in various non-code contexts 
R=adg
CC=golang-dev
https://golang.org/cl/5328062
 2011-11-01 22:58:09 -04:00
Russ Cox
44526cdbe0 non-pkg: gofix -r error -force=error 
R=golang-dev, iant, r, r
CC=golang-dev
https://golang.org/cl/5307066
 2011-11-01 22:06:05 -04:00
Rob Pike
68050ac76b tutorial,effective_go: prepare for error change 
R=adg, rsc
CC=golang-dev
https://golang.org/cl/5316068
 2011-11-01 21:50:21 -04:00
Russ Cox
d9877e22fe spec: add error 
R=golang-dev, dsymonds, r, r
CC=golang-dev
https://golang.org/cl/5308072
 2011-11-01 21:45:02 -04:00
Andrew Gerrand
08757f722c weekly.2011-11-01 
R=rsc, r
CC=golang-dev
https://golang.org/cl/5336044
 2011-11-02 10:37:01 +09:00
Rob Pike
cf7281e728 doc/Makefile: add 'all' rule to build all docs 
R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/5334044
 2011-11-01 09:45:04 -07:00
Andrew Gerrand
1fe22d2d24 doc: refer to tour.golang.org instead of go-tour.appspot.com 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5331055
 2011-11-01 16:09:29 +09:00
Charles L. Dorian
44262d1574 doc: fix typo in spec example code comment 
R=r, golang-dev, adg
CC=golang-dev
https://golang.org/cl/5308071
 2011-11-01 15:13:33 +09:00
Robert Griesemer
b910a27396 go spec: introduce rune type 
R=r, iant, rsc, r
CC=golang-dev
https://golang.org/cl/5293048
 2011-11-01 01:09:22 -04:00
Andrew Gerrand
8a7b2b2f70 doc: A Tour of Go in Japanese 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/5318058
 2011-10-28 10:55:58 +09:00
Russ Cox
b7ef3c9a54 spec: define that initialization is sequential 
This is true of the existing implementations, and I think
it is an important property to guarantee.

R=golang-dev, r, borman, r
CC=golang-dev
https://golang.org/cl/5321058
 2011-10-27 12:22:45 -07:00
Andrew Gerrand
1e900b0d22 doc: fix escaping in weekly.html 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/5306070
 2011-10-27 15:40:57 +09:00
Andrew Gerrand
659f1f208a weekly.2011-10-26 (new rune type) 
R=rsc
CC=golang-dev
https://golang.org/cl/5297062
 2011-10-26 14:47:38 +09:00
Andrew Gerrand
cdd3d69328 weekly.2011-10-25 
R=rsc
CC=golang-dev
https://golang.org/cl/5321053
 2011-10-26 14:09:25 +09:00
Andrew Gerrand
ac21766c95 weekly.2011-10-18 
R=rsc
CC=golang-dev
https://golang.org/cl/5302041
 2011-10-19 11:31:57 +11:00
Russ Cox
cb2f6cb05d godoc: generate package toc in template, not in JavaScript 
1. Generate TOC for package pages using template,
instead of using JavaScript magic.  This makes the
pages generated by godoc -html easier to export
to other systems.

2. Make TOC one column.  It's hard to do two columns
portably without invoking JavaScript.

3. Since the TOC is only one column, show full type
signatures for functions and methods.  Many times
that's all you need to see anyway.

4. Name the section after the TOC "Overview".
Naming it something is important, to set it off
from the TOC and so that there's a quick link to
it in the TOC.

For now, some illustrative examples:

http://swtch.com:6060/pkg/io/
http://swtch.com:6060/pkg/strings/
http://swtch.com:6060/pkg/tabwriter/
http://swtch.com:6060/pkg/unicode/

Fixes #1982.

R=gri, bradfitz, r
CC=golang-dev
https://golang.org/cl/5303044
 2011-10-18 16:23:35 -04:00
Andrew Gerrand
6989b0db60 doc: document release.r60.3 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/5267049
 2011-10-18 10:43:22 +11:00
Russ Cox
e40d6e066a runtime: random offset for map iteration 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5285042
 2011-10-17 18:49:02 -04:00
Robert Griesemer
c5a6b05ba4 go spec: clarifying variable declaractions w/ constants 
Fixes #2377.

R=r, rsc
CC=golang-dev
https://golang.org/cl/5267048
 2011-10-17 12:54:18 -07:00
Robert Griesemer
3e0c0a8add go spec: "delete" built-in function 
R=golang-dev, r, rsc
CC=golang-dev
https://golang.org/cl/5272045
 2011-10-17 12:53:10 -07:00
Andrew Gerrand
92b7b48213 doc: add go-tour-kr, a Korean translation of A Tour of Go 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/5273043
 2011-10-15 08:42:31 +11:00
Jaroslavas Počepko
ff866c4ca3 ld: Fixes issue 1899 ("cannot create 8.out.exe") 
http://code.google.com/p/go/issues/detail?id=1899

R=rsc, alex.brainman, bsiegert, hectorchu, bradfitz
CC=golang-dev
https://golang.org/cl/4978047
 2011-10-14 20:37:07 +01:00
Russ Cox
f58ed4e641 gc: disallow close on receive-only channels 
Fixes #2353.
Fixes #2246.

R=golang-dev, r, gri
CC=golang-dev
https://golang.org/cl/5282042
 2011-10-13 16:58:04 -04:00
Russ Cox
d1bafffa4b runtime: run goroutines during init 
Fixes #583.
Fixes #1776.
Fixes #2001.
Fixes #2112.

R=golang-dev, bradfitz, r, gri
CC=golang-dev
https://golang.org/cl/5265044
 2011-10-13 15:54:23 -04:00
Russ Cox
fa538114ed spec: define order of multiple assignment 
R=golang-dev, r, gri
CC=golang-dev
https://golang.org/cl/5240055
 2011-10-13 15:44:17 -04:00
Brad Fitzpatrick
145c18365e doc: minor homepage tweak 
Don't imply that the tour isn't browser-based.

R=adg
CC=golang-dev
https://golang.org/cl/5265041
 2011-10-13 09:03:24 -07:00
Dmitriy Vyukov
cd5f144fe2 doc: remove link to http://golanguage.ru/ 
I check it for several months and it always says
ERR_NAME_RESOLUTION_FAILED

R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/5272041
 2011-10-13 10:09:43 +03:00
Luuk van Dijk
77fac21e82 runtime: append([]byte, string...) 
Fixes #2274

R=rsc, gri, dsymonds, bradfitz, lvd
CC=golang-dev
https://golang.org/cl/5149045
 2011-10-12 15:59:23 +02:00
Andrew Gerrand
cab53c899c doc: fix tutorial and Makefile PATH without dot 
Fixes #2351.

R=r, bradfitz
CC=golang-dev
https://golang.org/cl/5235056
 2011-10-10 11:16:04 +11:00
Andrew Gerrand
2b0d7f0836 weekly.2011-10-06 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5207044
 2011-10-06 15:56:02 -07:00
Andrew Gerrand
edacc863d0 doc: remove errant console.log from godocs.js 
R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/5211045
 2011-10-06 13:12:11 -07:00
Andrew Gerrand
af1ae438b9 go/doc, godoc, gotest: support for reading example documentation 
This CL introduces the go.Example type and go.Examples functions that
are used to represent and extract code samples from Go source.

They should be of the form:

// Output of this function.
func ExampleFoo() {
        fmt.Println("Output of this function.")
}

It also modifies godoc to read example code from _test.go files,
and include them in the HTML output with JavaScript-driven toggles.

It also implements testing of example functions with gotest.
The stdout/stderr is compared against the output comment on the
function.

This CL includes examples for the sort.Ints function and the
sort.SortInts type. After patching this CL in and re-building go/doc
and godoc, try
        godoc -http=localhost:6060
and visit http://localhost:6060/pkg/sort/

R=gri, r, rsc
CC=golang-dev
https://golang.org/cl/5137041
 2011-10-06 11:56:17 -07:00
Rob Pike
029c9bcb8b Effective Go: IntArray -> IntSlice 
Fixes #2336.

R=golang-dev, dsymonds, rsc
CC=golang-dev
https://golang.org/cl/5222042
 2011-10-06 10:46:18 -07:00
Andrew Gerrand
a0b2d154e6 doc: document r60.2 
R=rsc, dsymonds
CC=golang-dev
https://golang.org/cl/5204041
 2011-10-05 13:59:39 -07:00
Andrew Gerrand
5d51b0ae53 doc: link to Czech translation of The Laws of Reflection 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5190045
 2011-10-05 12:45:56 -07:00
Andrew Gerrand
f03b37b8df doc: link to A Tour of Go 
R=golang-dev, rsc, r
CC=golang-dev
https://golang.org/cl/5181045
 2011-10-05 11:12:07 -07:00
Luuk van Dijk
3e26862c1a documentation: Debugging Go code with GDB tutorial. 
R=adg, cw, lvd
CC=golang-dev
https://golang.org/cl/5168046
 2011-10-05 10:49:23 -07:00
Rob Pike
934c768019 doc: update tutorial. 
Fix for new regexp library ($ isn't end of line any more).
Don't assume . is in PATH.

R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/5175052
 2011-10-03 16:18:47 -07:00
Nigel Tao
585294db73 doc: link to image/draw blog post. 
R=adg
TBR=adg
CC=golang-dev
https://golang.org/cl/5154046
 2011-09-30 13:11:20 +10:00
Ian Lance Taylor
807eb29f9f go spec: remove notes about gccgo limitations, now fixed 
R=gri
CC=golang-dev
https://golang.org/cl/5164041
 2011-09-29 14:50:55 -07:00
Russ Cox
44d13e3cfe doc: fix memory model read visibility bug 
Fixes #2277.

R=dvyukov, r
CC=golang-dev
https://golang.org/cl/5083044
 2011-09-26 12:54:30 -04:00
Andrew Gerrand
76d82dbc4c doc: link to image blog post 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5086048
 2011-09-23 07:22:28 +10:00
Andrew Gerrand
e4ac43b7f0 weekly.2011-09-21 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/5075050
 2011-09-22 15:06:10 +10:00
Ian Lance Taylor
5d1d040e3a doc: when configuring gold for gccgo, use --enable-gold=default 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/5030057
 2011-09-19 11:54:07 -07:00
Andrew Gerrand
cecddc4dd3 doc: link to golang-france 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/5059046
 2011-09-19 15:36:06 +10:00
Andrew Gerrand
a66ae1d39e doc: update release.r60.1 notes 
R=dsymonds
CC=golang-dev
https://golang.org/cl/5045045
 2011-09-19 12:16:08 +10:00
Andrew Gerrand
b0e3edab0e weekly.2011-09-16 
R=golang-dev, dsymonds, r
CC=golang-dev
https://golang.org/cl/5040042
 2011-09-16 17:18:36 +10:00
Andrew Gerrand
f41ab6c7c8 doc: release.r60.1 
R=r
CC=golang-dev
https://golang.org/cl/5002041
 2011-09-15 19:26:12 +10:00
Andrew Gerrand
3bc2d0f20b doc: link to notable blog posts 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/4996041
 2011-09-10 09:35:25 +10:00
Andrew Gerrand
2544d30973 doc: release.r60 
R=dsymonds, r, rsc
CC=golang-dev
https://golang.org/cl/4981047
 2011-09-08 12:08:07 +10:00
Andrew Gerrand
ede613ac22 doc: fix date in weekly snapshot history 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/4978057
 2011-09-08 10:03:27 +10:00
Andrew Gerrand
c5c656aee3 weekly.2011-09-07 
R=dsymonds, rsc, r
CC=golang-dev
https://golang.org/cl/4968070
 2011-09-08 09:43:35 +10:00
David Symonds
e85fb2137b weekly.html: remove note about exp/template -> template move. 
It actually occurred with the previous weekly snapshot.

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/4961066
 2011-09-07 14:10:14 +10:00
Nigel Tao
ca64a37d9d weekly.2011-09-01 
R=r, adg
CC=golang-dev
https://golang.org/cl/4975046
 2011-09-01 17:08:53 +10:00
Robert Griesemer
ffe70eaa3c go spec: update section on Implementation Differences 
R=rsc, r
CC=golang-dev
https://golang.org/cl/4977046
 2011-08-31 15:16:51 -07:00
Jaroslavas Počepko
2afc46f2b2 doc/progs: fix windows/amd64 
R=rsc
CC=alex.brainman, golang-dev, vcc.163
https://golang.org/cl/4965050
 2011-08-29 15:38:12 -04:00
Russ Cox
0b12223fbe doc/codelab/wiki: fix Makefile 
R=adg
CC=golang-dev
https://golang.org/cl/4971043
 2011-08-29 09:24:24 -04:00
Russ Cox
dd0b8e7975 doc: emphasize that environment variables are optional 
Also update $GOARM description.

R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/4972041
 2011-08-25 16:53:54 -04:00
Rob Pike
6731d47f99 effective go: fix erroneous quoting of ampersands that cropped up 
R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/4937047
 2011-08-23 13:54:29 +10:00
Robert Griesemer
d883f29309 godoc: add dummy playground.js to silence godoc warning at start-up 
Fixes #2173.

R=r, rsc
CC=golang-dev
https://golang.org/cl/4941044
 2011-08-22 14:06:07 -07:00
Rob Pike
18b21c720e effective go: extract and test a couple more examples. 
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/4937045
 2011-08-22 22:46:59 +10:00
Rob Pike
ebf2b92e9a effective_go: fix brace quotes. 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/4932044
 2011-08-22 08:18:03 +10:00
Rob Pike
d1a3edaee7 effective_go: convert to use tmpltohtml. 
Also update the big example to the new template system.
There are a number of other examples that should be
extracted; this CL serves as an introduction to the
approach.

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/4923043
 2011-08-21 09:46:19 +10:00
Rob Pike
1446ffc265 doc/tmpltohtml: update to new template package. 
Trivial change: just fix the import.

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/4937043
 2011-08-21 09:04:21 +10:00
Andrew Gerrand
1491a20540 weekly.2011-08-17 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/4914042
 2011-08-18 14:27:08 +10:00
Andrew Gerrand
b67b72da43 doc/codelab: use new template package 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/4897048
 2011-08-18 10:38:08 +10:00
Andrew Gerrand
2a189845b6 doc/codewalk: new Markov chain codewalk 
R=gri, r, rsc
CC=golang-dev
https://golang.org/cl/4891041
 2011-08-17 15:53:17 +10:00
Rob Pike
73b7afbebd template: delete old template code. 
It's already in old/template; make that build.
Update a couple of references to point to the old template.
They can be updated later.
Update goplay to use exp/template.

R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/4902046
 2011-08-17 14:34:48 +10:00
Rob Pike
ff0240da6d misc: fix a couple of template uses preparatory to the big switch. 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/4876057
 2011-08-17 13:57:06 +10:00
Nigel Tao
da7e1ba00b weekly.2011-08-10 
R=r
CC=golang-dev
https://golang.org/cl/4830069
 2011-08-10 16:00:22 +10:00
Rob Pike
7d87f3d233 FAQ: variant types, unions 
Fixes #1935.

R=rsc, bradfitz
CC=golang-dev
https://golang.org/cl/4850044
 2011-08-06 11:21:59 +10:00
Rob Pike
93c4a246a4 FAQ: lots of small tweaks plus a couple of new discussions. 
Expand the conversations about pointers, memory, and
garbage collection.
Describe the lack of co/contravariant typing.

Fixes #1929.
Fixes #1930.

R=dsymonds, r, mirtchovski, edsrzf, hanwen, rsc
CC=golang-dev
https://golang.org/cl/4852041
 2011-08-06 07:41:55 +10:00
Andrew Gerrand
4d2766e994 doc: document release.r59 
R=golang-dev, dsymonds, r, r
CC=golang-dev
https://golang.org/cl/4835044
 2011-07-31 15:29:10 -07:00
Andrew Gerrand
70f6133b84 doc: fix typo in Effective Go 
Fixes #2120.

R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/4810061
 2011-07-31 15:25:26 -07:00
David Symonds
be96fa5a2e go_faq: drop a dramatic comma. 
R=r
CC=golang-dev
https://golang.org/cl/4809064
 2011-07-31 12:59:58 +10:00
Andrew Gerrand
b583108436 weekly.2011-07-29 
R=rsc
CC=golang-dev
https://golang.org/cl/4801062
 2011-07-29 15:11:48 -07:00
Andrew Gerrand
50ddb98b24 weekly.2011-07-19 
R=golang-dev, nigeltao, dsymonds, r
CC=golang-dev
https://golang.org/cl/4801042
 2011-07-20 15:45:55 +10:00
Andrew Gerrand
894222f9de doc/talks/io2010: handle the errors 
R=golang-dev, dsymonds, dsymonds, r
CC=golang-dev
https://golang.org/cl/4771041
 2011-07-19 14:10:12 +10:00
Andrew Gerrand
ab55133ca9 doc: fix padding on h1 tags 
See /doc/codewalk/sharemem/ for an example of how it's broken.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/4742044
 2011-07-18 17:30:00 +10:00
Robert Griesemer
38a53c7ecb go spec: (up-)date 
R=rsc, bradfitz, r
CC=golang-dev
https://golang.org/cl/4738042
 2011-07-14 15:58:37 -07:00
Russ Cox
58e19aa4cb go: require { } around else block 
R=gri, ken, r
CC=golang-dev
https://golang.org/cl/4721044
 2011-07-14 17:15:52 -04:00
Rob Pike
c1c8d46d20 go_tutorial: change the way it's generated. 
No longer do we generate HTML from it; instead the input
file is already in HTML but has template invocations to
extract programs from other files.
Delete htmlgen, which is no longer needed.
Add tmpltohtml, which runs the templating code.

R=golang-dev, dsymonds, adg
CC=golang-dev
https://golang.org/cl/4699041
 2011-07-13 13:20:05 +10:00
Andrew Gerrand
ba91dac3a9 doc: gofix io2010 demo programs 
R=golang-dev, gri, r, agl
CC=golang-dev
https://golang.org/cl/4696046
 2011-07-13 09:40:49 +10:00
Rob Pike
4c63129545 effective go: tweak the words about semicolons, parens in control structures, 
and make and new.

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/4699043
 2011-07-12 23:45:10 +10:00
Russ Cox
1002e82fff doc: document r58.1 
R=adg, dsymonds
CC=golang-dev
https://golang.org/cl/4700041
 2011-07-12 01:39:09 -04:00
Yasuhiro Matsumoto
34bac8bcd4 doc: don't specify make target for working on windwos. 
makehtml does not work on windows.

R=golang-dev, adg, rsc
CC=golang-dev
https://golang.org/cl/4675041
 2011-07-11 20:02:32 -04:00
Rob Pike
c17347eea9 tutorial: remove all line numbers and references to them. 
R=golang-dev, mikioh.mikioh, dsymonds
CC=golang-dev
https://golang.org/cl/4675070
 2011-07-09 23:17:38 +10:00
Mikio Hara
ab3365d34e doc/progs: gofmt -w 
R=r, gri, r
CC=golang-dev
https://golang.org/cl/4662085
 2011-07-09 20:16:45 +10:00
Andrew Gerrand
4f03ef7993 weekly.2011-07-07 
R=golang-dev, dsymonds, r
CC=golang-dev
https://golang.org/cl/4668061
 2011-07-08 13:13:38 +10:00
Brad Fitzpatrick
141f676bab doc: remove ed from apt-get package list 
R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/4672052
 2011-07-07 13:45:13 -07:00
Rob Pike
9cf37c3723 docs: fold the prog.sh scripting from makehtml into htmlgen itself. 
This allows us to drop some crufty scripting and provides a firmer
footing for building better tools for preparing documents with source
code inside.

Also eliminate line numbers from the examples and text.

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/4650069
 2011-07-04 16:15:14 +10:00
Wei Guangjing
63b8b948d9 windows: define and use syscall.Handle 
Fixes #1487.

R=rsc, alex.brainman, go.peter.90, mikioh.mikioh, mattn.jp
CC=golang-dev
https://golang.org/cl/4600042
 2011-07-01 10:18:07 -04:00
Andrew Gerrand
f81d81ca3f document release.r58 
R=rsc, r, bsiegert
CC=golang-dev
https://golang.org/cl/4643058
 2011-06-30 09:45:10 +10:00
Russ Cox
9dd354c63f 5l, 6l, 8l: drop use of ed during build 
build runs with chmod 0 /bin/ed now

R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/4635071
 2011-06-27 12:03:19 -04:00
Andrew Gerrand
30d08b404c weekly.2011-06-23 
R=golang-dev, robert.hencke, r
CC=golang-dev
https://golang.org/cl/4625062
 2011-06-24 16:04:17 +10:00
Ben Lynn
6be0bdf7bc Effective Go: supplied missing type in variadic function example. 
R=golang-dev, nigeltao
CC=golang-dev
https://golang.org/cl/4595055
 2011-06-21 10:55:07 +10:00
Rob Pike
5e77b9d334 doc/GoCourseDay1: shrink the PDF by rewriting it using ps2pdf. 
No difference in content or appearance.
Forgot to do this when I updated this file a few days ago.

R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/4626056
 2011-06-20 12:36:14 +10:00
Andrew Gerrand
df02e65d54 doc/faq: remove misleading FAQ entry 
R=golang-dev, dsymonds, r
CC=golang-dev
https://golang.org/cl/4638046
 2011-06-19 13:53:07 +10:00
Andrew Gerrand
17805ddb6f doc/faq: add question about converting from []T to []interface{} 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/4639046
 2011-06-18 20:31:38 +10:00
Russ Cox
f4c7db0ed9 spec: disallow goto into blocks 
R=gri, r, r
CC=golang-dev
https://golang.org/cl/4631045
 2011-06-17 12:49:04 -04:00
Andrew Gerrand
d6b9dd8b81 weekly.2011-06-16 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/4643044
 2011-06-17 11:31:40 +10:00
Nigel Tao
ca91ce2d85 doc/effective_go: add a note about prefixing error strings with their 
package name.

R=r, rsc
CC=golang-dev
https://golang.org/cl/4630042
 2011-06-17 10:51:10 +10:00
Rob Pike
8db6802cec docs/GoCourseDay1.pdf: fix error in operator table. 
Communications op was listed as a binary; it isn't any more.

R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/4637041
 2011-06-16 16:03:24 +10:00
Russ Cox
aaae15ef0f doc: document r57.2 
R=adg, r
CC=golang-dev
https://golang.org/cl/4627042
 2011-06-16 01:46:14 -04:00
Rob Pike
e3d2a29e99 doc/effective_go.html: replace tab with spaces. 
R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/4609042
 2011-06-16 00:13:18 +10:00
Rob Pike
c6c8dbd646 doc/gopher: add a small gif to use as an app engine logo on GAE pages. 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/4591078
 2011-06-14 17:25:57 +10:00
Rob Pike
6d42af7197 doc/gopher: add jpgs of the goggled gopher logo for App Engine. 
R=golang-dev, r, adg
CC=golang-dev
https://golang.org/cl/4591077
 2011-06-14 16:42:52 +10:00
Robert Griesemer
2769356dda go spec: specify constant conversions 
This is not a language change.

Added paragraphs specifying which conversions
yield results that are constants.

R=r, rsc, iant, ken
CC=golang-dev
https://golang.org/cl/4515176
 2011-06-13 16:47:33 -07:00
Robert Griesemer
eee70b07c1 go spec: unsafe.Alignof/Offsetof/Sizeof return uintptr 
This is (indirectly) a language change. Per e-mail discussion
on golang-dev.

Fixes #1943.

R=rsc, iant, r, ken
CC=golang-dev
https://golang.org/cl/4581058
 2011-06-13 16:46:42 -07:00
Robert Griesemer
95b8137a16 go spec: clarify rules for append, scope rules for := 
Fixes #1936.
Fixes #1940.

R=rsc, r, iant, ken, iant
CC=golang-dev
https://golang.org/cl/4585049
 2011-06-12 12:09:50 -07:00
Rob Pike
4b1170d2b1 sort: change IntArray etc. to IntSlice for better name hygiene. 
R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/4602054
 2011-06-11 09:25:18 +10:00
Robert Griesemer
18333f2de5 Go memory model: minor clarification 
Fixes #1941.

R=rsc
CC=golang-dev
https://golang.org/cl/4576053
 2011-06-10 12:31:10 -07:00
Rob Pike
9b409ac7ee docs: Update notes for 3-day Go course. 
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/4605041
 2011-06-10 15:05:51 +10:00
Andrew Gerrand
11b04261c7 weekly.2011-06-09 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/4601052
 2011-06-10 14:26:09 +10:00
Robert Griesemer
636c5fac2d go spec: handle a corner case of a special case for shifts... 
- Added some additional examples.
- 6g appears to implement this semantics already.

Fixes #658.

R=rsc, r, iant, ken
CC=golang-dev
https://golang.org/cl/4538119
 2011-06-08 09:11:18 -07:00
Andrew Gerrand
79eded509c doc: don't insert paragraphs inside pre blocks 
doc: update go_tutorial

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/4568056
 2011-06-06 13:33:05 +10:00
Andrew Gerrand
897ad0c05e weekly.2011-06-02 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/4548091
 2011-06-03 11:18:34 +10:00
Andrew Gerrand
6c2b434820 doc: add Belarusian FAQ translation 
R=golang-dev, dchest
CC=golang-dev
https://golang.org/cl/4564057
 2011-06-03 09:48:42 +10:00
Andrew Gerrand
119a341c38 doc: add link to App Engine docs to front page 
R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/4539100
 2011-06-02 11:00:24 +10:00
Andrew Gerrand
2386808ee9 doc: put Release History link on 'Documentation' page 
Also put Weekly Snapshot History link on 'Contributing' page

Fixes #1885.

R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/4559049
 2011-05-27 16:07:30 +10:00
Andrew Gerrand
feb9a146f9 doc: mention go/printer instead of container/vector in effective go 
Fixes #1876.

R=golang-dev, bradfitz, gri, r
CC=golang-dev
https://golang.org/cl/4538093
 2011-05-25 11:39:40 +10:00
Rob Pike
2f655c4bb7 spec: delete spurious tag. 
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/4536082
 2011-05-25 10:58:58 +10:00
Robert Griesemer
3c7271f057 go spec: be precise with the use of the informal ellipsis … and the Go token ... 
Fixes #1867.

R=r
CC=golang-dev
https://golang.org/cl/4538092
 2011-05-24 14:18:44 -07:00
Rob Pike
46f482a2fc docs: remove some prose-unworthy empty parentheses. 
In our evolving style, prose should name a function "f" not "f()".

R=gri, rsc
CC=golang-dev
https://golang.org/cl/4550075
 2011-05-25 06:44:09 +10:00
Rob Pike
bdbe0decc6 spec: add missing comma. 
A real humdinger.

R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/4538089
 2011-05-25 06:00:07 +10:00
Robert Griesemer
32d127823f go spec: clarify rules for shifts 
Note: This is not a spec change.

The spec was not clear on the result type of
constant shift expressions. Made it more
explicit and added additional examples.

Also: Remove paragraph on send expressions (they
are statements, now).

Fixes #1708.

R=rsc, r, iant, r
CC=golang-dev
https://golang.org/cl/4517074
 2011-05-23 14:12:42 -07:00
Andrew Gerrand
f6742e7482 weekly.2011-05-22 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/4523090
 2011-05-23 16:30:06 +10:00
Evan Shaw
64d85769da doc: close paragraph tags in FAQ 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/4532076
 2011-05-22 14:56:12 +10:00
Andrew Gerrand
b9f9087605 godoc: don't display navigation list with only 1 element 
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/4547056
 2011-05-20 14:26:00 +10:00
Andrew Gerrand
b96fc594ba doc: add Korean Go site 
R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/4515092
 2011-05-17 14:24:32 +10:00
Andrew Gerrand
4fb5857596 doc: add I/O 2011 talks to talks/, docs.html, and front page. 
R=rsc
CC=golang-dev
https://golang.org/cl/4516057
 2011-05-17 13:46:54 +10:00
Russ Cox
9f03d4a3f7 doc/go_mem.html: close happens before receive on closed channel 
R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/4551042
 2011-05-16 17:03:51 -04:00
Nigel Tao
703b092779 spec: fix copy to return "number of elements copied", not "number 
of arguments copied".

R=gri, r
CC=golang-dev
https://golang.org/cl/4550041
 2011-05-15 16:04:37 -07:00
Rob Pike
9ada841f4d contrib*.html: make "golang-dev" the default reviewer. 
also make a couple of links more visible and fix an id= href.

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/4517063
 2011-05-13 16:25:31 -07:00
Robert Griesemer
32b822f29a go spec: fix error in production syntax 
Fix analoguous error in ebnf.go which already
correctly accepted an empty production.

Fixes #1821.

R=r
CC=golang-dev
https://golang.org/cl/4526056
 2011-05-13 12:54:51 -07:00
Brad Fitzpatrick
e113e405de doc: auto-generated html change missing from 7ee7980ea06d 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/4515077
 2011-05-13 08:12:34 -07:00
Brad Fitzpatrick
05a1b7ec41 http: remove finalURL from Client.Get; move to Response 
This CL:

-- removes Response.RequestMethod string
-- adds Response.Request *Request
-- removes the finalURL result parameter from client.Get()
-- adds a gofix rule for callers of http.Get which assign
   the final url to the blank identifier; warning otherwise

Caller who did:

res, finalURL, err := http.Get(...)

now need to do:

res, err := http.Get(...)
if err != nil {
   ...
}
finalURL := res.Request.URL.String()

R=rsc
CC=golang-dev
https://golang.org/cl/4535056
 2011-05-13 07:31:24 -07:00
Robert Griesemer
5473103666 go spec: clarify semantics of range clause 
This CL proposes some subtle language changes
in an attempt to clarify the semantics of range
clauses and simplify uses of maps.

- nil maps behave like empty maps; but attempting
  to set a value in a nil map causes a run-time panic
- nil channels are never ready for communication;
  sending or reading from a nil channel blocks forever
- if there is only one index iteration variable in a
  range clause and len(range expression) would be a constant,
  the range expression is not evaluated.
  (was discrepancy with len/cap before)
- the notion of what is a constant expression len(x)
  for (pointer to) arrays x has been generalized and
  simplified (can still be syntactically decided)
  (before: more restrictive syntactic rule that was not
  consistently implemented)

Fixes #1713.

R=r, rsc, iant, ken2, r2, bradfitz, rog
CC=golang-dev
https://golang.org/cl/4444050
 2011-05-12 09:15:59 -07:00
Johan Euphrosine
5f6e1cfca7 doc/codelab: correct typo. 
s/Sprintf/Fprintf/

R=golang-dev, rsc
CC=adg, golang-dev
https://golang.org/cl/4519053
 2011-05-12 11:21:10 -04:00
Rob Pike
89c59bc6f6 effective go: explain about values/pointers in String() example 
Fixes #1796.

R=rsc, r2, niemeyer
CC=golang-dev
https://golang.org/cl/4539049
 2011-05-11 08:31:24 -07:00
Andrew Gerrand
a03bfe7f69 doc/roadmap: put "App Engine support" under "Done". 
R=rsc, dsymonds
CC=golang-dev
https://golang.org/cl/4528053
 2011-05-10 18:40:40 -07:00
Rob Pike
38d7bcf5e2 go spec: fix up HTML glitches. 
Fixes #1786.

R=gri, adg
CC=golang-dev
https://golang.org/cl/4517043
 2011-05-08 14:05:18 -07:00
Rob Pike
121b428a7a effective go: update to new Open signature. 
Fixes #1788.

R=rsc, adg
CC=golang-dev
https://golang.org/cl/4519042
 2011-05-08 14:04:42 -07:00
Dmitry Chestnykh
be99859dbe doc: remove left and right padding in H2 headings. 
R=adg, rsc1, rsc
CC=golang-dev
https://golang.org/cl/4491041
 2011-05-06 16:11:07 -04:00
Robert Griesemer
0e8032ca49 go spec: newlines cannot be used inside a char or "" string literal 
R=r
CC=golang-dev
https://golang.org/cl/4462043
 2011-05-05 09:03:00 -07:00
Russ Cox
f0bcb6dd24 doc: document r57.1 
R=adg
CC=golang-dev
https://golang.org/cl/4471041
 2011-05-04 00:14:07 -04:00
Russ Cox
d6dd80b65e doc: release.r57 
R=golang-dev, r, adg, r2
CC=golang-dev
https://golang.org/cl/4457049
 2011-05-03 13:55:50 -04:00
Andrew Gerrand
a3baf7f90e doc/install: specify clone -u instead of -r 
R=rsc
CC=golang-dev
https://golang.org/cl/4435081
 2011-05-02 20:40:47 -07:00
Robert Griesemer
8e340695c1 godoc: if there is no search box, don't run the respective JS code 
Fixes a JS crash which prevented the automatically generated
table of contents to not appear.

R=adg, bradfitz
CC=golang-dev
https://golang.org/cl/4460041
 2011-05-02 18:07:11 -07:00
Robert Griesemer
bb7eb4002e go spec: clarify semantics of integer division 
Fixes #1764.

R=rsc, r, iant, ken2
CC=golang-dev
https://golang.org/cl/4431082
 2011-05-02 17:23:18 -07:00
Robert Griesemer
6af887ec03 go spec: restricted expressions may still be parenthesized 
No language change.

- added a few examples with parentheses
- added a corresponding sentence to assignments
  (this explicitly permits: (_) = 0, currently allowed by 6g,
  gofmt, but marked as an error by gccgo).

R=rsc, r, iant
CC=golang-dev
https://golang.org/cl/4446071
 2011-05-02 09:16:31 -07:00
Robert Griesemer
c134718611 undo CL 4428057 / 19e540fc7d7d 
The CL introduces inconsistencies with respect to
the use of parentheses/grouping of receive operations.

««« original CL description
spec: narrow syntax for expression and select statements

This is not a language change, it simply expresses the
accepted cases explicitly in the respective productions.

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

R=golang-dev, rsc1
CC=golang-dev
https://golang.org/cl/4444080
 2011-04-29 12:20:31 -07:00
Robert Griesemer
95f544a199 spec: narrow syntax for expression and select statements 
This is not a language change, it simply expresses the
accepted cases explicitly in the respective productions.

R=rsc, r, iant
CC=golang-dev
https://golang.org/cl/4428057
 2011-04-29 09:49:10 -07:00
Andrew Gerrand
5a8ae387e2 weekly.2011-04-27 
R=rsc
CC=golang-dev
https://golang.org/cl/4437077
 2011-04-28 16:32:51 +10:00
Rob Pike
2ccd20a646 tutorial: replace the forever loops with finite counts in sieve programs. 
Fixes #1742.
I hope.

Also this picks up an update to go_tutorial.html that should already have happened.

R=brainman, rsc, peterGo
CC=golang-dev
https://golang.org/cl/4452050
 2011-04-27 09:59:27 -07:00
Russ Cox
c3e6e6ec09 doc: mention make version in install.html 
Fixes #1531.

R=adg
CC=golang-dev
https://golang.org/cl/4442088
 2011-04-26 21:39:22 -04:00
Robert Griesemer
1bdb1803b9 go spec: for map types, mention indexing operations 
(like we do for arrays and slices).

Suggested by mathieu.lonjaret@gmail.com .

R=r, rsc, iant
CC=golang-dev
https://golang.org/cl/4442074
 2011-04-22 16:26:51 -07:00
Nigel Tao
6a186d38d1 src/pkg: make package doc comments consistently start with "Package foo". 
R=rsc
CC=golang-dev
https://golang.org/cl/4442064
 2011-04-20 09:57:05 +10:00
Robert Griesemer
0f7acf1114 go spec: attempt at clarifying language for "append" 
Specifically, fix a wrong comment.

Fixes #1717.

R=r, rsc
CC=golang-dev
https://golang.org/cl/4445050
 2011-04-19 14:38:49 -07:00
Rob Pike
23fc9c84bd tutorial: modernize the definition and use of Open. 
R=golang-dev, iant
CC=golang-dev
https://golang.org/cl/4446053
 2011-04-18 10:51:40 -07:00
Dmitry Chestnykh
84c7e83b4c godoc: use "search" input type for search box. 
Uses placeholder attribute instead of changing the value of search
field on browsers that support it.  On other browsers, the fake
placeholder text is restored when the empty box loses focus.

R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/4441041
 2011-04-15 10:48:45 -07:00
Andrew Gerrand
0f03eedb87 weekly.2011-04-13 
R=dsymonds
CC=golang-dev
https://golang.org/cl/4396047
 2011-04-14 14:18:35 +10:00
Andrew Gerrand
eb5e4b8519 doc/install.html: document use of libc6-dev-i386 
Fixes #1689.

R=rsc
CC=golang-dev
https://golang.org/cl/4404043
 2011-04-14 10:28:59 +10:00
John DeNero
4ffee801ce A codewalk through a simple program that illustrates several aspects of Go functions: function objects, higher-order functions, variadic functions, tail recursion, etc. The example program simulates the game of Pig, a dice game with simple rules but a nontrivial solution. 
R=adg, rsc, iant2, r
CC=golang-dev
https://golang.org/cl/4306045
 2011-04-07 18:05:15 -07:00
Rob Pike
108ba69ae3 roadmap: add sections on tools, packages. 
R=golang-dev, rsc1, r2, bradfitzgo, gri
CC=golang-dev
https://golang.org/cl/4344068
 2011-04-05 13:25:58 -07:00
Rob Pike
e6b1d424c4 spec: add parens missing from "protect" example. 
Fixes #1665.

R=gri
CC=golang-dev
https://golang.org/cl/4351051
 2011-04-05 11:01:25 -07:00
Andrew Gerrand
51319b1125 weekly.2011-04-04 
R=rsc
CC=golang-dev
https://golang.org/cl/4363043
 2011-04-05 12:55:03 +10:00
Rob Pike
016a99f440 roadmap: remove description of implementation of garbage collector. 
It was speculation.
Also replace one silly word with an English replacement.

R=golang-dev, bradfitzgo
CC=golang-dev
https://golang.org/cl/4339041
 2011-03-31 13:13:04 -07:00
Andrew Gerrand
33e41802f9 weekly.2011-03-28 
R=r, rsc
CC=golang-dev
https://golang.org/cl/4272072
 2011-03-29 14:17:04 +11:00
Ian Lance Taylor
d38d66e646 doc: gccgo now supports method expressions and multiple init functions. 
R=gri
CC=golang-dev
https://golang.org/cl/4314047
 2011-03-28 14:48:35 -07:00
Russ Cox
6b3357129a build: add all-qemu.bash, handful of arm fixes 
R=r
CC=golang-dev
https://golang.org/cl/4313051
 2011-03-27 23:39:42 -04:00
Andrew Gerrand
eccf31b744 doc: update contrib.html to be more enticing 
doc: refer to golang-dev instead of -nuts in contribute.html

R=r, rsc
CC=golang-dev
https://golang.org/cl/4309043
 2011-03-24 11:06:02 +11:00
Andrew Gerrand
393ea2dfa8 doc: mention godoc in "implements" FAQ 
R=r
CC=golang-dev
https://golang.org/cl/4248066
 2011-03-17 16:37:34 +11:00
Andrew Gerrand
929449ddaf doc: explain release and weekly tags in install.html 
R=r
CC=golang-dev
https://golang.org/cl/4272058
 2011-03-17 16:33:10 +11:00
Andrew Gerrand
e44c057369 doc: fix line wrapping for release.html 
R=r
CC=golang-dev
https://golang.org/cl/4281052
 2011-03-16 16:36:18 +11:00
Andrew Gerrand
f538f2432e weekly.2011-03-15 
R=r
CC=golang-dev
https://golang.org/cl/4272052
 2011-03-16 16:24:08 +11:00
Russ Cox
108564dabc spec: disallow unused labels 
Also change labelled examples to use gofmt formatting.

R=gri, r, jnml
CC=golang-dev
https://golang.org/cl/4287046
 2011-03-15 13:51:24 -04:00
Russ Cox
9f2cb86fe2 spec: remove closed from language, replaced by x, ok = <-c 
R=gri, r, r2
CC=golang-dev
https://golang.org/cl/4249065
 2011-03-11 14:47:02 -05:00
Andrew Gerrand
08ceb870f2 .hgtags: s/release/weekly/ 
.hgtags, release.html: tag current weekly as release.r56

R=r, rsc
CC=golang-dev
https://golang.org/cl/4281041
 2011-03-11 18:04:18 +11:00
Rob Pike
9e2fbe186d Effective Go: some small cleanups. 
Add discussion of getters.
Add example using a map as a set.

R=golang-dev, gri, adg, iant
CC=golang-dev
https://golang.org/cl/4240100
 2011-03-09 16:47:40 -08:00
Andrew Gerrand
4896b17584 doc: update codelab wiki to fix template.Execute argument order 
Fixes #1595.

R=r
CC=golang-dev
https://golang.org/cl/4243067
 2011-03-09 12:59:13 +11:00
Rob Pike
ce0de4229f FAQ: hello, world is now 1.1MB, down from 1.8MB 
R=rsc
CC=golang-dev
https://golang.org/cl/4235061
 2011-03-08 11:47:41 -08:00
Robert Griesemer
fb64e0d96f go spec: clarify return statement rules 
Added example of a return statement w/o expressions
in a function with a _ result parameter.

See also: http://code.google.com/p/go/issues/detail?id=1586

R=rsc, r, iant
CC=golang-dev
https://golang.org/cl/4266049
 2011-03-07 16:29:07 -08:00
Alex Brainman
2ae4f356cc doc/codelab/wiki: include into windows build 
R=adg, rsc
CC=Joe Poirier, golang-dev
https://golang.org/cl/4257052
 2011-03-07 15:48:39 +11:00
Andrew Gerrand
7fb65a936b doc: amend release.2011-03-07 notes to mention reflect and path changes 
R=rsc
CC=golang-dev
https://golang.org/cl/4250061
 2011-03-07 14:46:55 +11:00
Andrew Gerrand
c1d44c9453 release.2011-03-07 
R=r, rsc, dfc
CC=golang-dev
https://golang.org/cl/4240081
 2011-03-07 13:55:22 +11:00
Andrew Gerrand
89f890f266 doc: there's no such thing as a .cgo file 
R=rsc
CC=golang-dev
https://golang.org/cl/4264043
 2011-03-04 16:28:27 +11:00
Andrew Gerrand
aef4e1c349 doc: add "implements" question to FAQ 
R=r, fw, gri, r2, yiyus
CC=golang-dev
https://golang.org/cl/4248051
 2011-03-04 13:11:07 +11:00
Andrew Gerrand
ee1cb829ac doc: describe platform-specific conventions in code.html 
R=r, rsc, gri
CC=golang-dev
https://golang.org/cl/4257049
 2011-03-04 12:28:08 +11:00
Robert Griesemer
967a2b38cd go spec: minor clarification of scope rule for functions 
R=rsc, iant, r, r2
CC=golang-dev
https://golang.org/cl/4256050
 2011-03-03 15:24:28 -08:00
Andrew Gerrand
3fea5badc2 doc: remove reference to bug count from install.html 
Fixes #1574.

R=rsc, r2
CC=golang-dev
https://golang.org/cl/4240066
 2011-03-03 16:41:03 +11:00