Bug#318579: [PATCH] Document that FileCache uses symbolic references
Niko Tyni
ntyni at debian.org
Tue May 5 06:07:57 UTC 2009
As noted by Marc Haber in <http://bugs.debian.org/318579>,
using FileCache.pm as per the SYNOPSIS doesn't work under
'use strict'. This is a bit unexpected nowadays, so mention
it in the documentation.
---
lib/FileCache.pm | 5 +++++
1 files changed, 5 insertions(+), 0 deletions(-)
diff --git a/lib/FileCache.pm b/lib/FileCache.pm
index 285307f..5028291 100644
--- a/lib/FileCache.pm
+++ b/lib/FileCache.pm
@@ -8,6 +8,8 @@ FileCache - keep more files open than the system permits
=head1 SYNOPSIS
+ no strict 'refs';
+
use FileCache;
# or
use FileCache maxopen => 16;
@@ -71,6 +73,9 @@ FileCache does not store the current file offset if it finds it necessary to
close a file. When the file is reopened, the offset will be as specified by the
original C<open> file mode. This could be construed to be a bug.
+The module functionality relies on symbolic references, so things will break
+under 'use strict' unless 'no strict "refs"' is also specified.
+
=head1 BUGS
F<sys/param.h> lies with its C<NOFILE> define on some systems,
--
1.5.6.5
More information about the Perl-maintainers
mailing list