summaryrefslogtreecommitdiff
path: root/lib/Data/MultiValued/Tags.pm
diff options
context:
space:
mode:
Diffstat (limited to 'lib/Data/MultiValued/Tags.pm')
-rw-r--r--lib/Data/MultiValued/Tags.pm11
1 files changed, 10 insertions, 1 deletions
diff --git a/lib/Data/MultiValued/Tags.pm b/lib/Data/MultiValued/Tags.pm
index d0d7b36..a42caf4 100644
--- a/lib/Data/MultiValued/Tags.pm
+++ b/lib/Data/MultiValued/Tags.pm
@@ -107,6 +107,9 @@ version 0.0.1
Stores the given value for the given tag. Replaces existing
values. Does not throw exceptions.
+Not passing in a C<tag> is equivalent to passing in C<< tag => undef
+>>.
+
No cloning is done: if you pass in a reference, the reference is
just stored.
@@ -115,9 +118,12 @@ just stored.
my $value = $obj->get({ tag => $the_tag });
Retrieves the value for the given tag. Throws a
-L<Data::MultiValued::Exceptions::TagNotFound> exception it the tag
+L<Data::MultiValued::Exceptions::TagNotFound> exception if the tag
does not exists in this object.
+Not passing in a C<tag> is equivalent to passing in C<< tag => undef
+>>.
+
No cloning is done: if a reference was stored, you get it back
untouched.
@@ -128,6 +134,9 @@ untouched.
Deletes the given tag and all data associated with it. Does not throw
exceptions: if the tag does not exist, nothing happens.
+Not passing in a C<tag> clears everything. Yes, this means that there
+is no way to just clear the value for the C<undef> tag.
+
=head1 SEE ALSO
L<Data::MultiValued::TagContainer>, L<Data::MultiValued::Exceptions>