Add comment about what other letters are used.

[chaz/tar] / src / tar.h

diff --git a/src/tar.h b/src/tar.h
index 25132ffdaa6b7bc50f9cef06db50cd26ebe14c77..e51436380d2fb2b51b7cc6a012a13dfdc94918dc 100644 (file)
--- a/src/tar.h
+++ b/src/tar.h
@@ -1,5 +1,7 @@
-/* Format of tar archives.
-   Copyright (C) 1988, 92, 93, 94, 96, 97 Free Software Foundation, Inc.
+/* GNU tar Archive Format description.
+
+   Copyright (C) 1988, 1989, 1991, 1992, 1993, 1994, 1995, 1996, 1997,
+   2000, 2001, 2003 Free Software Foundation, Inc.
 
    This program is free software; you can redistribute it and/or modify it
    under the terms of the GNU General Public License as published by the
@@ -15,8 +17,6 @@
    with this program; if not, write to the Free Software Foundation, Inc.,
    59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
 
-/* GNU tar Archive Format description.  */
-
 /* If OLDGNU_COMPATIBILITY is not zero, tar produces archives which, by
    default, are readable by older versions of GNU tar.  This can be
    overriden by using --posix; in this case, POSIXLY_CORRECT in environment
@@ -28,9 +28,7 @@
    This #define will disappear in a few years.  FP, June 1995.  */
 #define OLDGNU_COMPATIBILITY 1
 
-/*---------------------------------------------.
-| `tar' Header Block, from POSIX 1003.1-1990.  |
-`---------------------------------------------*/
+/* tar Header Block, from POSIX 1003.1-1990.  */
 
 /* POSIX header.  */
 
@@ -86,9 +84,7 @@ struct posix_header
 #define TOWRITE  00002         /* write by other */
 #define TOEXEC   00001         /* execute/search by other */
 
-/*-------------------------------------.
-| `tar' Header Block, GNU extensions.  |
-`-------------------------------------*/
+/* tar Header Block, GNU extensions.  */
 
 /* In GNU tar, SYMTYPE is for to symbolic links, and CONTTYPE is for
    contiguous files, so maybe disobeying the `reserved' comment in POSIX
@@ -189,7 +185,12 @@ struct oldgnu_header
 #define OLDGNU_MAGIC "ustar  " /* 7 chars and a null */
 
 /* The standards committee allows only capital A through capital Z for
-   user-defined expansion.  */
+   user-defined expansion.  Other letters in use include:
+
+   'A' Solaris Access Control List
+   'E' Solaris Extended Attribute File
+   'I' Inode only, as in 'star'
+   'X' POSIX 1003.1-2001 eXtended (VU version)  */
 
 /* This is a dir entry that contains the names of files that were in the
    dir at the time the dump was made.  */
@@ -213,9 +214,7 @@ struct oldgnu_header
 /* This file is a tape/volume header.  Ignore it on extraction.  */
 #define GNUTYPE_VOLHDR 'V'
 
-/*--------------------------------------.
-| tar Header Block, overall structure.  |
-`--------------------------------------*/
+/* tar Header Block, overall structure.  */
 
 /* tar files are made in basic blocks of this size.  */
 #define BLOCKSIZE 512