From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id D4FB71396D0 for ; Mon, 28 Aug 2017 20:02:01 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 24101E0EB8; Mon, 28 Aug 2017 20:02:01 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id F098AE0EB8 for ; Mon, 28 Aug 2017 20:02:00 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id B163D33BEC7 for ; Mon, 28 Aug 2017 20:01:59 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id B4F7385EC for ; Mon, 28 Aug 2017 20:01:55 +0000 (UTC) From: "Göktürk Yüksek" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Göktürk Yüksek" Message-ID: <1503950420.dd8078107236415fd8c5ea461f0119dd1e285a4c.gokturk@gentoo> Subject: [gentoo-commits] proj/devmanual:master commit in: function-reference/install-functions/ X-VCS-Repository: proj/devmanual X-VCS-Files: function-reference/install-functions/text.xml X-VCS-Directories: function-reference/install-functions/ X-VCS-Committer: gokturk X-VCS-Committer-Name: Göktürk Yüksek X-VCS-Revision: dd8078107236415fd8c5ea461f0119dd1e285a4c X-VCS-Branch: master Date: Mon, 28 Aug 2017 20:01:55 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Archives-Salt: 2d7504eb-a204-47f0-8940-6df3c37d2510 X-Archives-Hash: 268edd3d0452b031e1c8523cafe17af0 commit: dd8078107236415fd8c5ea461f0119dd1e285a4c Author: Michał Górny gentoo org> AuthorDate: Sat Aug 26 17:08:23 2017 +0000 Commit: Göktürk Yüksek gentoo 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. dosym - 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 verbatim; it needs to either + specify a relative path or an absolute path including + ${EPREFIX}.