[gentoo-commits] proj/devmanual:master commit in: function-reference/install-functions/

["Ulrich Müller" <ulm@gentoo.org>]

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>