X-Git-Url: https://perl5.git.perl.org/perl5.git/blobdiff_plain/d41150a633c012f8c6a2c9d01f78708b471bfe01..26d2adad67a3777a01cc6d9508fe6fa7b5713986:/README.freebsd

diff --git a/README.freebsd b/README.freebsd
index e147c66..4bfe974 100644
--- a/README.freebsd
+++ b/README.freebsd
@@ -4,28 +4,29 @@ specifically designed to be readable as is.
 
 =head1 NAME
 
-README.freebsd - Perl version 5 on FreeBSD systems
+perlfreebsd - Perl version 5 on FreeBSD systems
 
 =head1 DESCRIPTION
 
 This document describes various features of FreeBSD that will affect how Perl
 version 5 (hereafter just Perl) is compiled and/or runs.
 
-=head2 core dumps from readdir_r with ithreads
+=head2 FreeBSD core dumps from readdir_r with ithreads
 
 When perl is configured to use ithreads, it will use re-entrant library calls
 in preference to non-re-entrant versions.  There is a bug in FreeBSD's
-C<readdir_r> function that can cause a SEGV when reading large directories.
-A patch is available
+C<readdir_r> function in versions 4.5 and earlier that can cause a SEGV when
+reading large directories. A patch for FreeBSD libc is available
 (see http://www.freebsd.org/cgi/query-pr.cgi?pr=misc/30631 )
-and will hopefully be integrated into FreeBSD 4.6.
+which has been integrated into FreeBSD 4.6.
 
-=head2 $^X doesn't always contain a full path
+=head2 $^X doesn't always contain a full path in FreeBSD
 
-perl 5.8.0 sets C<$^X> where possible to a full path by asking the operating
-system. On FreeBSD the full path of the perl interpreter is found by reading
-the symlink F</proc/curproc/file>. There is a bug on FreeBSD, where the
-result of reading this symlink is can be wrong in certain circumstances
+perl sets C<$^X> where possible to a full path by asking the operating
+system. On FreeBSD the full path of the perl interpreter is found by using
+C<sysctl> with C<KERN_PROC_PATHNAME> if that is supported, else by reading
+the symlink F</proc/curproc/file>. FreeBSD 7 and earlier has a bug where
+either approach sometimes returns an incorrect value
 (see http://www.freebsd.org/cgi/query-pr.cgi?pr=35703 ).
 In these cases perl will fall back to the old behaviour of using C's
 argv[0] value for C<$^X>.