From 525ab5a497d1b998bc67c5b1225db3556ac77d27 Mon Sep 17 00:00:00 2001
From: hlaaftana <10591326+hlaaftana@users.noreply.github.com>
Date: Sun, 1 Mar 2020 23:52:29 +0300
Subject: [PATCH] Document import/include outside of top level semantics
 (#13548)

---
 doc/manual.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/doc/manual.rst b/doc/manual.rst
index ba13f2f02..71f6f73f9 100644
--- a/doc/manual.rst
+++ b/doc/manual.rst
@@ -5645,6 +5645,8 @@ 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
 does not export these identifiers.
 
+The ``import`` statement is only allowed at the top level.
+
 
 Include statement
 ~~~~~~~~~~~~~~~~~
@@ -5655,6 +5657,18 @@ statement is useful to split up a large module into several files:
 .. code-block:: nim
   include fileA, fileB, fileC
 
+The ``include`` statement can be used outside of the top level, as such:
+
+.. code-block:: nim
+  # Module A
+  echo "Hello World!"
+
+.. code-block:: nim
+  # Module B
+  proc main() =
+    include A
+  
+  main() # => Hello World!
 
 
 Module names in imports