Description:
------------
I had some difficulties with preg_match() trying to match a backslash.
It took me some time to find out it is '\\\\' in php code.
I'm missing a note or example about double escaping in the documentation.

Something like [see test script] would have made it clear for me in the first place and probably will help others.


Odd issue:
http://www.php.net/manual/en/function.preg-match.php#101575

//Here the ']' is escaped, but it doesn't return the error: "missing terminating ]", and accepts without complaining about the syntax error:
preg_match('/^[a-z0-9_.\/\\\]*$/i', $file_string);
//while here we get an error report:
preg_match('/^[a-z0-9_.\/\]*$/i', $file_string);



Test script:
---------------
//match newline control character:
preg_match('/\n/','\n');   //pattern matches and is stored as control character 0x0A in the pattern string
preg_match('/\\\n/','\n'); //same match, but is stored escaped as 0x5C,0x6E in the pattern string
//people mostly use the upper variant

//trying to match "\'" (2 characters) in a text file, '\\\'' as php string:
$subject = file_get_contents('myfile.txt');
preg_match('/\\\'/',$subject);   //DOESN'T MATCH! stored as 0x5C,0x27 (escaped apostrophe) this only matches apostrophe
preg_match('/\\\\\'/',$subject); //matches, stored as 0x5C,0x5C,0x27 (escaped backslash and unescaped apostrophe)
preg_match('/\\\\\\\/',$subject); //also matches, stored as 0x5C,0x5C,0x5C,0x27 (escaped backslash and escaped apostrophe)

//matching "\n" (2 characters):
preg_match('/\\\\n'/','\\n');  //match

Expected result:
----------------
Example or note in the documentation

Actual result:
--------------
A confused user, not realizing how to escape correctly for preg_match()