2 files changed, 113 insertions, 0 deletions

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6b44dae..9ac9811 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,26 @@
 
 The implementation for the original Moonscript language 0.5.0 can be found in the `0.5.0` branch of Yuescript. The Moonscript with fixes and new features is in the main branch of Yuescript. Here are the changelogs for each Yuescript version.
 
+## v0.17.0
+
+### Added Features
+
+* Added In-expression syntax to do range checking. In-expression can be used in switch statement as a new clause.
+  ```moonscript
+  a = 5
+  if a in [1, 10] or a in (20, 30) or a in {77, 88} or a not in {100, 200}
+    print "(1 <= a <= 10) or (20 < a < 30) or (a == 77 or a == 88) or not (a == 100 or a == 200)"
+  
+  switch a when not in [1, 10]
+    print "not (1 <= a <= 10)"
+  ```
+* Added metamethod name checking for chain expression.
+
+### Fixed Issues
+
+* Fixed a LuaJIT module loading issue.
+* Fixed built-in $FILE macro does not escape backslash on Windows.
+
 ## v0.16.4
 
 ### Added Features
diff --git a/doc/docs/doc/README.md b/doc/docs/doc/README.md
index 3a7b1e7..2c21a37 100755
--- a/doc/docs/doc/README.md
+++ b/doc/docs/doc/README.md
@@ -2355,6 +2355,52 @@ print "You're lucky!" unless math.random! > 0.1
 </pre>
 </YueDisplay>
 
+### In Expression
+
+You can write range checking code with an `in-expression`.
+
+```moonscript
+a = 5
+
+if a in [1, 10]
+  print "a is in range from 1 to 10"
+
+if a not in [1, 10]
+  print "a is not in range from 1 to 10"
+
+if a in (0, 11)
+  print "a is between 0 and 11 with open intervals"
+
+if a in {1, 3, 5, 7}
+  print "checking equality with discrete values"
+```
+<YueDisplay>
+<pre>
+a = 5
+
+if a in [1, 10]
+  print "a is in range from 1 to 10"
+
+if a not in [1, 10]
+  print "a is not in range from 1 to 10"
+
+if a in (0, 11)
+  print "a is between 0 and 11 with open intervals"
+
+if a in {1, 3, 5, 7}
+  print "checking equality with discrete values"
+</pre>
+</YueDisplay>
+
+```moonscript
+print "You're lucky!" unless math.random! > 0.1
+```
+<YueDisplay>
+<pre>
+print "You're lucky!" unless math.random! > 0.1
+</pre>
+</YueDisplay>
+
 ## Line Decorators
 
 For convenience, the for loop and if statement can be applied to single statements at the end of the line:
@@ -2525,6 +2571,53 @@ switch item
 </pre>
 </YueDisplay>
 
+### Range Matching
+
+You can do range matching in a switch when clause using `In` expressions.
+
+```moonscript
+value = 5
+
+switch item
+  -- range checking with closed interval
+  when in [1, 3]
+    print "1 <= value <= 3"
+
+  -- range checking with open and closed interval
+  when in (6, 8]
+    print "6 < value <= 8"
+
+  -- not in range checking
+  when not in [1, 10)
+    print "not (1 < value <= 10)"
+
+  -- checking discrete values
+  when in {11, 21, 99}
+    print "value is 11, 21 or 99"
+```
+<YueDisplay>
+<pre>
+value = 5
+
+switch item
+  -- range checking with closed interval
+  when in [1, 3]
+    print "1 <= value <= 3"
+
+  -- range checking with open and closed interval
+  when in (6, 8]
+    print "6 < value <= 8"
+
+  -- not in range checking
+  when not in [1, 10)
+    print "not (1 < value <= 10)"
+
+  -- checking discrete values
+  when in {11, 21, 99}
+    print "value is 11, 21 or 99"
+</pre>
+</YueDisplay>
+
 ## Object Oriented Programming
 
 In these examples, the generated Lua code may appear overwhelming. It is best to focus on the meaning of the Yuescript code at first, then look into the Lua code if you wish to know the implementation details.