From 8b0b1287ab124a908bb5414a7578eabc66b149bf Mon Sep 17 00:00:00 2001 From: Sean Whitton Date: Sat, 6 Aug 2022 10:27:30 -0700 Subject: FILE:SYMLINKED: document that the link target is literal Reported-by: Andreas Reuleaux Signed-off-by: Sean Whitton --- src/property/file.lisp | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/src/property/file.lisp b/src/property/file.lisp index 5f0f480..9712571 100644 --- a/src/property/file.lisp +++ b/src/property/file.lisp @@ -224,7 +224,12 @@ Uses CL-PPCRE:REGEX-REPLACE, which see for the syntax of REPLACE." (defprop symlinked :posix (&key from to) "Ensure FROM is a symlink to TO. Symbolic links are overwritten; it is an -error if FROM is another kind of file, except when unapplying." +error if FROM is another kind of file, except when unapplying. + +The link target, TO, is literal: if it is a relative path, then it is not +relative to the remote home directory, but instead relative to the directory +that contains FROM. To create a link with a target under the remote home +directory, you can use one or more '../', or an absolute path." (:desc #?"Symlinked ${from} -> ${to}") (:apply (unless (and from to) -- cgit v1.2.3