aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorTheodore Ts'o <tytso@mit.edu>2005-12-31 01:04:40 -0500
committerTheodore Ts'o <tytso@mit.edu>2005-12-31 01:04:40 -0500
commit1aa3d56ae719425b04e4b1275f73367fb84983b1 (patch)
tree7a1118e1961f1bdde6d3bdc3e5645a29e7fd8daa
parenteb065ccf181d49cd1a3709bf607c25d07a6322f1 (diff)
downloade2fsprogs-1aa3d56ae719425b04e4b1275f73367fb84983b1.tar.gz
e2fsprogs-1aa3d56ae719425b04e4b1275f73367fb84983b1.tar.xz
e2fsprogs-1aa3d56ae719425b04e4b1275f73367fb84983b1.zip
Clarify chattr man page to make sure people realize limitations in the kernel
Add notes in chattr's man page to make sure the reader refers to the BUGS AND LIMITATIONS section so that even an idiot will be able to see that some of these attributes are not yet implemented. (Addresses Debian Bug: #312515) Signed-off-by: "Theodore Ts'o" <tytso@mit.edu>
-rw-r--r--misc/ChangeLog7
-rw-r--r--misc/chattr.1.in17
2 files changed, 18 insertions, 6 deletions
diff --git a/misc/ChangeLog b/misc/ChangeLog
index 773473fe..dd1c1daf 100644
--- a/misc/ChangeLog
+++ b/misc/ChangeLog
@@ -1,3 +1,10 @@
+2005-12-31 Theodore Ts'o <tytso@mit.edu>
+
+ * chattr.1.in: Add notes in the man page to make sure the reader
+ refers to the BUGS AND LIMITATIONS section so that even an
+ idiot will be able to see that some of these attributes
+ are not yet implemented. (Addresses Debian Bug: #312515)
+
2005-12-10 Theodore Ts'o <tytso@mit.edu>
* dumpe2fs.c, e2image.c, filefrag.c, mke2fs.c: Fix various gcc
diff --git a/misc/chattr.1.in b/misc/chattr.1.in
index e5ea58e0..a8179e9a 100644
--- a/misc/chattr.1.in
+++ b/misc/chattr.1.in
@@ -53,7 +53,9 @@ capability can set or clear this attribute.
.PP
A file with the `c' attribute set is automatically compressed on the disk
by the kernel. A read from this file returns uncompressed data. A write to
-this file compresses data before storing them on the disk.
+this file compresses data before storing them on the disk. Note: please
+make sure to read the bugs and limitations section at the end of this
+document.
.PP
When a directory with the `D' attribute set is modified,
the changes are written synchronously on the disk; this is equivalent to
@@ -89,8 +91,9 @@ is already journalled and this attribute has no effect.
Only the superuser or a process possessing the CAP_SYS_RESOURCE
capability can set or clear this attribute.
.PP
-When a file with the `s' attribute set is deleted, its blocks are zeroed and
-written back to the disk.
+When a file with the `s' attribute set is deleted, its blocks are zeroed
+and written back to the disk. Note: please make sure to read the bugs
+and limitations section at the end of this document.
.PP
When a file with the `S' attribute set is modified,
the changes are written synchronously on the disk; this is equivalent to
@@ -107,8 +110,10 @@ which read the filesystem directly, and which don't understand tail-merged
files. Note: As of this writing, the ext2 or ext3 filesystems do not
(yet, except in very experimental patches) support tail-merging.
.PP
-When a file with the `u' attribute set is deleted, its contents are saved.
-This allows the user to ask for its undeletion.
+When a file with the `u' attribute set is deleted, its contents are
+saved. This allows the user to ask for its undeletion. Note: please
+make sure to read the bugs and limitations section at the end of this
+document.
.PP
The 'X' attribute is used by the experimental compression patches to
indicate that a raw contents of a compressed file can be accessed
@@ -131,7 +136,7 @@ maintained by Theodore Ts'o <tytso@alum.mit.edu>.
The `c', 's', and `u' attributes are not honored
by the ext2 and ext3 filesystems as implemented in the current mainline
Linux kernels. These attributes may be implemented
-in future versions ext2 and ext3.
+in future versions of the ext2 and ext3 filesystems.
.PP
The `j' option is only useful if the filesystem is mounted as ext3.
.PP