encoding/xml: document behavior for undefined name space prefixes

Fixes #5626.

R=golang-dev, dominik.honnef
CC=golang-dev
https://golang.org/cl/13702043

diff --git a/src/pkg/encoding/xml/xml.go b/src/pkg/encoding/xml/xml.go
index 467c2ae14f81b937b1178dffbf5ba39e82936d59..5b9d670024e792e022db314e6e87d29d7addc680 100644 (file)
--- a/src/pkg/encoding/xml/xml.go
+++ b/src/pkg/encoding/xml/xml.go
@@ -150,6 +150,10 @@ type Decoder struct {
        //      d.Entity = HTMLEntity
        //
        // creates a parser that can handle typical HTML.
+       //
+       // Strict mode does not enforce the requirements of the XML name spaces TR.
+       // In particular it does not reject name space tags using undefined prefixes.
+       // Such tags are recorded with the unknown prefix as the name space URL.
        Strict bool
 
        // When Strict == false, AutoClose indicates a set of elements to