fixes #1739

1 files changed, 9 insertions, 3 deletions

diff --git a/doc/manual/modules.txt b/doc/manual/modules.txt
index 95a13a560..6ca32fef8 100644
--- a/doc/manual/modules.txt
+++ b/doc/manual/modules.txt
@@ -45,13 +45,19 @@ Import statement
 ~~~~~~~~~~~~~~~~
 
 After the ``import`` statement a list of module names can follow or a single
-module name followed by an ``except`` to prevent some symbols to be imported:
+module name followed by an ``except`` list to prevent some symbols to be
+imported:
 
 .. code-block:: nim
-  import strutils except `%`
+  import strutils except `%`, toUpper
 
   # doesn't work then:
-  echo "$1" % "abc"
+  echo "$1" % "abc".toUpper
+
+
+It is not checked that the ``except`` list is really exported from the module.
+This feature allows to compile against an older version of the module that
+lacks does not export these identifiers.
 
 
 Include statement