document strings

R=rsc
DELTA=9  (4 added, 0 deleted, 5 changed)
OCL=25793
CL=25795

bug085 bug129

R=ken
OCL=25787
CL=25791

new switch implementation
in preparation of type switch.
no functional change (yet).

R=r
OCL=25784
CL=25788

net: doc, doc-inspired cleanup

R=r
DELTA=368  (87 added, 14 deleted, 267 changed)
OCL=25773
CL=25786

strconv: doc

R=r
DELTA=110  (64 added, 19 deleted, 27 changed)
OCL=25761
CL=25782

revert QualifiedIdent to old production

R=r
DELTA=1  (0 added, 0 deleted, 1 changed)
OCL=25732
CL=25777

misc doc

R=r
DELTA=50  (28 added, 0 deleted, 22 changed)
OCL=25763
CL=25770

delete deprecated files.
deletion beats documentation for deprecation.

R=rsc,gri
DELTA=509  (2 added, 490 deleted, 17 changed)
OCL=25737
CL=25768

math: doc

R=r
DELTA=173  (74 added, 14 deleted, 85 changed)
OCL=25753
CL=25767

document vector

R=rsc
DELTA=36  (30 added, 0 deleted, 6 changed)
OCL=25740
CL=25766

log: document

R=rsc
DELTA=26  (17 added, 1 deleted, 8 changed)
OCL=25731
CL=25734

flag: document
also write to stderr not stdout

R=rsc
DELTA=48  (38 added, 2 deleted, 8 changed)
OCL=25729
CL=25733

delete bogus vestige

R=rsc
OCL=25730
CL=25730

typos

R=gri
DELTA=3  (0 added, 1 deleted, 2 changed)
OCL=25728
CL=25728

sync: add documentation

R=r
DELTA=63  (57 added, 1 deleted, 5 changed)
OCL=25727
CL=25727

remove some incorrect capitalizations.
add commentary.

R=rsc
DELTA=231  (41 added, 24 deleted, 166 changed)
OCL=25724
CL=25726

fix an HTML glitch.
say a little more about package main.

R=rsc
DELTA=7  (4 added, 0 deleted, 3 changed)
OCL=25725
CL=25725

reject invalid map key types at compile time

R=ken
OCL=25720
CL=25720

fix build

TBR=gri
OCL=25719
CL=25719

Suggested tweaks up to package section.

Major ones:
* Be consistent: "numeric type" and "arithmetic operator".
* if/swtch take "simple statement" not "short variable declaration".
* There was a comment that implied for x,y := range z() might
  evaluate z() multiple times.  I deleted it.

R=r,gri
DELTA=124  (24 added, 4 deleted, 96 changed)
OCL=25706
CL=25715

- missing makefile

R=r
OCL=25714
CL=25714

Created new directory lib/lang:
- move scanner to into lib/lang
- added test
- adjusted various make and build files

R=r
DELTA=1731  (973 added, 753 deleted, 5 changed)
OCL=25668
CL=25713

disallow ordinary-type.(T), as in spec.

R=ken
OCL=25705
CL=25705

change Go logo to link to home page

fix grammar for forward declaration of interface, struct.

move array down next to slice.

fix type equal example for structs.

R=r,gri
DELTA=247  (122 added, 114 deleted, 11 changed)
OCL=25694
CL=25704

Preparation for moving scanner into a lib:
- separated out token definition from scanner
- cleaned up token and scanner implementation
- added comments to exported interfaces

R=r
OCL=25665
CL=25665

rephrase redundancy.

R=rsc
DELTA=1  (0 added, 0 deleted, 1 changed)
OCL=25652
CL=25656

enable pretty in run.bash

R=rsc
DELTA=5  (0 added, 0 deleted, 5 changed)
OCL=25651
CL=25655

update missed test case to {}

R=rsc
DELTA=1  (0 added, 0 deleted, 1 changed)
OCL=25648
CL=25654

- allow ()'s and {}'s for now when parsing calls/composite literals
- require ()'s around composite literals at the if/for/switch control clause level
- fixed a nasty bug: passing a value instead of a pointer to a value to an interface
  variable - and not noticing that the value is copied

R=r
OCL=25649
CL=25649

The final piece of the alternative to my parens proposal
(i.e., the status quo with braces in composite literals).

DELTA=20  (16 added, 0 deleted, 4 changed)
OCL=25640
CL=25646

back to T{x}, stricter handling of T(x) vs x.(T)

R=ken
DELTA=131  (60 added, 41 deleted, 30 changed)
OCL=25617
CL=25633

Automated g4 rollback of changelist 25024,
plus significant hand editing.

Back to T{x} for composite literals.

R=r
OCL=25612
CL=25632

clarify conversions vs type guards.
allow conversions between equal types.

R=r
DELTA=15  (4 added, 4 deleted, 7 changed)
OCL=25618
CL=25630

scanner cleanup - getting it ready to as a library
- removed unneeded code that accumulated over time
- change src from string to []byte (perhaps should be io.Read
but that has some other disadvantages)
- simplified interface

