From 6bb4f2ecad9a0cd72c122526d0cb25f2fc545670 Mon Sep 17 00:00:00 2001 From: Matthew Flatt Date: Sun, 8 Jan 2017 07:10:23 -0600 Subject: [PATCH] update docs to clarify handling of paths in syntax object srclocs --- pkgs/racket-doc/scribblings/reference/printer.scrbl | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/pkgs/racket-doc/scribblings/reference/printer.scrbl b/pkgs/racket-doc/scribblings/reference/printer.scrbl index fb87c47966..c091e82219 100644 --- a/pkgs/racket-doc/scribblings/reference/printer.scrbl +++ b/pkgs/racket-doc/scribblings/reference/printer.scrbl @@ -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).