Document handling of raw-unicode-escapes. Closes SF bug 587087.

diff --git a/Doc/ref/ref2.tex b/Doc/ref/ref2.tex
index 56d5bb71cbf6fb3c05fde2b5fcfc59fe2a4b65f6..e761c8d5ecc6865d634996d6a675e9c6ed074890 100644 (file)
--- a/Doc/ref/ref2.tex
+++ b/Doc/ref/ref2.tex
@@ -457,6 +457,14 @@ escape the following quote character).  Note also that a single
 backslash followed by a newline is interpreted as those two characters
 as part of the string, \emph{not} as a line continuation.
 
+When an `r' or `R' prefix is used in conjunction with a `u' or `U'
+prefix, then the \uXXXX escape sequence is processed while \emph{all other
+backslashes are left in the string}.  For example, the string literal
+\code{ur"\u0062\n"} consists of three Unicode characters:
+`LATIN SMALL LETTER B', `REVERSE SOLIDUS', and `LATIN SMALL LETTER N'.
+Backslashes can be escaped with a preceding backslash; however, both
+remain in the string.  As a result, \uXXXX escape sequences are
+only recognized when there are an odd number of backslashes.
 
 \subsection{String literal concatenation\label{string-catenation}}