Update 777-string-disclose.markdown

Author: Joe7M

_build/reference/777-string-disclose.markdown

@@ -1,10 +1,10 @@
 # DISCLOSE
 
-> DISCLOSE (str[, pairs [, ignore-pairs]])
+> s = DISCLOSE (str [, pairs [, ignore-pairs]])
 
-Discloses a string.
+Discloses the string `str`. `pairs` is a string of 2n characters. Two consecutive characters form a pair. The characters of `str` which are positioned between the first matching pair of `pairs` will be returned. `ignore-pairs` is a string with 2n characters. Two consecutive characters form a ignore-pair. All characters of `str` between an ignore-pair will be ignored (not returned).
 
-Default pairs and ignore pairs
+if `pairs` and  `ingnore-pairs` are not given, the following default pairs and ignore pairs will be used:
 
 | First non white-space character | Check | Ignore  |
 |---------------------------------|-------|---------|
@@ -14,20 +14,39 @@ Default pairs and ignore pairs
 | [                               | []    | " " ' ' |
 | {                               | {}    | " " ' ' |
 | <                               | <>    | " " ' ' |
-| "                               | " "   | ' '     |
 
-## Example
+## Example 1: Disclose default pairs
+
+```
+s = "(abc)"
+print disclose(s)                        ' Output: abc
+```
+
+### Example 2: Disclose non-default pairs
+
+```
+s = "_abc_"
+print disclose(s, "__")                  ' Output: abc
+
+s = "([abc])"
+print disclose(s, "[]")                  ' Output: abc
+
+s = "([abc])"
+print disclose(s, "[)")                  ' Output: abc]
 
+s = "[(abc)]"
+print disclose(s, "()[]")                ' Output: (abc)
+
+s = "abc (def)"
+print disclose(s, "()")                  ' Output: def
+
+s = "abc (d(ef))"
+print disclose(s, "()")                  ' Output: d(ef)
 ```
-s = "abc (abc)"
-? "1. "; s; tab(20); " -> "; disclose(s, "()")                  ' prints abc
 
-s = "abc (a(bc))"
-? "2. "; s; tab(20); " -> "; disclose(s, "()")                  ' prints a(bc)
-? "3. "; s; tab(20); " -> "; disclose(disclose(s, "()"), "()")  ' prints bc
+### Example 3: Disclose with ignore-pairs
 
-s = "abc (a='(bc)')"
-? "4. "; s; tab(20); " -> "; disclose(s, "()", "''")             ' prints a='(bc)'
-? "5. "; s; tab(20); " -> "; disclose(disclose(s, "()", "''"), "()", "''")
-' prints nothing
+```
+s = "abc [d(ef)] (gh)"
+print disclose(s, "()", "[]")            ' Output: gh
 ```