diff options
author | Sean Whitton <spwhitton@spwhitton.name> | 2022-07-21 16:52:49 -0700 |
---|---|---|
committer | Sean Whitton <spwhitton@spwhitton.name> | 2022-07-21 16:56:39 -0700 |
commit | 04386010f11cfb37eb64d785875051b3afd67036 (patch) | |
tree | cb968a29a6094f0427006c00b9bc6bc1f890871f | |
parent | f960080775cdd66fc1409124571903dc409c9709 (diff) | |
download | consfigurator-04386010f11cfb37eb64d785875051b3afd67036.tar.gz |
DATA.FILES-TREE: say that there is no encoding of special characters
Signed-off-by: Sean Whitton <spwhitton@spwhitton.name>
-rw-r--r-- | src/data/files-tree.lisp | 14 |
1 files changed, 10 insertions, 4 deletions
diff --git a/src/data/files-tree.lisp b/src/data/files-tree.lisp index b0f240c..e94cf48 100644 --- a/src/data/files-tree.lisp +++ b/src/data/files-tree.lisp @@ -28,10 +28,16 @@ contained in the subdirectory 'data/'. LOCATION, IDEN1 and IDEN2 are concatenated to locate files. Thus, IDEN1 specifies a (possibly nested) subdirectory under LOCATION and IDEN2 a relative -path within that subdirectory. For convenience IDEN1 and IDEN2 may be passed -as absolute and will be converted to relative paths. The usual cases of IDEN1 -as a hostname, IDEN1 as an underscore-prefixed identifier, and IDEN2 an an -absolute or relative path are all supported." +path within that subdirectory. + +Special characters in IDEN1 and IDEN2 are not encoded. This means that each +character in IDEN1 and IDEN2 must be permitted in filenames on this system, +and that any slashes in IDEN1 and IDEN2 will probably act as path separators. + +For convenience IDEN1 and IDEN2 may be passed as absolute and will be +converted to relative paths. The usual cases of IDEN1 as a hostname, IDEN1 as +an underscore-prefixed identifier, and IDEN2 an an absolute or relative path +are all supported." (let ((base-path (if (symbolp location) (asdf:system-relative-pathname location "data/") (ensure-directory-pathname location)))) |