X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlclib.pod;h=e89a67a14092f4acc7f3ca36331884066c535ee2;hb=6d3b25aa06c9837fbb97c3791369b6d8990787c7;hp=7c527a9a7a207048be6bbb178e81aa996f8df4a4;hpb=702eb6d058ad90bee8332952b92588ced38f499f;p=p5sagit%2Fp5-mst-13.2.git

diff --git a/pod/perlclib.pod b/pod/perlclib.pod
index 7c527a9..e89a67a 100644
--- a/pod/perlclib.pod
+++ b/pod/perlclib.pod
@@ -132,6 +132,16 @@ instead of raw C<char *> strings:
 Note also the existence of C<sv_catpvf> and C<sv_vcatpvfn>, combining
 concatenation with formatting.
 
+Sometimes instead of zeroing the allocated heap by using Newz() you
+should consider "poisoning" the data.  This means writing a bit
+pattern into it that should be illegal as pointers (and floating point
+numbers), and also hopefully surprising enough as integers, so that
+any code attempting to use the data without forethought will break
+sooner rather than later.  Poisoning can be done using the Poison()
+macro, which has similar arguments as Zero():
+
+    Poison(dst, n, t)
+
 =head2 Character Class Tests
 
 There are two types of character class tests that Perl implements: one