README
1Tie::Util, version 0.04 (beta)
2
3This module provides a few subroutines for examining and modifying
4tied variables, including those that hold weak references to the
5objects to which they are tied, and variables tied to packages as
6opposed to objects.
7
8
9RECENT CHANGES
10
110.04
12----
13Bug fix: Fixed to work with perl 5.21.6.
14
150.03
16----
17Bug fix: Suppress ‘Ambiguous use’ warnings introduced in perl 5.13.3.
18
190.02
20----
21Incompatible change:
22• is_weak_tie now returns false for a variable tied to undef, because
23 the tie does not actually hold a weak reference; it holds no refe-
24 rence at all.
25New features:
26• Added support for tying to a package (or anything else)
27• Added a ‘tied’ function that returns the actual scalar the tie uses.
28Bug fixes:
29• Tying $@ no longer makes is_tied die.
30• weak_tie now returns the same scalar that holds the tie, the way
31 ‘tie’ does.
32
33
34INSTALLATION
35
36The easiest way to install this module is to use the CPAN module or
37the cpan script:
38
39 [sudo] perl -MCPAN -e "install Tie::Util"
40
41 [sudo] cpan Tie::Util
42
43Or you can use the following:
44
45 perl Makefile.PL
46 make
47 make test
48 [sudo] make install
49
50
51DEPENDENCIES
52
53This module requires perl 5.8.0 or later and the following
54Perl modules:
55
56• Exporter 5.57 or later
57• Scalar::Util 1.09 or later
58
59
60DOCUMENTATION
61
62After installing, you can find documentation for these modules with
63the perldoc command.
64
65 perldoc Tie::Util
66
67Or try using man (it's faster, in my experience):
68
69 man Tie::Util
70
71
72COPYRIGHT AND LICENCE
73
74Copyright (C) 2007-15 Father Chrysostomos
75
76This program is free software; you may redistribute it and/or modify
77it under the same terms as perl.
78