R=r
OCL=25615
CL=25615

redo poor example of slices.

R=rsc
OCL=25614
CL=25614

address most of the editorial comments through "types"

R=rsc
DELTA=41  (9 added, 4 deleted, 28 changed)
OCL=25611
CL=25611

- itob
- more test cases

R=rsc
DELTA=97  (52 added, 4 deleted, 41 changed)
OCL=25585
CL=25607

delete paragraph about unimplemented select-on-type feature.
change () to {} in all composite literals

DELTA=20  (0 added, 7 deleted, 13 changed)
OCL=25604
CL=25606

Packages.

DELTA=170  (73 added, 21 deleted, 76 changed)
OCL=25556
CL=25594

fix names: s/fd/r/

R=r
DELTA=9  (0 added, 0 deleted, 9 changed)
OCL=25593
CL=25593

most of the rest.
only the package section is untouched.

R=gri
DELTA=542  (186 added, 70 deleted, 286 changed)
OCL=25485
CL=25532

fix a bug: do not print a ';' after a label if there wasn't one

R=r
OCL=25526
CL=25528

Steps towards a general scanner/parser library for Go:
- converted more of AST and parser to use interfaces and explicit
structs for individual Go constructs (can be replaced now with
interface calls such that the parser becomes AST structure
independent, as suggested by rsc)
- added more tests (find all .go files under GOROOT)
- (temporarily) lost html links for identifiers when generating
html output
- TODO: lots of cleanups

R=r
OCL=25518
CL=25518

finish types.
expressions.  (they were in pretty good shape; mostly cosmetic and HTML edits)

R=gri
DELTA=655  (226 added, 97 deleted, 332 changed)
OCL=25459
CL=25481

fixed a typo

R=r
DELTA=1  (0 added, 0 deleted, 1 changed)
OCL=25449
CL=25449

bug130 is fixed

R=ken
OCL=25448
CL=25448

Continue editing types section.
Do a little work polishing the "zero value" discussion.

R=gri
DELTA=486  (129 added, 120 deleted, 237 changed)
OCL=25392
CL=25444

complete types

R=gri
DELTA=29  (0 added, 12 deleted, 17 changed)
OCL=25388
CL=25391

text and formatting are now folded into go_spec; delete

OCL=25292
CL=25383

Updated the section on Types.
Moved assignment compatibility to its own small section. Although most rules are type-specific,
some are not and it reduces redundancy to combine them.
Also, more experimentally, wrote a section on comparison compatibility.

R=gri
DELTA=382  (125 added, 122 deleted, 135 changed)
OCL=25355
CL=25382

bug 130 (go/defer) interface.method()

R=r
OCL=25356
CL=25356

Move Types before Declarations and Scopes.
This is the only change in this CL: only rearrangement, no content change, so subsequent edits will be easier to understand.

R=gri
OCL=25353
CL=25353

Work on declarations, unsafe, alignment.
Change <tt> to <code>

R=gri
DELTA=664  (222 added, 189 deleted, 253 changed)
OCL=25294
CL=25352

- fixed a bug with //-comment parsing

R=r
OCL=25343
CL=25343

add logo to documentation directory.

R=rsc
OCL=25293
CL=25293

bug with select :=

R=r
OCL=25278
CL=25278

draft of memory model.

R=tgs
DELTA=545  (545 added, 0 deleted, 0 changed)
OCL=25212
CL=25268

Rewrite lexical section.
Put grammar productions into a box with a separate background color.

R=gri
DELTA=397  (132 added, 49 deleted, 216 changed)
OCL=25235
CL=25258

autogenerate the table of contents

R=rsc
DELTA=149  (1 added, 145 deleted, 3 changed)
OCL=25231
CL=25234

Fix most HTML errors.
Cut introduction.
Start rewrite.

R=gri
DELTA=201  (20 added, 118 deleted, 63 changed)
OCL=25226
CL=25229

go_spec.txt formatted in html.
No textual changes except for html formatting.
Seems like a fine intermediate step.

R=r
DELTA=7638  (4079 added, 3559 deleted, 0 changed)
OCL=25211
CL=25224

- permit ()'s in types (TODO: update spec)
- accept embedded interfaces in interfaces
- missing: output incorrect, but at least all source code is accepted again

R=r
OCL=25223
CL=25223

Finish the lexical section.

DELTA=176  (172 added, 0 deleted, 4 changed)
OCL=25182
CL=25222

First piece of Go reference manual.

R=ken,gri,rsc
DELTA=185  (185 added, 0 deleted, 0 changed)
OCL=25133
CL=25169

allow parens to disambiguate types.
examples:

chan <- (chan int)
chan (<- chan int)
(map[string]func())("a": main)

R=ken
OCL=25151
CL=25151

drop trailing slashes - missed comment from last review

TBR=rsc
OCL=25135
CL=25135

more fun with triv.go: flags and arguments

R=rsc
DELTA=23  (23 added, 0 deleted, 0 changed)
OCL=25088
CL=25134

