public inbox for gentoo-dev@lists.gentoo.org
 help / color / mirror / Atom feed
From: "Michał Górny" <mgorny@gentoo.org>
To: gentoo-dev@lists.gentoo.org
Cc: "Michał Górny" <mgorny@gentoo.org>
Subject: [gentoo-dev] [PATCH 2/6] glep-0078: Link tar format to the respective standards
Date: Wed, 21 Sep 2022 20:16:47 +0200	[thread overview]
Message-ID: <20220921181651.39370-3-mgorny@gentoo.org> (raw)
In-Reply-To: <20220921181651.39370-1-mgorny@gentoo.org>

Signed-off-by: Michał Górny <mgorny@gentoo.org>
---
 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



  parent reply	other threads:[~2022-09-21 18:17 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2022-09-21 18:16 [gentoo-dev] [PATCH 0/6] glep-0078: Clarifications Michał Górny
2022-09-21 18:16 ` [gentoo-dev] [PATCH 1/6] glep-0078: Replace "basename" with non-ambiguous explanation Michał Górny
2022-09-22  6:07   ` Ulrich Mueller
2022-09-21 18:16 ` Michał Górny [this message]
2022-09-21 18:16 ` [gentoo-dev] [PATCH 3/6] glep-0078: Link compressed file formats to GLEP 74 Michał Górny
2022-09-21 18:16 ` [gentoo-dev] [PATCH 4/6] glep-0078: Link OpenPGP to RFC 4880 Michał Górny
2022-09-21 18:16 ` [gentoo-dev] [PATCH 5/6] glep-0078: Clarify that Manifest is signed too Michał Górny
2022-09-21 18:16 ` [gentoo-dev] [PATCH 6/6] glep-0078: Clarify that Manifest must be present for signed binpkg Michał Górny

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20220921181651.39370-3-mgorny@gentoo.org \
    --to=mgorny@gentoo.org \
    --cc=gentoo-dev@lists.gentoo.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox