Rob Pike
694b244e1d
doc: update FAQ for Go 1.5
...
Change-Id: I4befb21d0811819ce0a5721421a2f6df7a9b62fa
Reviewed-on: https://go-review.googlesource.com/11605
Reviewed-by: Russ Cox <rsc@golang.org>
Reviewed-by: Andrew Gerrand <adg@golang.org>
2015-06-29 05:34:08 +00:00
Aaron Jacobs
8628688304
Fix several out of date references to 4g/5g/6g/8g/9g.
...
Change-Id: Ifb8e4e13c7778a7c0113190051415e096f5db94f
Reviewed-on: https://go-review.googlesource.com/11390
Reviewed-by: Josh Bleecher Snyder <josharian@gmail.com>
Reviewed-by: Andrew Gerrand <adg@golang.org>
2015-06-26 03:38:21 +00:00
Dmitry Savintsev
133966d3d8
doc/faq: replace reference to goven with gomvpkg
...
github.com/kr/goven says it's deprecated and anyway
it would be preferable to point users to a standard Go tool.
Change-Id: Iac4a0d13233604a36538748d498f5770b2afce19
Reviewed-on: https://go-review.googlesource.com/8969
Reviewed-by: Minux Ma <minux@golang.org>
2015-04-23 03:39:17 +00:00
Emil Hessman
f3de21767e
doc: update links in FAQ
...
Vitess and protobuf has moved to GitHub; update the links.
Change-Id: I2d90bde1a7f2b590c8b7b08ce73d6faa13b51da0
Reviewed-on: https://go-review.googlesource.com/2166
Reviewed-by: Andrew Gerrand <adg@golang.org>
2014-12-30 05:52:03 +00:00
Andrew Gerrand
eb91b5f224
[release-branch.go1.4] doc: scrub references to code.google.com
...
These are the references that affect current Go users.
I left intact references in older release notes;
we can figure out what to do with them later.
LGTM=rsc
R=rsc
CC=golang-codereviews
https://golang.org/cl/186140043
Conflicts:
doc/go1.4.html
Change-Id: I1032686f2b3ac6dacaf8f114b8c35cdf221330ca
2014-12-12 14:00:48 +11:00
David Symonds
36e443342d
doc: remove obsolete FAQ entry about using Mercurial vs. Git.
...
Change-Id: I9d9b02ad745208e7297cb75c86af49b2d858b12d
Reviewed-on: https://go-review.googlesource.com/1176
Reviewed-by: Andrew Gerrand <adg@golang.org>
2014-12-08 21:15:02 +00:00
Andrew Gerrand
7f0be1f781
all: use golang.org/x/... import paths
...
LGTM=rsc, r
R=r, rsc
CC=golang-codereview, golang-codereviews
https://golang.org/cl/168050043
2014-11-10 09:15:57 +11:00
Rob Pike
a9422651f9
doc/go_faq.html: fix a couple of nits
...
Wrong article, one stylistic point that bothers someone (but not me).
LGTM=bradfitz
R=golang-codereviews, bradfitz
CC=golang-codereviews
https://golang.org/cl/156680043
2014-10-26 11:27:55 -07:00
Rob Pike
dba2faf2c6
doc/go_faq.html: explain the policy about unused imports a little better
...
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://golang.org/cl/146680044
2014-10-01 15:25:56 -07:00
Rob Pike
56c4d0a5c6
doc/faq: update for 1.4
...
LGTM=iant
R=golang-codereviews, bradfitz, iant
CC=golang-codereviews
https://golang.org/cl/150190043
2014-09-27 11:56:54 -07:00
Russ Cox
220a6de47e
build: adjustments for move from src/pkg to src
...
This CL adjusts code referring to src/pkg to refer to src.
Immediately after submitting this CL, I will submit
a change doing 'hg mv src/pkg/* src'.
That change will be too large to review with Rietveld
but will contain only the 'hg mv'.
This CL will break the build.
The followup 'hg mv' will fix it.
For more about the move, see golang.org/s/go14nopkg.
LGTM=r
R=r
CC=golang-codereviews
https://golang.org/cl/134570043
2014-09-08 00:06:45 -04:00
Andrew Gerrand
43ad89d627
doc: drop scheme from links that are known to support HTTPS
...
golang.org now serves HTTPS with a valid cert, so it's reasonable
that users should click through to the HTTPS versions of *.golang.org
and other known sites.
LGTM=bradfitz
R=golang-codereviews, bradfitz
CC=golang-codereviews
https://golang.org/cl/112650043
2014-07-25 10:28:39 +10:00
Dmitriy Vyukov
2e1ddeb136
doc: replace absolute links to golang.org with relative links
...
Currently tip.golang.org leads to golang.org and
local godoc also leads to golang.org (when you don't have internet connectivity).
LGTM=crawshaw
R=golang-codereviews, crawshaw
CC=golang-codereviews
https://golang.org/cl/100200043
2014-05-07 18:49:13 +04:00
Rob Pike
287967f74c
doc/go_faq.html: update description of stack management
...
They aren't segmented any more, at least with gc.
Also improve the comparison of goroutines and threads.
Fixes #7373 .
LGTM=iant
R=iant
CC=golang-codereviews
https://golang.org/cl/77950044
2014-03-21 13:59:30 +11:00
Rob Pike
3a7fe36d66
doc/go_faq.html: reference the new wiki page titled Go Code Review Comments
...
Fixes #7449 .
LGTM=bradfitz
R=golang-codereviews, bradfitz
CC=golang-codereviews
https://golang.org/cl/71610044
2014-03-06 13:15:09 +11: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
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
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
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
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
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
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
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
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
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
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
Oling Cat
018e89fa69
doc/go_spec: remove extra space, align tags, and change a tab to a space.
...
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/7198048
2013-01-24 20:46:33 +11:00
Andrew Gerrand
399a36a634
doc: fix various fragment links
...
R=dsymonds
CC=golang-dev
https://golang.org/cl/7094058
2013-01-15 19:25:16 +11:00
Christian Himpel
89ed40c44b
faq: mention go vet in "What happens with closures running as goroutines?"
...
R=r
CC=golang-dev
https://golang.org/cl/6822111
2012-11-12 07:25:54 -08:00
Andrew Gerrand
2100947d4a
doc/faq: discuss virtual memory use by go processes
...
Fixes #3948 .
R=golang-dev, r, dave, dsymonds
CC=golang-dev
https://golang.org/cl/6639064
2012-10-11 14:21:19 +11:00
Russ Cox
10ea6519e4
build: make int 64 bits on amd64
...
The assembly offsets were converted mechanically using
code.google.com/p/rsc/cmd/asmlint. The instruction
changes were done by hand.
Fixes #2188 .
R=iant, r, bradfitz, remyoudompheng
CC=golang-dev
https://golang.org/cl/6550058
2012-09-24 20:57:01 -04:00
Rob Pike
4be9b83eb6
faq: go does not have duck typing
...
R=golang-dev, 0xjnml, iant, adonovan, aram
CC=golang-dev
https://golang.org/cl/6500092
2012-09-07 14:01:02 -07:00
Rob Pike
91f2a34ddc
faq: mercurial vs. git
...
Fixes #4052 .
R=golang-dev, bradfitz, iant, rsc
CC=golang-dev
https://golang.org/cl/6490092
2012-09-07 11:19:01 -07:00
Rob Pike
0cab7d52d5
faq: another way to solve the closure/variable/range complaint
...
It's easier just to declare a new variable.
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/6501103
2012-09-07 09:11:39 -07:00
Rob Pike
8de5080f34
faq: add status section
...
Fixes #3822 .
R=golang-dev, r, dsymonds, minux.ma, adg
CC=golang-dev
https://golang.org/cl/6395043
2012-07-16 13:31:15 -07:00
Dave Cheney
82cbcb0dd5
website: various html fixes
...
Fixes #3424 .
R=fullung, adg
CC=golang-dev
https://golang.org/cl/6343088
2012-07-11 09:41:08 -07:00
Andrew Gerrand
2a5879d1e2
doc: replace mentions of 6g with gc or the go command
...
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5846070
2012-03-20 13:50:05 +11:00
Shenghou Ma
c3eaef71ab
doc/go_faq: minor update
...
R=adg, r
CC=golang-dev
https://golang.org/cl/5849052
2012-03-17 15:53:40 +08:00
Francisco Souza
6033a48b77
doc: add Go's declaration syntax article
...
Originally published on The Go Programming Language Blog, July 7, 2010.
I did not put any go file in doc/progs. Shoul I include Go files
with those declarations?
http://blog.golang.org/2010/07/gos-declaration-syntax.html
Update #2547 .
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/5795068
2012-03-13 14:46:08 +11:00
Russ Cox
40807282ac
doc: delete faq question about 6g
...
Fixes #3230 .
R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/5753071
2012-03-07 11:37:56 -05:00
Rob Pike
0130a31366
go_faq: a simple binary is a little smaller now
...
About 10% for hello, world.
Maybe more reductions will come.
Also clarify that we're comparing printf against Printf
(gcc can optimize aggressively, making this a different
sort of comparison).
R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/5756070
2012-03-07 15:29:26 +11:00
Shenghou Ma
97b13acb67
doc: update links
...
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/5754051
2012-03-07 08:15:47 +11:00
Andrew Gerrand
a22b0f82a2
doc: add command docs page, canonicalize reference paths
...
R=golang-dev, kyle, r
CC=golang-dev
https://golang.org/cl/5728055
2012-03-05 15:30:27 +11:00
Shenghou Ma
cb6c09a75a
doc: update link to self-hosted "The Laws of Reflection" article
...
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5717046
2012-03-01 14:54:35 +08:00
Stefan Nilsson
c50074e510
doc: add a bunch of missing <p> tags
...
R=golang-dev, gri
CC=golang-dev
https://golang.org/cl/5707065
2012-02-29 15:07:52 -08:00
Rob Pike
5cff1903ea
FAQ: many small fixes and adjustments
...
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/5685048
2012-02-20 12:42:50 +11:00
Ian Lance Taylor
ebc4007708
doc: clarify gccgo support for segmented stacks
...
R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/5671081
2012-02-17 05:59:15 -08:00
Rob Pike
1e0f97ac65
faq: add entry about nil interfaces vs. nil pointers
...
Fixes #2778 .
R=bradfitz, rsc, iant, adg
CC=golang-dev
https://golang.org/cl/5672078
2012-02-17 16:27:17 +11:00
Rob Pike
01afb79c59
FAQ: more words about why GOMAXPROCS>1 might not speed you up
...
R=golang-dev, adg, gri
CC=golang-dev
https://golang.org/cl/5572067
2012-01-26 14:44:38 -08:00
Rob Pike
fcfed1479e
FAQ: update to Go 1.
...
R=adg, rsc, r
CC=golang-dev
https://golang.org/cl/5562051
2012-01-23 08:39:53 -08:00
Andrew Gerrand
7cb21a79a4
godoc: specify HTML page metadata with a JSON blob
...
This allows HTML pages to specify arbitrary data in a header:
<!--{
"Title": "The page title",
...
}-->
replacing the old style comments:
<!-- title The page title -->
R=gri, rsc, r, bradfitz, dsymonds
CC=golang-dev
https://golang.org/cl/5532093
2012-01-19 11:24:54 +11: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
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
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
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
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
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
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
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
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
Rob Pike
966bf71366
docs: make "runtime" a word only as a name for the package.
...
Computer people have an agglutinating streak that I like to resist.
As a time of execution: run time.
As an adjective: run-time.
As a noun: run-time support/code/library.
Signed,
Mr. Pedant.
R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/4252048
2011-03-01 13:54:22 -08:00
Andrew Gerrand
4b0ecd3f49
doc: add FAQ about large binaries and stack vs heap allocation
...
doc: add internationalization to roadmap
R=rsc, r, r2
CC=golang-dev
https://golang.org/cl/4251047
2011-03-01 21:35:46 +11:00
Rob Pike
a64e63227a
faq: fix minor errors in programs reported by Wojciech Mikanik
...
R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/4114041
2011-01-26 10:41:32 -08:00
Rob Pike
80e25fc923
docs: float->float64 plus a couple of other tweaks.
...
R=rsc, gri
CC=golang-dev
https://golang.org/cl/3978042
2011-01-19 23:07:38 -05:00
Andrew Gerrand
affd1ba94e
doc: fix invalid id attribute in faq
...
R=r
CC=golang-dev
https://golang.org/cl/3516042
2010-12-09 08:59:29 +11:00
Andrew Gerrand
5ec55c5134
doc: faq updates part one
...
R=r, r2
CC=golang-dev
https://golang.org/cl/2301041
2010-09-30 11:23:39 +10:00
Andrew Gerrand
4164d60cc2
doc: consolidate FAQs into a single file, go_faq.html
...
An entirely mechanical change, with these exceptions:
- removed 'stub questions' that reference the other FAQs
- removed "Why doesn't Go run on Windows yet?" - out of date
I will follow this CL with another that updates many of the
answers to make them more current.
R=r
CC=golang-dev
https://golang.org/cl/2300041
2010-09-29 16:52:22 +10:00
Andrew Gerrand
6ab8d24d72
golang.org redesign
...
R=r, rsc, gri
CC=golang-dev, iant, ken2, lvd, nigeltao_golang, stephenm
https://golang.org/cl/2182042
2010-09-16 14:01:02 +10:00
Andrew Gerrand
05427748ef
go_faq: typo fix
...
R=rsc
CC=golang-dev
https://golang.org/cl/962043
2010-04-23 10:02:10 +10:00
Andrew Gerrand
aa2187efa3
faq: more up-to-date info about the Windows port
...
R=r
CC=golang-dev
https://golang.org/cl/961041
2010-04-22 09:15:35 +10:00
Andrew Gerrand
0857573a67
go_faq: add question: Why does Go perform badly on benchmark X?
...
R=r, cw
CC=golang-dev
https://golang.org/cl/895043
2010-04-21 14:00:56 +10:00
Rob Pike
6b3031beaa
FAQ: Protocol buffers are now supported. Update the entry.
...
R=rsc, adg
CC=golang-dev
https://golang.org/cl/702042
2010-03-23 17:03:28 -07:00
Andrew Gerrand
1d5af1553c
First run at a Programming FAQ
...
Moved a couple of FAQs from the main FAQ, and added some others
R=r, rsc, iant, gri
CC=golang-dev
https://golang.org/cl/218070
2010-03-04 12:56:08 +11:00
Russ Cox
6301fb4134
faq: add question about translation
...
R=jini, r
https://golang.org/cl/163092
2009-12-03 17:23:33 -08:00
Rob Pike
bdecae9e00
add an FAQ entry about the logo and mascot
...
R=rsc
CC=golang-dev, reneefrench
https://golang.org/cl/157144
2009-11-23 17:34:23 -08:00
Rob Pike
d8134e73c7
add a paragraph in the FAQ about the situation with Windows support
...
R=rsc, iant
CC=golang-dev
https://golang.org/cl/154059
2009-11-11 11:44:27 -08:00
Rob Pike
6898f95dec
make the titles of the FAQs match their links; adds clarity too. requested by rsc.
...
R=rsc
CC=go-dev
http://go/go-review/1025034
2009-11-09 23:54:35 -08:00
Rob Pike
7685a67fe8
add a q&a about google's internal use of go
...
R=rsc
CC=go-dev
http://go/go-review/1026035
2009-11-09 20:25:45 -08:00
Russ Cox
e434f1a763
FAQ edits
...
R=r
CC=go-dev
http://go/go-review/1024015
2009-11-07 17:31:22 -08:00
Rob Pike
0c2a479a39
significant cleanup of the main FAQ
...
R=rsc
CC=go-dev
http://go/go-review/1017008
2009-11-01 20:50:42 -08:00
Russ Cox
3227445b75
add FAQ
...
R=r
DELTA=13 (0 added, 8 deleted, 5 changed)
OCL=35985
CL=35987
2009-10-22 00:13:51 -07:00