code review 6618055: exp/html: update package docs; a node's children is a linked

exp/html: update package docs and add an example; a node's children is
a linked list, not a slice.

[nigeltao, 2012-10-07 08:55:02]

Hello r@golang.org (cc: golang-dev@googlegroups.com),

I'd like you to review this change to
https://go.googlecode.com/hg/

[minux1, 2012-10-07 08:57:26]

Can you (also?) make that code snippet an Example function so that compiler
can check that for us?

[nigeltao, 2012-10-07 09:55:58]

On 7 October 2012 19:57,  <minux.ma@gmail.com> wrote:
> Can you (also?) make that code snippet an Example function so that
> compiler
> can check that for us?
>
> http://codereview.appspot.com/6618055/

Done.

[minux1, 2012-10-07 10:01:14]

LGTM.

[r, 2012-10-07 12:33:26]

http://codereview.appspot.com/6618055/diff/9001/src/pkg/exp/html/example_test.go
File src/pkg/exp/html/example_test.go (right):

http://codereview.appspot.com/6618055/diff/9001/src/pkg/exp/html/example_test...
src/pkg/exp/html/example_test.go:5: // This example demonstrates parsing HTML
data and walking the resulting tree.
is this the right place for this comment?

[nigeltao, 2012-10-12 08:32:56]

https://codereview.appspot.com/6618055/diff/9001/src/pkg/exp/html/example_tes...
File src/pkg/exp/html/example_test.go (right):

https://codereview.appspot.com/6618055/diff/9001/src/pkg/exp/html/example_tes...
src/pkg/exp/html/example_test.go:5: // This example demonstrates parsing HTML
data and walking the resulting tree.
On 2012/10/07 12:33:26, r wrote:
> is this the right place for this comment?

Shrug. Not all example_test.go files have it, but e.g. flag/example_test.go and
container/heap/example_test.go have similar 'package doc comments'.

[nigeltao, 2012-10-17 23:26:00]

*** Submitted as http://code.google.com/p/go/source/detail?r=9b2c48c9d597 ***

exp/html: update package docs and add an example; a node's children is
a linked list, not a slice.

R=r, minux.ma
CC=golang-dev
http://codereview.appspot.com/6618055