WIP

README.md

@@ -130,6 +130,7 @@ system.
    total ordering of characters, order of uncomparable results are
    unstable. This limitation is not strictly POSIX-compliant, but
    inevitable due to use of wide characters in the whole shell.
+ * 
 
 
 ## Known Issues

doc/syntax.txt

@@ -71,6 +71,37 @@ quotation marks:
   it is followed by +$+, +`+, +"+, +\+, or a newline; other backslashes are
   treated as normal characters.
 
+[[dollar-single]]
+=== Dollar-single-quotes
+
+Dollar-single-quotes are a special form of quotation introduced by +$'+ and
+terminated by +'+. This is similar to normal single-quotation marks, but the
+following backslash escapes are recognized in the quoted string:
+
++\"+, +\'+, +\\+::
+  Represents literal +"+, +'+, and +\+, respectively. Note that a
+  single-quotation mark escaped by a backslash does not terminate the
+  dollar-single-quoted string.
++\a+, +\b+, +\e+, +\f+, +\n+, +\r+, +\t+, +\v+::
+  Represents the alert (bell), backspace, escape, form feed, newline, carriage
+  return, horizontal tab, and vertical tab characters, respectively.
++\c+::
+  Represents the control character corresponding to a character that follows.
+  For example, +\cA+ represents the SOH character, which can be entered by
+  typing Ctrl-A. The null character (+\c@+) is not supported.
++\x+::
+  Represents the character whose value is specified by hexadecimal digits that
+  follow. For example, +\x20+ represents the character that has the value 20
+  in hexadecimal. There must be at least one digit that follows +\x+ and at
+  most two digits are recognized.
++\0+, +\1+, +\2+, ..., +\377+::
+  Represents the character whose value is specified by octal digits. There
+  must be at least one digit and at most three digits are recognized. The
+  value must fit in 8 bits.
+
+Any other use of backslashes is considered as an error and converted to the
++?+ character.
+
 [[aliases]]
 == Aliases