diff -ur tcl8.6.6/doc/Namespace.3 tcl8.6.6_mod/doc/Namespace.3
--- tcl8.6.6/doc/Namespace.3	2016-02-25 21:12:37.000000000 +0100
+++ tcl8.6.6_mod/doc/Namespace.3	2017-01-08 14:04:22.190390766 +0100
@@ -112,7 +112,11 @@
 \fIparentPtr\fR (a pointer to the containing namespace, or NULL for
 the global namespace.)
 .PP
-\fBTcl_CreateNamespace\fR creates a new namespace.  The
+\fBTcl_CreateNamespace\fR creates a new namespace with the given \fIname\fR.
+If \fIname\fR contains "::" qualifiers and a parent namespace does not
+already exist, it is automatically created. If the namespace
+already exists or if another error occurs, this function returns NULL 
+and leaves an error message in \fIinterp\fR. The
 \fIdeleteProc\fR will have the following type signature:
 .PP
 .CS
