When testing, check if '/proc/mounts' exists.
[perl-fuse.git] / README
diff --git a/README b/README
index 625d2c2..0987f39 100644 (file)
--- a/README
+++ b/README
@@ -1,5 +1,5 @@
-Fuse version 0.06
-=================
+Fuse perl bindings
+==================
 
 Fuse is combination of Linux kernel module and user space library which
 enables you to write user-space filesystems. This module enables you to
@@ -12,6 +12,7 @@ database as file system, but there will be more.
 This is a pre-production release.  It seems to work quite well.  In fact, I
 can't find any problems with it whatsoever.  If you do, I want to know.
 
+Support for FreeBSD is experimental, so expect tests to fail.
 
 INSTALLATION
 
@@ -29,7 +30,8 @@ This module requires the FUSE C library and the FUSE kernel module.
 See http://fuse.sourceforge.net/
 
 If you intend to use FUSE in threaded mode, you need a version of Perl which
-has been compiled with USE_ITHREADS.
+has been compiled with USE_ITHREADS.  Then, you need to use threads and
+threads::shared.
 
 
 COPYRIGHT AND LICENCE
@@ -66,14 +68,15 @@ subdirectory.  These are:
 
 BUGS
 
-Perl 5.8.7 does not support shared subroutine references.  Until this is
-fixed, if you use threaded mode, you need to use symbolic references (i.e.
-passing "main::cb" instead of \&cb).  This rules out closures, lexical
-subs and that sort of thing, but it does seem to work.
+At time of writing, Perl (5.8.7) did not support shared subroutine references.
+Symptoms include a cryptic error message like "Invalid value for shared scalar"
+from Fuse.pm.  Until this is fixed, if you use threaded mode, you need to use
+symbolic references (i.e. passing "main::cb" instead of \&cb).  This doesn't
+allow things like closures, lexical subs and that sort of thing, but it does
+work for me.
 
 The current test framework seems to work well, but the underlying mount/
-unmount infrastructure is a crock.  I am not pleased with that code.  I
-also wish there was a way to test without root permissions.
+unmount infrastructure is a crock.  I am not pleased with that code.
 
 While most things work, I do still have a TODO list:
 * "du -sb" reports a couple orders of magnitude too large a size.