This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
pod/perlfaq4.pod
[perl5.git] / README.cygwin
index 796197a..32c9a16 100644 (file)
@@ -31,7 +31,7 @@ about this project can be found at:
 
 A recent net or commercial release of Cygwin is required.
 
-At the time this document was last updated, Cygwin 1.3.9 was current.
+At the time this document was last updated, Cygwin 1.3.12 was current.
 
 
 =head2 Cygwin Configuration
@@ -153,7 +153,12 @@ C<d_semctl_semun> is undefined because it fails a Configure test
 and on Win9x the I<shm*()> functions seem to hang.  It also creates
 a compile time dependency because F<perl.h> includes F<<sys/ipc.h>>
 and F<<sys/sem.h>> (which will be required in the future when compiling
-CPAN modules).
+CPAN modules).  NO LONGER SUPPORTED!
+
+=item * C<-lutil>
+
+Included with the standard Cygwin netrelease is the inetutils package 
+which includes libutil.a.
 
 =back
 
@@ -317,7 +322,7 @@ always readable and executable).  On WinNT with the I<ntea> C<CYGWIN>
 setting, the additional mode bits are stored as extended file attributes.
 On WinNT with the I<ntsec> C<CYGWIN> setting, permissions use the standard
 WinNT security descriptors and access control lists.  Without one of
-these options, these tests will fail:
+these options, these tests will fail (listing not updated yet):
 
   Failed Test           List of failed
   ------------------------------------
@@ -332,6 +337,12 @@ these options, these tests will fail:
   lib/sdbm.t            2
   op/stat.t             9, 20 (.tmp not an executable extension)
 
+=head2 NDBM_File does not work on FAT filesystems
+
+Do not install NDBM_File on FAT filesystem.  It can be built on a FAT
+filesystem, but many ndbm tests will fail.  With NTFS, there should be
+no problems either way.
+
 =head2 Script Portability on Cygwin
 
 Cygwin does an outstanding job of providing UNIX-like semantics on top of
@@ -396,6 +407,10 @@ Win9x can not rename() an open file (although WinNT can).
 The Cygwin chroot() implementation has holes (it can not restrict file
 access by native Win32 programs).
 
+Inplace editing C<perl -i> of files doesn't work without doing a backup 
+of the file being edited C<perl -i.bak> because of windowish restrictions,
+so Perl adds the C<.bak> automatically if you just use C<perl -i>.
+
 =back
 
 =head1 INSTALL PERL ON CYGWIN
@@ -418,7 +433,7 @@ found in the F<INSTALL> document.
 These are the files in the Perl release that contain references to Cygwin.
 These very brief notes attempt to explain the reason for all conditional
 code.  Hopefully, keeping this up to date will allow the Cygwin port to
-be kept as clean as possible.
+be kept as clean as possible (listing not updated yet).
 
 =over 4
 
@@ -493,8 +508,6 @@ be kept as clean as possible.
 
 =head1 BUGS ON CYGWIN
 
-When I<make> starts, it warns about overriding commands for F<perlmain.o>.
-
 Support for swapping real and effective user and group IDs is incomplete.
 On WinNT Cygwin provides setuid(), seteuid(), setgid() and setegid().
 However, additional Cygwin calls for manipulating WinNT access tokens