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 CD868158094 for ; Wed, 21 Sep 2022 18:17:44 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 2816CE0AA7; Wed, 21 Sep 2022 18:16:59 +0000 (UTC) Received: from smtp.gentoo.org (woodpecker.gentoo.org [140.211.166.183]) (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 E71EEE0A9F for ; Wed, 21 Sep 2022 18:16:58 +0000 (UTC) From: =?UTF-8?q?Micha=C5=82=20G=C3=B3rny?= To: gentoo-dev@lists.gentoo.org Cc: =?UTF-8?q?Micha=C5=82=20G=C3=B3rny?= Subject: [gentoo-dev] [PATCH 2/6] glep-0078: Link tar format to the respective standards Date: Wed, 21 Sep 2022 20:16:47 +0200 Message-Id: <20220921181651.39370-3-mgorny@gentoo.org> X-Mailer: git-send-email 2.37.3 In-Reply-To: <20220921181651.39370-1-mgorny@gentoo.org> References: <20220921181651.39370-1-mgorny@gentoo.org> Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Archives-Salt: fd0ee28e-ca5a-4a53-92d1-91fdafa552fe X-Archives-Hash: f0f85ab72189b46bfa78200c00c3d7b2 Signed-off-by: Michał Górny --- glep-0078.rst | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/glep-0078.rst b/glep-0078.rst index 24c5c9d..4d27ac1 100644 --- a/glep-0078.rst +++ b/glep-0078.rst @@ -232,8 +232,10 @@ ignore unknown files but preserve them across package updates. Permitted .tar format features ------------------------------ -The tar archives should use either the POSIX ustar format or a subset -of the GNU format with the following (optional) extensions: +The tar archives should use either the POSIX ustar format as defined +by POSIX.1-2017 [#POSIX-USTAR]_ or a subset of the ustar-compatible +GNU tar format as described in the GNU tar manual [#GNU-TAR]_ with +the following (optional) extensions: - long pathnames and long linknames, @@ -629,6 +631,13 @@ References written in C (https://packages.gentoo.org/packages/app-portage/portage-utils) +.. [#POSIX-USTAR] The Open Group Base Specifications Issue 7, 2018 + edition, pax - portable archive interchange, ustar Interchange Format + (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/pax.html#tag_20_92_13_06) + +.. [#GNU-TAR] GNU tar: an archiver tool, Appendix E Tar Internals + (https://www.gnu.org/software/tar/manual/html_node/Tar-Internals.html) + .. [#DEB-FORMAT] deb(5) — Debian binary package format (https://manpages.debian.org/unstable/dpkg-dev/deb.5.en.html) -- 2.37.3