syntax: fixed CodeMap.span_to_* to treat Spans as half-closed intervals.

Before this change span_to_* methods on CodeMap assumed that Span includes both of its endpoints (by trying to lookup span.hi in CodeMap), which doesn't seem correct judging by the way lexer and parser construct Spans (for instance, string_advance_token@lexer.rs:201).
This sometimes led to incorrect error reporting and ICEs, as byte position lookup would overflow into the next available FileMap.

    Example:
        ````

        pub fn main() {
            let mut num = 3;
            let refe = &mut num;
            *refe = 5;
            println!("{}", num);
        }````

(note the empty line in the beginning and the absence of newline at the end)

The above would have caused ICE when trying to report where "refe" borrow ends.
The above without an empty line in the beginning would have reported borrow end to be the first line.

Most probably, this is also responsible for (at least some occurrences of) issue #8256.