update docs to clarify handling of paths in syntax object srclocs

This commit is contained in:
Matthew Flatt 2017-01-08 07:10:23 -06:00
parent 8ff011fc51
commit 6bb4f2ecad

View File

@ -598,3 +598,11 @@ the path to a relative path as is it written, and then
@racket[current-load-relative-directory] parameter is used to convert
any relative path back as it is read. The relative-path conversion
applies on reading whether the path was originally relative or not.
For a path in a syntax object's source, if the
@racket[current-load-relative-directory] parameter is not set of the
path is not relative to the value of the
@racket[current-load-relative-directory] parameter, then the path is
coerced to a string that preserves only part of the path (an in effort
to make it less tied to the build-time filesystem, which can be
different than the run-time filesystem).