Document that lock() is a "weak keyword".

p4raw-id: //depot/perl@16981

diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index 3e5e48a..49fa800 100644 (file)
--- a/pod/perlfunc.pod
+++ b/pod/perlfunc.pod
@@ -2471,9 +2471,11 @@ and the month of the year, may not necessarily be three characters wide.
 
 This function places an advisory lock on a variable, subroutine,
 or referenced object contained in I<THING> until the lock goes out
-of scope.  This is a built-in function only if your version of Perl
-was built with threading enabled, and if you've said C<use Thread>.
-Otherwise a user-defined function by this name will be called.
+of scope.
+
+lock() is a "weak keyword" : that means that if you've defined a
+function by this name, this function will be called instead.
+(However, if you've said C<use Thread>, lock() is always a keyword.)
 See L<Thread>.
 
 =item log EXPR