few more Sizeof.

R=r
DELTA=3  (0 added, 1 deleted, 2 changed)
OCL=25106
CL=25106

fix unsafe.Sizeof("abc")

R=rsc
OCL=25105
CL=25105

use proper strconv in string values.
make test a little stronger.

R=rsc
DELTA=94  (27 added, 39 deleted, 28 changed)
OCL=25085
CL=25087

comment nit

R=r
DELTA=2  (0 added, 2 deleted, 0 changed)
OCL=25081
CL=25084

allow hex, octal in Atoi, etc.

R=r
DELTA=169  (79 added, 23 deleted, 67 changed)
OCL=25079
CL=25083

proposed XML parser design.
inspired by expat's callback interface,
but a bit simpler thanks to go interfaces.

also serves as reference notes about XML.

the parser itself is unimplemented.

not in Makefiles, though it does build.

R=r
DELTA=425  (425 added, 0 deleted, 0 changed)
OCL=25077
CL=25080

make interface to the flags themselves more public.
add visitor functions to scan the flags.
add a way to set a flag.
add a flag test.

R=rsc
DELTA=169  (99 added, 19 deleted, 51 changed)
OCL=25076
CL=25078

bug123

R=ken
OCL=25075
CL=25075

fix build  - missed this file before

TBR=r
OCL=25074
CL=25074

use embedded interface types

R=r
DELTA=205  (1 added, 157 deleted, 47 changed)
OCL=25071
CL=25073

embedded interface types in interfaces.

R=ken
OCL=25072
CL=25072

io.Pipe

assorted underscore cleanup

R=r
DELTA=488  (410 added, 3 deleted, 75 changed)
OCL=25070
CL=25070

assorted changes:
- use a lock instead of a thread in once
avoids deadlock in recursive once calls
- implement os.Setenv
- remove "export" from some scripts
- remove _ from names in time package
- fix time test for non-MTV machines

R=r
DELTA=265  (87 added, 58 deleted, 120 changed)
OCL=25057
CL=25057

change the URL in the test to avoid a redirection that breaks it in sydney.

R=rsc
OCL=25054
CL=25054

add os.ForkExec, os.Exec, os.Wait, exec.OpenCmd.
as thread-safe as possible, given the surrounding system.
add stub RWLock implementation.

R=r
DELTA=852  (834 added, 6 deleted, 12 changed)
OCL=25046
CL=25053

insert ${GOOS} and ${GOARCH} in
command-line comment.

R=r
DELTA=11  (6 added, 0 deleted, 5 changed)
OCL=25051
CL=25051

cleanups:
get rid of _ on private names in net.
fix os_test file name list.
newline not needed on Errorf.

R=r
DELTA=305  (34 added, 2 deleted, 269 changed)
OCL=25047
CL=25047

build nits

R=r
DELTA=8  (0 added, 6 deleted, 2 changed)
OCL=25045
CL=25045

bug fix for &x[0] when x is slice

R=ken
OCL=25044
CL=25044

- accept new composite literal syntax
- remove all parsing heuristics
- as a result, accept a wider syntax, but parser is simpler

R=r
OCL=25029
CL=25029

- added Makefile change again (lost due to to p4 misuse)

R=rsc
OCL=25026
CL=25026

- vector package (identical to array except for names)
- updated some file (but not all - left array package in place for now)

R=rsc
DELTA=530  (483 added, 0 deleted, 47 changed)
OCL=25025
CL=25025

convert composite literals from { } to ( ).

only non-trivial changes are in
convlit1.go
golden.out

R=gri
OCL=25019
CL=25024

add composite literal ( ) syntax.
warn about composite literal { } syntax.

R=ken
OCL=25018
CL=25023

fix build

TBR=r
OCL=25021
CL=25021

label declarations not handled properly

R=rsc
DELTA=27  (27 added, 0 deleted, 0 changed)
OCL=25015
CL=25015

- fixed bugs related to the empty statement
  (now in sync with the spec and with 6g)
- fixed incorrect logging statement in gds

R=r
OCL=24970
CL=24970

- syntax for composite literals use () instead of {}
- do not permit + for array concatenation anymore
  (not implemented and not a good idea)
- document that unsafe function results are compile time constants
- fixed minor typos

DELTA=41  (7 added, 11 deleted, 23 changed)
OCL=24899
CL=24927

require type assertions when narrowing.

R=ken
OCL=24350
CL=24914

insert type assertions when narrowing.

R=r
OCL=24349
CL=24913

fix gc bug.  i think this is tgs's second bug.
i stumbled across it in all.bash.

TBR=r
OCL=24912
CL=24912

- language for embedded interfaces (as discussed this morning)
- fixed a syntax error

R=r
DELTA=17  (15 added, 0 deleted, 2 changed)
OCL=24876
CL=24889

Added section on package unsafe:
- contains a (proposed) constant Maxalign
- contains some text re" alignment guarantees

R=ken,r
DELTA=97  (94 added, 1 deleted, 2 changed)
OCL=24791
CL=24871