aboutsummaryrefslogtreecommitdiff
path: root/doc/go_mem.html
AgeCommit message (Collapse)Author
2024-03-04doc: close HTML tagscui fliter
Add unclosed HTML tags and remove redundant </a> tags. Change-Id: I3fffbcfd640001c9cc4f6085150344daa0c4369b Reviewed-on: https://go-review.googlesource.com/c/go/+/568155 Reviewed-by: Bryan Mills <bcmills@google.com> Run-TryBot: shuang cui <imcusg@gmail.com> TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Ian Lance Taylor <iant@google.com> Auto-Submit: Ian Lance Taylor <iant@google.com> LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
2023-08-03doc: fix html tagscui fliter
Change-Id: I535bec2de8f4f7dd415896a020d71c373c22be56 Reviewed-on: https://go-review.googlesource.com/c/go/+/515155 Run-TryBot: shuang cui <imcusg@gmail.com> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org> Run-TryBot: Dmitri Shuralyov <dmitshur@golang.org> TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org> Reviewed-by: David Chase <drchase@google.com>
2023-07-31doc/go_mem: explain arrays, structs, and complex numbersRuss Cox
Arrays, structs, and complex numbers are collections of values that are handled separately by the memory model. An earlier version may have said this, but the current version does not. Say it. Change-Id: If3928bed6659e58e688f88aa0dde05423cbb3820 Reviewed-on: https://go-review.googlesource.com/c/go/+/514476 Run-TryBot: Russ Cox <rsc@golang.org> TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Matthew Dempsky <mdempsky@google.com> Reviewed-by: Ian Lance Taylor <iant@google.com>
2022-06-10doc: fix typos in Go memory modelDominik Honnef
Change-Id: I8e94215d9bee0ea3ad378870fe565e961a9d80c9 Reviewed-on: https://go-review.googlesource.com/c/go/+/411595 Reviewed-by: Ian Lance Taylor <iant@google.com> Auto-Submit: Ian Lance Taylor <iant@google.com> Run-TryBot: Ian Lance Taylor <iant@google.com> TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
2022-06-06doc/go_mem: update revision dateRuss Cox
CL 381315 added major revisions but neglected to update the date. For #50859. Change-Id: I086a55f0c80579c479bca5268109c9f3ae680adf Reviewed-on: https://go-review.googlesource.com/c/go/+/410675 Reviewed-by: Roland Shoemaker <roland@golang.org> Run-TryBot: Russ Cox <rsc@golang.org> Reviewed-by: Ian Lance Taylor <iant@golang.org> Auto-Submit: Russ Cox <rsc@golang.org> Reviewed-by: Alan Donovan <adonovan@google.com>
2022-06-04doc: update Go memory modelRuss Cox
Following discussion on #47141, make the following changes: - Document Go's overall approach. - Document that multiword races can cause crashes. - Document happens-before for runtime.SetFinalizer. - Document (or link to) happens-before for more sync types. - Document happens-before for sync/atomic. - Document disallowed compiler optimizations. See also https://research.swtch.com/gomm for background. Fixes #50859. Change-Id: I17d837756a77f4d8569f263489c2c45de20a8778 Reviewed-on: https://go-review.googlesource.com/c/go/+/381315 Reviewed-by: Ian Lance Taylor <iant@google.com>
2020-03-03doc/mem: remove unnecessary pre tags within same snippetJingwei
currently the snippet is segmented but should be one code snippet. Change-Id: Ic747faf9bb1b52f9d1786eca70616a05b71ee801 Reviewed-on: https://go-review.googlesource.com/c/go/+/211198 Reviewed-by: Emmanuel Odeke <emm.odeke@gmail.com>
2018-12-21doc: go_mem: clarify Once docsIan Lance Taylor
Fixes #27808 Change-Id: Ia643d51004c47953642a2ba41dfed281f1112be6 Reviewed-on: https://go-review.googlesource.com/c/155637 Reviewed-by: Bryan C. Mills <bcmills@google.com>
2015-03-16doc/go_mem.html: correct the channel exampleShenghou Ma
While we're here, also fix two HTML issues. Fixes #9235. Change-Id: I6e2f50931c0f387881271484a726ac2308518cf4 Reviewed-on: https://go-review.googlesource.com/7602 Reviewed-by: Rob Pike <r@golang.org>
2014-10-27doc/go_mem.html: don't be cleverRob Pike
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://golang.org/cl/158500043
2014-06-05doc: fix happens-before rules for buffered channelsDmitriy Vyukov
The current wording is reversed in 2 places. Not sure how it got 4 LGTMs (mine was there as well). Update #6242. LGTM=dan.kortschak, r, rsc R=golang-codereviews, 0xjnml, dan.kortschak, r, rsc CC=golang-codereviews https://golang.org/cl/101980047
2014-03-24doc: allow buffered channel as semaphore without initializationRuss Cox
This rule not existing has been the source of many discussions on golang-dev and on issues. We have stated publicly that it is true, but we have never written it down. Write it down. Fixes #6242. LGTM=r, dan.kortschak, iant, dvyukov R=golang-codereviews, r, dominik.honnef, dvyukov, dan.kortschak, iant, 0xjnml CC=golang-codereviews https://golang.org/cl/75130045
2013-10-04doc: move spec and memory model back to /ref/Andrew Gerrand
R=golang-dev, r CC=golang-dev https://golang.org/cl/14364043
2013-09-16doc: re-organize golang.org site contentAndrew Gerrand
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-08-23doc: correct a minor go_mem.html mistakeJan Mercl
Fixes #6227 R=golang-dev, bradfitz CC=golang-dev https://golang.org/cl/13183043
2012-09-11doc: Don't imply incorrect guarantees about data races.David Symonds
A race between a = "hello, world" and print(a) is not guaranteed to print either "hello, world" or "". Its behaviour is undefined. Fixes #4039. R=rsc CC=dvyukov, gobot, golang-dev, r https://golang.org/cl/6489075
2012-03-19doc: various typos, remove apostrophes from ordinalsJeremy Jackins
R=golang-dev, r, r CC=golang-dev https://golang.org/cl/5845059
2012-03-08doc: fix metadata in go_mem.htmlAndrew Gerrand
R=golang-dev, dsymonds CC=golang-dev https://golang.org/cl/5781053
2012-03-08doc/go_mem: init-created goroutine behavior changes for Go 1Shenghou Ma
They can start execution even before all init functions end. R=rsc, r, adg CC=golang-dev https://golang.org/cl/5732061
2012-03-05doc: add command docs page, canonicalize reference pathsAndrew Gerrand
R=golang-dev, kyle, r CC=golang-dev https://golang.org/cl/5728055
2012-01-19godoc: specify HTML page metadata with a JSON blobAndrew Gerrand
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
2011-09-26doc: fix memory model read visibility bugRuss Cox
Fixes #2277. R=dvyukov, r CC=golang-dev https://golang.org/cl/5083044
2011-06-10Go memory model: minor clarificationRobert Griesemer
Fixes #1941. R=rsc CC=golang-dev https://golang.org/cl/4576053
2011-05-16doc/go_mem.html: close happens before receive on closed channelRuss Cox
R=golang-dev, gri CC=golang-dev https://golang.org/cl/4551042
2010-12-14typoRuss Cox
R=iant CC=golang-dev https://golang.org/cl/3582042
2010-12-13go_mem: goroutine exit is not specialRuss Cox
R=r CC=golang-dev https://golang.org/cl/3628041
2010-09-20doc/go_mem.html: update location of "once".Rob Pike
Fixes #1118. R=rsc CC=golang-dev https://golang.org/cl/2225044
2010-04-06doc/go_mem: remove semicolonsDavid Symonds
R=adg CC=golang-dev https://golang.org/cl/893041
2010-02-22go_mem: clarified unbuffered channel sync exampleAndrew Gerrand
R=rsc CC=golang-dev https://golang.org/cl/218063
2009-11-08assorted cleanupRuss Cox
R=r, iant CC=go-dev http://go/go-review/1025024
2009-11-01fixups for memory model documentRob Pike
R=rsc CC=go-dev http://go/go-review/1016018
2009-10-01Factored out boilerplate from all html docs in doc directory:Robert Griesemer
- the first HTML comment in those files is extracted as page title when serving them - lib/godoc.html is top-level template for all pages served - experimented a bit with package documentation layout (feedback welcome) - various related cleanups TODO: - The / page (doc/root.html) content repeats links that are in the navigation bar. It needs to be cleaned up. R=rsc DELTA=826 (86 added, 692 deleted, 48 changed) OCL=35230 CL=35245
2009-09-29make the sidebars consistentRob Pike
add Effective Go to the set of links DELTA=166 (62 added, 57 deleted, 47 changed) OCL=35085 CL=35089
2009-09-17A step towards "externalizing" some Go docs.Larry Hosken
+ style sheet: like code.google.com but less feature-ful + JS with table-of-contents generation + tweaked go_spec.html and go_mem.html to use new style+JS + static-HTML-ified a few other Go docs: + static HTML versions of some wiki pages (which I'll turn into links to these pages). A notable thing that is _not_ in this changelist: any change to the godoc tool or whatever thing generates http://go/godoc R=r APPROVED=r DELTA=2472 (2307 added, 113 deleted, 52 changed) OCL=34644 CL=34728
2009-03-22change file name so it can be copied without name change to a more public place.Rob Pike
R=rsc DELTA=1090 (545 added, 545 deleted, 0 changed) OCL=26629 CL=26629