Be more specific about corner cases in the description of the $ RE syntax,

and include an example where the MULTILINE flag makes a real difference.

This closes SF bug #441600.