Gentoo Archives: gentoo-dev

From: "Michał Górny" <mgorny@g.o>
To: gentoo-dev@l.g.o
Cc: "Michał Górny" <mgorny@g.o>
Subject: [gentoo-dev] [PATCH 2/6] glep-0078: Link tar format to the respective standards
Date: Wed, 21 Sep 2022 18:17:44
Message-Id: 20220921181651.39370-3-mgorny@gentoo.org
In Reply to: [gentoo-dev] [PATCH 0/6] glep-0078: Clarifications by "Michał Górny"
1 Signed-off-by: Michał Górny <mgorny@g.o>
2 ---
3 glep-0078.rst | 13 +++++++++++--
4 1 file changed, 11 insertions(+), 2 deletions(-)
5
6 diff --git a/glep-0078.rst b/glep-0078.rst
7 index 24c5c9d..4d27ac1 100644
8 --- a/glep-0078.rst
9 +++ b/glep-0078.rst
10 @@ -232,8 +232,10 @@ ignore unknown files but preserve them across package updates.
11 Permitted .tar format features
12 ------------------------------
13
14 -The tar archives should use either the POSIX ustar format or a subset
15 -of the GNU format with the following (optional) extensions:
16 +The tar archives should use either the POSIX ustar format as defined
17 +by POSIX.1-2017 [#POSIX-USTAR]_ or a subset of the ustar-compatible
18 +GNU tar format as described in the GNU tar manual [#GNU-TAR]_ with
19 +the following (optional) extensions:
20
21 - long pathnames and long linknames,
22
23 @@ -629,6 +631,13 @@ References
24 written in C
25 (https://packages.gentoo.org/packages/app-portage/portage-utils)
26
27 +.. [#POSIX-USTAR] The Open Group Base Specifications Issue 7, 2018
28 + edition, pax - portable archive interchange, ustar Interchange Format
29 + (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/pax.html#tag_20_92_13_06)
30 +
31 +.. [#GNU-TAR] GNU tar: an archiver tool, Appendix E Tar Internals
32 + (https://www.gnu.org/software/tar/manual/html_node/Tar-Internals.html)
33 +
34 .. [#DEB-FORMAT] deb(5) — Debian binary package format
35 (https://manpages.debian.org/unstable/dpkg-dev/deb.5.en.html)
36
37 --
38 2.37.3