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 C7C9D138350 for ; Sat, 28 Mar 2020 14:47:21 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id C52F9E0DF8; Sat, 28 Mar 2020 14:47:20 +0000 (UTC) Received: from smtp.gentoo.org (dev.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 8ECA2E0DF8 for ; Sat, 28 Mar 2020 14:47:20 +0000 (UTC) Received: from oystercatcher.gentoo.org (unknown [IPv6:2a01:4f8:202:4333:225:90ff:fed9:fc84]) (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 2034E34F733 for ; Sat, 28 Mar 2020 14:47:19 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id B9DEF18B for ; Sat, 28 Mar 2020 14:47:16 +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: <1585051805.87ea31e871d19af32750bdd187a84589cffd329b.ulm@gentoo> Subject: [gentoo-commits] proj/devmanual:master commit in: ebuild-writing/file-format/ X-VCS-Repository: proj/devmanual X-VCS-Files: ebuild-writing/file-format/text.xml X-VCS-Directories: ebuild-writing/file-format/ X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: 87ea31e871d19af32750bdd187a84589cffd329b X-VCS-Branch: master Date: Sat, 28 Mar 2020 14:47:16 +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: 36a4b200-31ad-417c-ad27-71fe34aeef48 X-Archives-Hash: 27dfef56df52f5672b8de28214fc0dad commit: 87ea31e871d19af32750bdd187a84589cffd329b Author: Ulrich Müller gentoo org> AuthorDate: Tue Mar 24 12:10:05 2020 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Tue Mar 24 12:10:05 2020 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=87ea31e8 ebuild-writing/file-format: New subsection for binary packages. Discussion reference: https://archives.gentoo.org/gentoo-dev/message/8dadfbd3c15b6580abb84882e9115a47 and replies. Signed-off-by: Ulrich Müller gentoo.org> ebuild-writing/file-format/text.xml | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/ebuild-writing/file-format/text.xml b/ebuild-writing/file-format/text.xml index 16d857e..5eb0cf8 100644 --- a/ebuild-writing/file-format/text.xml +++ b/ebuild-writing/file-format/text.xml @@ -140,6 +140,27 @@ The policy for so-called live ebuilds is to use 9999 as the version (or as the last version component).

+ + + + +Binary packages + + +

+Gentoo usually builds its packages from source. Exceptionally, a binary package +can be provided instead (e.g., if upstream does not provide a source). +Such packages should still follow normal naming conventions and do not need any +special suffix. +

+ +

+If a binary package is provided in addition to its open-source based +equivalent, the name of the former should be suffixed with -bin +if necessary for distinction. Examples are packages that are heavy on resources +like CPU time or memory when being built from source. +

+