commit: c97926baf8da7cf327509a0cd8718ca2bb9db56e Author: Ulrich Müller <ulm <AT> gentoo <DOT> org> AuthorDate: Sat Oct 21 07:54:31 2023 +0000 Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org> CommitDate: Sat Oct 21 19:05:40 2023 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=c97926ba
function-reference/install-functions: Mention dosym -r option Closes: https://bugs.gentoo.org/916017 Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org> function-reference/install-functions/text.xml | 15 ++++++++++----- 1 file 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>
