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.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 5D1EC1581E7 for ; Mon, 29 Apr 2024 18:28:42 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 7660BE2A00; Mon, 29 Apr 2024 18:28:41 +0000 (UTC) Received: from smtp.gentoo.org (dev.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 53904E2A00 for ; Mon, 29 Apr 2024 18:28:41 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 87D0E343025 for ; Mon, 29 Apr 2024 18:28:40 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 231C716C0 for ; Mon, 29 Apr 2024 18:28:39 +0000 (UTC) From: "Ulrich Müller" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Müller" Message-ID: <1714373448.700187075bd0827c25eebf48c2460f3bf09ff758.ulm@gentoo> Subject: [gentoo-commits] proj/devmanual:master commit in: ebuild-writing/functions/src_install/, general-concepts/licenses/, ... X-VCS-Repository: proj/devmanual X-VCS-Files: ebuild-writing/functions/src_install/text.xml ebuild-writing/variables/text.xml general-concepts/licenses/text.xml general-concepts/overlay/text.xml X-VCS-Directories: ebuild-writing/functions/src_install/ general-concepts/licenses/ general-concepts/overlay/ ebuild-writing/variables/ X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: 700187075bd0827c25eebf48c2460f3bf09ff758 X-VCS-Branch: master Date: Mon, 29 Apr 2024 18:28:39 +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-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: ed187b9c-38a9-4c32-b7f6-690f0bbefe31 X-Archives-Hash: fb49f4d81f5e7b587de9f63a26239549 commit: 700187075bd0827c25eebf48c2460f3bf09ff758 Author: Ulrich Müller gentoo org> AuthorDate: Mon Apr 29 06:48:37 2024 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Mon Apr 29 06:50:48 2024 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=70018707 No longer mention PORTDIR Closes: https://bugs.gentoo.org/865455 Signed-off-by: Ulrich Müller gentoo.org> ebuild-writing/functions/src_install/text.xml | 9 ++++----- ebuild-writing/variables/text.xml | 5 ++--- general-concepts/licenses/text.xml | 3 ++- general-concepts/overlay/text.xml | 6 +++--- 4 files changed, 11 insertions(+), 12 deletions(-) diff --git a/ebuild-writing/functions/src_install/text.xml b/ebuild-writing/functions/src_install/text.xml index 66a8e3d..d6589e9 100644 --- a/ebuild-writing/functions/src_install/text.xml +++ b/ebuild-writing/functions/src_install/text.xml @@ -120,11 +120,10 @@ to be installed recursively.

-There is no need to dodoc COPYING! The license belongs -to ${PORTDIR}/licenses. Sometimes though, you might want to -install COPYING regardless, if it explains how different -licenses are applied to different parts of the application, for -example. +There is no need for dodoc COPYING! The license belongs in the +repository's licenses/ directory. Sometimes though, you might want to +install COPYING regardless, if it explains how different licenses are +applied to different parts of the application, for example. diff --git a/ebuild-writing/variables/text.xml b/ebuild-writing/variables/text.xml index af03749..67c9887 100644 --- a/ebuild-writing/variables/text.xml +++ b/ebuild-writing/variables/text.xml @@ -64,9 +64,8 @@ for these variables when writing ebuilds. FILESDIR - Path to the ebuild's files/ directory, commonly used - for small patches and files. For example: - "${PORTDIR}/${CATEGORY}/${PN}/files". + Path to the package's files/ directory, commonly used for small + patches and other files. diff --git a/general-concepts/licenses/text.xml b/general-concepts/licenses/text.xml index a9fb702..182cfb6 100644 --- a/general-concepts/licenses/text.xml +++ b/general-concepts/licenses/text.xml @@ -236,7 +236,8 @@ plain text file (UTF-8 encoded) if at all possible. Some licenses are PDF files rather than plain text this should only be done if we are legally required to do so. Finally you need to check if your license should be added to a license group -as listed in $PORTDIR/profiles/license_groups. For more information see the +as listed in the repository's profiles/license_groups file. For more +information see GLEP 23.

diff --git a/general-concepts/overlay/text.xml b/general-concepts/overlay/text.xml index 72463e9..43d1607 100644 --- a/general-concepts/overlay/text.xml +++ b/general-concepts/overlay/text.xml @@ -11,9 +11,9 @@ in one or more repos.conf files.

-The overlay should contain the same directory structure as PORTDIR (although -only the necessary directories need be included). For example, a simple overlay -might have a directory structure like: +The overlay should contain the same directory structure as the Gentoo +repository (although only the necessary directories need be included). +For example, a simple overlay might have a directory structure like: