aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorUlrich Müller <ulm@gentoo.org>2023-10-21 09:54:31 +0200
committerUlrich Müller <ulm@gentoo.org>2023-10-21 21:05:40 +0200
commitc97926baf8da7cf327509a0cd8718ca2bb9db56e (patch)
treeb7b814add8cdc301f06396bba587789e88e0b469
parentebuild-maintenance/new-ebuild; Fix link to bugzilla advanced search (diff)
downloaddevmanual-c97926baf8da7cf327509a0cd8718ca2bb9db56e.tar.gz
devmanual-c97926baf8da7cf327509a0cd8718ca2bb9db56e.tar.bz2
devmanual-c97926baf8da7cf327509a0cd8718ca2bb9db56e.zip
function-reference/install-functions: Mention dosym -r option
Closes: https://bugs.gentoo.org/916017 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
-rw-r--r--function-reference/install-functions/text.xml15
1 files changed, 10 insertions, 5 deletions
diff --git a/function-reference/install-functions/text.xml b/function-reference/install-functions/text.xml
index 0602c80..0d37980 100644
--- a/function-reference/install-functions/text.xml
+++ b/function-reference/install-functions/text.xml
@@ -278,11 +278,16 @@ The <c>*into</c> functions create the directory if it does not already exist.
<c>dosym</c>
</ti>
<ti>
- Create a symlink to the target specified as the first parameter,
- at the path specified by the second parameter. Note that
- the target is interpreted <e>verbatim</e>; it needs to either
- specify a relative path or an absolute path including
- <c>${EPREFIX}</c>.
+ <p>
+ Create a symlink to the target specified as the first parameter, at the
+ path specified by the second parameter. With option <c>-r</c> (EAPI 8),
+ an absolute path specified for the target will be converted to a path
+ relative to the link location.
+ </p>
+ <p>
+ Note: Without option <c>-r</c>, an absolute link target is interpreted
+ <e>verbatim</e>, i.e. it must include <c>${EPREFIX}</c> when applicable.
+ </p>
</ti>
</tr>
<tr>