From: Alexandre Duret-Lutz Date: Sun, 11 Jul 2004 22:19:27 +0000 (+0000) Subject: * doc/automake.texi (Options): Improve ustar file name length X-Git-Tag: Release-1-8d~9 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=b23ddf1b7c5f0e305558668b5c77757a1a7ef420;p=thirdparty%2Fautomake.git * doc/automake.texi (Options): Improve ustar file name length discussion. Reference tar manual. --- diff --git a/ChangeLog b/ChangeLog index b9fae545e..45a415728 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2004-07-12 Simon Josefsson (tiny change) + + * doc/automake.texi (Options): Improve ustar file name length + discussion. Reference tar manual. + 2004-07-12 Ray Simard (tiny change) * lib/Automake/Variable.pm (define): Fix precondition check. diff --git a/doc/automake.texi b/doc/automake.texi index 0245b13b2..e183b542d 100644 --- 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 58f3d2872..53a9f7b04 100644 --- 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 58f3d2872..53a9f7b04 100644 --- 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