encoding/xml: undocumented Reset method

[robpike]

As reported by cmd/api (yay bradfitz) xml.Encoder now has an undocumented Reset method.
This arose when the same method arrived for bufio.Writer. It's not the only secret
method.  http://play.golang.org/p/PDNKC2oMsN


Let's tidy this up.

[rsc]

Comment 1:

Please, no one start working on this. I have many pending changes to the xml package and
will do this once they are in.

Owner changed to @rsc.

Status changed to Started.

[bradfitz]

Comment 2:

There are two bugs here.
One is fixing godoc to reflect reality, using go/types.  I filed issue #6127 for that.
This bug is about hiding the embedded methods from the xml package.
This commit shows the always-there-but-never-promised methods that we now know about:
https://code.google.com/p/go/source/detail?r=f5b37c93e4c5bb2962c
pkg encoding/xml, method (Encoder) Available() int
pkg encoding/xml, method (Encoder) Buffered() int
pkg encoding/xml, method (Encoder) Flush() error
pkg encoding/xml, method (Encoder) Write([]uint8) (int, error)
pkg encoding/xml, method (Encoder) WriteByte(uint8) error
pkg encoding/xml, method (Encoder) WriteRune(int32) (int, error)
pkg encoding/xml, method (Encoder) WriteString(string) (int, error)
We could technically remove those (we never promised them, and they were never
documented), but it could maybe break code, if people somehow knew about them.

[rsc]

Comment 3:

They're going away.

[rsc]

Comment 4:

This issue was closed by revision 85f3acd.

Status changed to Fixed.

[rsc]

Comment 5:

This issue was closed by revision 56ce83f.

[rsc]

Comment 6:

This issue was closed by revision 54bdfc0.