···1212// Parse parses a patch with changes to one or more files. Any content before
1313// the first file is returned as the second value. If an error occurs while
1414// parsing, it returns all files parsed before the error.
1515+//
1616+// Parse expects to receive a single patch. If the input may contain multiple
1717+// patches (for example, if it is an mbox file), callers should split it into
1818+// individual patches and call Parse on each one.
1519func Parse(r io.Reader) ([]*File, string, error) {
1620 p := newParser(r)
1721