diff --git a/docs/reference/metadata.md b/docs/reference/metadata.md
index 172c6f1d..a4e16914 100644
--- a/docs/reference/metadata.md
+++ b/docs/reference/metadata.md
@@ -175,54 +175,173 @@ Indentation options control aspects of the auto-indentation mechanism.
`increaseIndentPattern`
: *Regex.*
If it matches on the current line,
- the next line will be indented one level further.
+ lines after current line will be indented one level further.
+
+ If in `.tmPreferences`:
```xml
increaseIndentPattern
- insert regex here
+
+ ```
+
+ Then, in the corresponding buffer view:
+
+ ```
+ line1
+ line2
+ increase
+ after increase1
+ after increase2
```
`decreaseIndentPattern`
: *Regex.*
If it matches on the current line,
- the next line will be unindented one level.
+ current line and lines after current line will be unindented one level.
+
+ If in `.tmPreferences`:
```xml
decreaseIndentPattern
- insert regex here
+
+ ```
+
+ Then, in the corresponding buffer view:
+
+ ```
+ line1
+ line2
+ decrease
+ after decrease1
+ after decrease2
```
`bracketIndentNextLinePattern`
: *Regex.*
If it matches on the current line,
- only the next line will be indented one level further.
+ only the next non-whitespace line will be indented one level further.
+
+ If in `.tmPreferences`:
```xml
bracketIndentNextLinePattern
- insert regex here
+
+ ```
+
+ Then, in the corresponding buffer view:
+
+ ```
+ line1
+ line2
+ line3
+ bracket
+
+ first non-whitespace line after bracket
+ after bracket2
+ after bracket3
```
`disableIndentNextLinePattern`
: *Regex.*
If it matches on the current line,
- the next line will not be indented further.
+ and `bracketIndentNextLinePattern`'s *Regex* also matches on the current line.
+ The auto-indenter will ignore the effects made by `bracketIndentNextLinePattern`
+ when computing the indentation level of lines after current line.
+
+ If in `.tmPreferences`:
```xml
+ bracketIndentNextLinePattern
+
disableIndentNextLinePattern
- insert regex here
+
+ ```
+
+ Then, in the corresponding buffer view:
+
+ ```xml
+ lineone only match bracketIndentNextLinePattern Regex effects made
+ after lineone1
+ after lineone2
+ disable both match bracketIndentNextLinePattern and disableIndentNextLinePattern Regex effects for lines below ignored
+ after disable1
+ after disable2
```
`unIndentedLinePattern`
: *Regex.*
+ If it matches on the current line,
+ and `increaseIndentPattern` and/or `decreaseIndentPattern` and/or `bracketIndentNextLinePattern` *Regex* also matches on the current line.
The auto-indenter will ignore
- lines matching this regex
- when computing the next line's indentation level.
+ the effects made by `increaseIndentPattern` and/or `decreaseIndentPattern` and/or `bracketIndentNextLinePattern`
+ when computing the indentation level of lines after current line.
+
+ If in `.tmPreferences`:
```xml
+ increaseIndentPattern
+
unIndentedLinePattern
- insert regex here
+
+ ```
+
+ Then, in the corresponding buffer view:
+
+ ```xml
+ lineone only match increaseIndentPattern Regex effects made
+ after lineone1
+ after lineone2
+ linetwo only match increaseIndentPattern Regex effects made
+ after linetwo1
+ after linetwo2
+ unindented both match increaseIndentPattern and unIndentedLinePattern Regex effects for lines below ignored
+ after unindented1
+ after unindented2
+ ```
+
+ If in `.tmPreferences`:
+
+ ```xml
+ decreaseIndentPattern
+
+ unIndentedLinePattern
+
```
+ Then, in the corresponding buffer view:
+
+ ```xml
+ 0START0
+ lineone only match decreaseIndentPattern Regex effects made
+ after lineone1
+ after lineone2
+ linetwo only match decreaseIndentPattern Regex effects made
+ after linetwo1
+ after linetwo2
+ unindented both match decreaseIndentPattern and unIndentedLinePattern Regex effects for lines below ignored
+ after unindented1
+ after unindented2
+ ```
+
+ If in `.tmPreferences`:
+
+ ```xml
+ bracketIndentNextLinePattern
+
+ unIndentedLinePattern
+
+ ```
+
+ Then, in the corresponding buffer view:
+
+ ```xml
+ lineone only match bracketIndentNextLinePattern Regex effects made
+ after lineone1
+ after lineone2
+ unindented both match bracketIndentNextLinePattern and unIndentedLinePattern Regex effects for lines below ignored
+ after unindented1
+ after unindented2
+ ```
### Completions Options