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

["Göktürk Yüksek" <gokturk@gentoo.org>]

commit:     dd8078107236415fd8c5ea461f0119dd1e285a4c
Author:     Michał Górny <mgorny <AT> gentoo <DOT> org>
AuthorDate: Sat Aug 26 17:08:23 2017 +0000
Commit:     Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
CommitDate: Mon Aug 28 20:00:20 2017 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=dd807810

install-functions: Verbosely explain dosym target parameter

It is a common misconception that dosym takes two paths, both of them
interpreted relatively to ${ED}. To avoid that, explicitly explain
that the first parameter is interpreted as a verbatim symlink target.

 function-reference/install-functions/text.xml | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/function-reference/install-functions/text.xml b/function-reference/install-functions/text.xml
index 6523521..c1392bf 100644
--- a/function-reference/install-functions/text.xml
+++ b/function-reference/install-functions/text.xml
@@ -257,7 +257,11 @@ the first is the source name, the second the name to use when installing.
       <c>dosym</c>
     </ti>
     <ti>
-      Create a symlink from the second parameter to the first parameter
+      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>.
     </ti>
   </tr>
   <tr>