You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by bo...@apache.org on 2017/07/23 15:16:05 UTC

commons-compress git commit: COMPRESS-398 say "we create old ustar" more clearly

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 <bo...@apache.org>
Authored: Sun Jul 23 17:15:34 2017 +0200
Committer: Stefan Bodewig <bo...@apache.org>
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.</p>
 
-      <p>There are several different tar formats and the TAR package
-      of Compress 1.4 mostly only provides the common functionality
-      of the existing variants.</p>
-
-      <p>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.</p>
+      <p>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.</p>
 
       <p>The tar package does not support the full POSIX tar standard
       nor more modern GNU extension of said standard.</p>