Repository: commons-compress Updated Branches: refs/heads/master 445f1951e -> 317ea114c COMPRESS-398 say "we create old ustar" more clearly Project: http://git-wip-us.apache.org/repos/asf/commons-compress/repo Commit: http://git-wip-us.apache.org/repos/asf/commons-compress/commit/317ea114 Tree: http://git-wip-us.apache.org/repos/asf/commons-compress/tree/317ea114 Diff: http://git-wip-us.apache.org/repos/asf/commons-compress/diff/317ea114 Branch: refs/heads/master Commit: 317ea114c1360c4602f14970b9a3c19dcfee2997 Parents: 445f195 Author: Stefan Bodewig Authored: Sun Jul 23 17:15:34 2017 +0200 Committer: Stefan Bodewig Committed: Sun Jul 23 17:15:34 2017 +0200 ---------------------------------------------------------------------- src/site/xdoc/tar.xml | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/commons-compress/blob/317ea114/src/site/xdoc/tar.xml ---------------------------------------------------------------------- diff --git a/src/site/xdoc/tar.xml b/src/site/xdoc/tar.xml index 9f35da3..c17ea8c 100644 --- a/src/site/xdoc/tar.xml +++ b/src/site/xdoc/tar.xml @@ -30,14 +30,16 @@ stores various attributes including information about the original owner and permissions.

-

There are several different tar formats and the TAR package - of Compress 1.4 mostly only provides the common functionality - of the existing variants.

- -

The original format (often called "ustar") didn't support - file names longer than 100 characters or bigger than 8 GiB and - the tar package will by default fail if you try to write an - entry that goes beyond those limits.

+

There are several different dialects of the TAR format, maybe + even different TAR formats. The tar package contains special + cases in order to read many of the existing dialects and will by + default try to create archives in the original format (often + called "ustar"). This original format didn't support file names + longer than 100 characters or bigger than 8 GiB and the tar + package will by default fail if you try to write an entry that + goes beyond those limits. "ustar" is the common denominator of + all the existing tar dialects and is understood by most of the + existing tools.

The tar package does not support the full POSIX tar standard nor more modern GNU extension of said standard.