From 8c395778b8e728356a6acad35cb896b0e2391b4c Mon Sep 17 00:00:00 2001 From: Rob Pike Date: Thu, 12 Nov 2009 14:10:16 -0800 Subject: add a paragraph about semicolons to the tutorial. fix a typo caught by kakugawa@gmail.com Fixes issue 92. R=rsc CC=golang-dev http://codereview.appspot.com/152105 --- doc/go_spec.html | 2 +- doc/go_tutorial.html | 13 ++++++++++++- doc/go_tutorial.txt | 11 +++++++++++ doc/progs/echo.go | 2 +- 4 files changed, 25 insertions(+), 3 deletions(-) diff --git a/doc/go_spec.html b/doc/go_spec.html index bd98c4290..9abebfbe7 100644 --- a/doc/go_spec.html +++ b/doc/go_spec.html @@ -2300,7 +2300,7 @@ var r, ok = a[x]

the result of the index expression is a pair of values with types -(K, bool). +(V, bool). If the key is present in the map, the expression returns the pair (a[x], true); otherwise it returns (Z, false) where Z is diff --git a/doc/go_tutorial.html b/doc/go_tutorial.html index bbd87bb61..201c503bb 100644 --- a/doc/go_tutorial.html +++ b/doc/go_tutorial.html @@ -110,7 +110,7 @@ Next up, here's a version of the Unix utility echo(1): 23 if i > 0 { 24 s += Space 25 } -26 s += flag.Arg(i) +26 s += flag.Arg(i); 27 } 28 if !*omitNewline { 29 s += Newline @@ -135,6 +135,17 @@ Semicolons aren't needed here; in fact, semicolons are unnecessary after any top-level declaration, although they are needed as separators within a parenthesized list of declarations.

+You can use semicolons just the way you would in C, C++, or Java, but if you +prefer you can also leave them out in many cases. They separate statements +rather than terminate them, so they aren't needed (but are still OK) at the end of the last +statement in a block. +They're also optional after braces, as in C. +Have a look at the source to echo. +The only necessary semicolons in that program are on lines 8, 15, and 21 +and of course between the elements of the for loop on line 22. +The ones on line 9, 16, 26, and 31 are optional but are there because a semicolon +on the end of a list of statements makes it easier to edit the list later. +

This program imports the "os" package to access its Stdout variable, of type *os.File. The import statement is actually a declaration: in its general form, as used in our ``hello world'' program, diff --git a/doc/go_tutorial.txt b/doc/go_tutorial.txt index 8d57dffb6..b8e18dab8 100644 --- a/doc/go_tutorial.txt +++ b/doc/go_tutorial.txt @@ -94,6 +94,17 @@ Semicolons aren't needed here; in fact, semicolons are unnecessary after any top-level declaration, although they are needed as separators within a parenthesized list of declarations. +You can use semicolons just the way you would in C, C++, or Java, but if you +prefer you can also leave them out in many cases. They separate statements +rather than terminate them, so they aren't needed (but are still OK) at the end of the last +statement in a block. +They're also optional after braces, as in C. +Have a look at the source to "echo". +The only necessary semicolons in that program are on lines 8, 15, and 21 +and of course between the elements of the "for" loop on line 22. +The ones on line 9, 16, 26, and 31 are optional but are there because a semicolon +on the end of a list of statements makes it easier to edit the list later. + This program imports the ""os"" package to access its "Stdout" variable, of type "*os.File". The "import" statement is actually a declaration: in its general form, as used in our ``hello world'' program, diff --git a/doc/progs/echo.go b/doc/progs/echo.go index 26a2f68b5..4761c1e97 100644 --- a/doc/progs/echo.go +++ b/doc/progs/echo.go @@ -23,7 +23,7 @@ func main() { if i > 0 { s += Space } - s += flag.Arg(i) + s += flag.Arg(i); } if !*omitNewline { s += Newline -- cgit v1.2.1