Commit Graph

128 Commits

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