perlfunc: highlight -X behaviour on dangling symlinks
authorDavid Cantrell <david@cantrell.org.uk>
Thu, 1 Nov 2018 11:10:49 +0000 (11:10 +0000)
committerAaron Crane <arc@cpan.org>
Thu, 1 Nov 2018 11:15:24 +0000 (11:15 +0000)
pod/perlfunc.pod

index 9394e22..016b98f 100644 (file)
@@ -522,6 +522,10 @@ argument is omitted, tests L<C<$_>|perlvar/$_>, except for C<-t>, which
 tests STDIN.  Unless otherwise documented, it returns C<1> for true and
 C<''> for false.  If the file doesn't exist or can't be examined, it
 returns L<C<undef>|/undef EXPR> and sets L<C<$!>|perlvar/$!> (errno).
+With the exception of the C<-l> test they all follow symbolic links
+because they use C<stat()> and not C<lstat()> (so dangling symlinks can't
+be examined and will therefore report failure).
+
 Despite the funny names, precedence is the same as any other named unary
 operator.  The operator may be any of: