Added part that handles Restricted character

- Accoridng to `http://www.w3.org/TR/xml11/#charsets` this will take care
  of restricted characters. All test methods pass.
Updated read() functions documents

- Documented how each part of read() function works (for double char newlines,
  for single char newlines and resticted chars).