* doc/automake.texi (Options): Improve ustar file name length

discussion.  Reference tar manual.

diff --git a/ChangeLog b/ChangeLog
index b9fae545e68bdeaebaf002f79e9a9a68c1c765cd..45a415728d45dcc3a3ef2b6f906ed9e404babdad 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2004-07-12  Simon Josefsson  <jas@extundo.com>  (tiny change)
+
+       * doc/automake.texi (Options): Improve ustar file name length
+       discussion.  Reference tar manual.
+
 2004-07-12  Ray Simard  <rhs.techlists@sylvan-glade.com>  (tiny change)
 
        * lib/Automake/Variable.pm (define): Fix precondition check.

diff --git a/doc/automake.texi b/doc/automake.texi
index 0245b13b21e944ea29095567511828cd035e9a8f..e183b542dd36cba379be5a04172ebf64877c5c67 100644 (file)
--- a/doc/automake.texi
+++ b/doc/automake.texi
@@ -6006,11 +6006,14 @@ directories.  When using this format, consider using the
 
 @code{tar-ustar} selects the ustar format defined by POSIX
 1003.1-1988.  This format is believed to be old enough to be portable.
-It fully supports directories, and stores filenames with up to 255
-characters.  However you may run against broken tar implementations
-that incorrectly handle filenames longer than 99 characters (please
-report them to @email{bug-automake@@gnu.org} so we can document this
-accurately).
+It fully supports empty directories.  It can stores filenames with up
+to 256 characters, provided that the filename can be split at
+directory separator in two parts, first of them being at most 155
+bytes long. So, in most cases the maximum file name length will be
+shorter than 256 characters.  However you may run against broken tar
+implementations that incorrectly handle filenames longer than 99
+characters (please report them to @email{bug-automake@@gnu.org} so we
+can document this accurately).
 
 @code{tar-pax} selects the new pax interchange format defined by POSIX
 1003.1-2001.  It does not limit the length of filenames.  However,
@@ -6019,6 +6022,9 @@ packages which target only very modern platforms.  There are moves to
 change the pax format in an upward-compatible way, so this option may
 refer to a more recent version in the future.
 
+@xref{Formats, , Controlling the Archive Format, tar, GNU Tar}, for
+further discussion about tar formats.
+
 @code{configure} knows several ways to construct these formats.  It
 will not abort if it cannot find a tool up to the task (so that the
 package can still be built), but @code{make dist} will fail.

diff --git a/doc/stamp-vti b/doc/stamp-vti
index 58f3d2872ffc08d83d6fff6d75047f7ad480473d..53a9f7b04aeb478255fa29299cf2900de75c844b 100644 (file)
--- a/doc/stamp-vti
+++ b/doc/stamp-vti
@@ -1,4 +1,4 @@
-@set UPDATED 11 July 2004
+@set UPDATED 12 July 2004
 @set UPDATED-MONTH July 2004
 @set EDITION 1.8c
 @set VERSION 1.8c

diff --git a/doc/version.texi b/doc/version.texi
index 58f3d2872ffc08d83d6fff6d75047f7ad480473d..53a9f7b04aeb478255fa29299cf2900de75c844b 100644 (file)
--- a/doc/version.texi
+++ b/doc/version.texi
@@ -1,4 +1,4 @@
-@set UPDATED 11 July 2004
+@set UPDATED 12 July 2004
 @set UPDATED-MONTH July 2004
 @set EDITION 1.8c
 @set VERSION 1.8c