diff --git a/Doc/Manual/SWIGPlus.html b/Doc/Manual/SWIGPlus.html
index 3e7860b9b..b22f1c279 100644
--- a/Doc/Manual/SWIGPlus.html
+++ b/Doc/Manual/SWIGPlus.html
@@ -3915,6 +3915,8 @@ then SWIG simply creates three wrapper functions bar(),
spam(), and blah() in the target language. SWIG
does not prepend the names with a namespace prefix nor are the
functions packaged in any kind of nested scope.
+Note that the default handling of flattening all the namespace scopes in the target language
+can be changed via the nspace feature.
@@ -4203,9 +4205,7 @@ namespace foo {
Note: The flattening of namespaces is only intended to serve as
a basic namespace implementation.
-None of the target language modules are currently programmed
-with any namespace awareness. In the future, language modules may or may not provide
-more advanced namespace support.
+More advanced handling of namespaces is discussed next.