Allow module on lower levels

1 files changed, 16 insertions, 1 deletions

diff --git a/README.md b/README.md
index e95ea5e..a0e90e9 100644
--- a/README.md
+++ b/README.md
@@ -11,7 +11,9 @@ This is a fork to implement experimental new features.
 ## Contents
 
 1\. [Syntactic sugar](#1-syntactic-sugar)  
-1.1. [Lambda-case](#11-lambda-case)
+1.1. [Lambda-case](#11-lambda-case)  
+2\. [Syntax changes](#2-syntax-changes)  
+2.1. [Use of the `module` keyword](#21-use-of-the-module-keyword)  
 
 ---
 
@@ -48,6 +50,19 @@ LambdaAbstr = ...
             | \case of {CaseAltDef}+
 ```
 
+## 2. Syntax changes
+
+### 2.1. Use of the `module` keyword
+
+The `module` keyword is only a keyword on the topmost level. This allows for
+using it as a record field, for example:
+
+```clean
+:: MyType = { module :: Int }
+```
+
+However, it is not allowed to define a function named `module`.
+
 [clean]: http://clean.cs.ru.nl
 [cocl]: https://svn.cs.ru.nl/repos/clean-compiler/
 [ghclambdacase]: https://downloads.haskell.org/~ghc/latest/docs/html/users_guide/glasgow_exts.html#lambda-case