merge papd changes from HEAD

[netatalk.git] / doc / README.hidden-items

diff --git a/doc/README.hidden-items b/doc/README.hidden-items
index 9c49db611c2a8b3b3b79903c9f71f7a772f21dd6..5c47ca500205ab245305df1fc7a934a77d74971d 100644 (file)
--- a/doc/README.hidden-items
+++ b/doc/README.hidden-items
@@ -1,6 +1,7 @@
-Special folders created inside Netatalk shares
+              Special folders created inside Netatalk shares
 
-(ali@gwc.org.uk 20/10/01)
+(Originally by ali@gwc.org.uk 2001-10-20)
+(Amended by Sebastian Rittau 2001-11-03)
 
 Inside netatalk share points you will find several files and directories
 which are created automatically by the afpd process either for its own
@@ -21,16 +22,23 @@ should be set on them.
 
 Note that in general on Netatalk shares, all directories should have the
 setgid bit set. This forces any new files or folders created to have the
-same group as the folder they were created in.
+same group as the folder they were created in. On some operating systems,
+notably FreeBSD, the group owner is always inherited from the parent
+directory, so the setgid bit is not necessary.
 
 
 .AppleDouble/
 
 This directory exists inside each folder on a Netatalk share. It contains
-the resource fork of each file in that folder. Its permissions should
-match those of its parent directory, i.e. anyone who has write access to
-the parent directory must have write access to the corresponding
-.AppleDouble directory.
+meta information like the resource fork, or creator/type of each file in that
+folder. Its permissions should match those of its parent directory, i.e.
+anyone who has write access to the parent directory must have write access to
+the corresponding .AppleDouble directory.
+
+
+.AppleDouble/.Parent
+
+This file specifically contains meta information about the directory.
 
 
 .AppleDesktop/
@@ -76,6 +84,10 @@ make it writeable then users will get a message "That item cannot be put
 in the Trash. Do you want to delete it immediately?" if they try to put
 something in the Trash.
 
+Unfortunately networked trash handling is broken in current versions of Mac
+OS X even if this directory is writeable. Apple is aware of this problem
+and is working on a solution.
+
 
 Temporary\ Items/