This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Update Archive-Tar to CPAN version 1.82
[perl5.git] / README.cygwin
index c2d52c7..abfd996 100644 (file)
@@ -4,7 +4,7 @@ specially designed to be readable as is.
 
 =head1 NAME
 
-README.cygwin - Perl for Cygwin
+perlcygwin - Perl for Cygwin
 
 =head1 SYNOPSIS
 
@@ -27,7 +27,7 @@ platforms.  They run thanks to the Cygwin library which provides the UNIX
 system calls and environment these programs expect.  More information
 about this project can be found at:
 
-  F<http://www.cygwin.com/>
+L<http://www.cygwin.com/>
 
 A recent net or commercial release of Cygwin is required.
 
@@ -124,14 +124,14 @@ Alternatively, the crypt libraries in GNU libc have been ported to Cygwin.
 
 The DES based Ultra Fast Crypt port was done by Alexey Truhan:
 
-  ftp://ftp.uni-erlangen.de/pub/pc/gnuwin32/cygwin/porters/Okhapkin_Sergey/cw32crypt-dist-0.tgz
+  ftp://ftp.franken.de/pub/win32/develop/gnuwin32/cygwin/porters/Okhapkin_Sergey/cw32crypt-dist-0.tgz
 
 NOTE: There are various export restrictions on DES implementations,
 see the glibc README for more details.
 
 The MD5 port was done by Andy Piper:
 
-  ftp://ftp.uni-erlangen.de/pub/pc/gnuwin32/cygwin/porters/Okhapkin_Sergey/libcrypt.tgz
+  ftp://ftp.franken.de/pub/win32/develop/gnuwin32/cygwin/porters/Okhapkin_Sergey/libcrypt.tgz
 
 =item * C<-lgdbm_compat> (C<use GDBM_File>)
 
@@ -334,7 +334,7 @@ A C<fork()> failure may result in the following tests failing:
   ext/IO/lib/IO/t/io_sock.t
   ext/IO/lib/IO/t/io_unix.t
 
-See comment on fork in L<Miscellaneous> below.
+See comment on fork in L</Miscellaneous> below.
 
 =head1 Specific features of the Cygwin port
 
@@ -368,14 +368,14 @@ C<Cygwin::posix_to_win_path()>.
 Pathnames may not contain Unicode characters. C<Cygwin> still uses the
 ANSI API calls and no Unicode calls because of newlib deficiencies.
 There's an unofficial unicode patch for cygwin at
-F<http://www.okisoft.co.jp/esc/utf8-cygwin/>
+L<http://www.okisoft.co.jp/esc/utf8-cygwin/>
 
 =item * Text/Binary
 
 When a file is opened it is in either text or binary mode.  In text mode
 a file is subject to CR/LF/Ctrl-Z translations.  With Cygwin, the default
 mode for an C<open()> is determined by the mode of the mount that underlies
-the file. See C<Cygwin::is_binmount()>. Perl provides a C<binmode()> function
+the file. See L</Cygwin::is_binmount>(). Perl provides a C<binmode()> function
 to set binary mode on files that otherwise would be treated as text.
 C<sysopen()> with the C<O_TEXT> flag sets text mode on files that otherwise
 would be treated as binary:
@@ -458,7 +458,7 @@ error like the following:
 
 Use the rebase utility to resolve the conflicting dll addresses.  The
 rebase package is included in the Cygwin netrelease.  Use setup.exe from
-F<http://www.cygwin.com/setup.exe> to install it and run rebaseall.
+L<http://www.cygwin.com/setup.exe> to install it and run rebaseall.
 
 =back
 
@@ -558,23 +558,22 @@ be kept as clean as possible.
 =item Documentation
 
   INSTALL README.cygwin README.win32 MANIFEST
-  Changes Changes5.004 Changes5.005 Changes5.6 Changes5.8
   pod/perl.pod pod/perlport.pod pod/perlfaq3.pod
   pod/perldelta.pod pod/perl5004delta.pod pod/perl56delta.pod
   pod/perl561delta.pod pod/perl570delta.pod pod/perl572delta.pod
   pod/perl573delta.pod pod/perl58delta.pod pod/perl581delta.pod
   pod/perl590delta.pod pod/perlhist.pod pod/perlmodlib.pod
-  pod/perltoc.pod pod.lst Porting/Glossary Porting/repository.pod
+  pod/perltoc.pod pod.lst Porting/Glossary pod/perlgit.pod
   Porting/checkAUTHORS.pl
-  ext/Compress/Raw/Zlib/Changes ext/Compress/Raw/Zlib/README
-  ext/Compress/Zlib/Changes ext/Cwd/Changes ext/DB_File/Changes
-  ext/Encode/Changes ext/Sys/Syslog/Changes ext/Time/HiRes/Changes
-  ext/Win32API-File/Changes lib/CGI/Changes lib/ExtUtils/CBuilder/Changes
-  lib/ExtUtils/Changes lib/ExtUtils/NOTES lib/ExtUtils/PATCHING
-  lib/ExtUtils/README lib/Module/Build/Changes lib/Net/Ping/Changes
-  lib/Test/Harness/Changes
-  lib/Term/ANSIColor/ChangeLog lib/Term/ANSIColor/README
-  README.symbian symbian/TODO
+  dist/Cwd/Changes ext/Compress-Raw-Zlib/Changes
+  ext/Compress-Raw-Zlib/README ext/Compress-Zlib/Changes
+  ext/DB_File/Changes ext/Encode/Changes ext/Sys-Syslog/Changes
+  ext/Time-HiRes/Changes ext/Win32API-File/Changes lib/CGI/Changes
+  lib/ExtUtils/CBuilder/Changes lib/ExtUtils/Changes lib/ExtUtils/NOTES
+  lib/ExtUtils/PATCHING lib/ExtUtils/README lib/Module/Build/Changes
+  lib/Net/Ping/Changes lib/Test/Harness/Changes
+  lib/Term/ANSIColor/ChangeLog lib/Term/ANSIColor/README README.symbian
+  symbian/TODO
 
 =item Build, Configure, Make, Install
 
@@ -631,9 +630,9 @@ be kept as clean as possible.
 
 =item Compiled Module Source
 
-  ext/Compress/Raw/Zlib/Makefile.PL
+  ext/Compress-Raw-Zlib/Makefile.PL
                         - Can't install via CPAN shell under Cygwin
-  ext/Compress/Raw/Zlib/zlib-src/zutil.h
+  ext/Compress-Raw-Zlib/zlib-src/zutil.h
                         - Cygwin is Unix-like and has vsnprintf
   ext/Errno/Errno_pm.PL - Special handling for Win32 Perl under Cygwin
   ext/POSIX/POSIX.xs    - tzname defined externally
@@ -645,9 +644,9 @@ be kept as clean as possible.
                         - Cygwin has syslog.h
   ext/Sys/Syslog/win32/compile.pl
                         - Convert paths to Windows paths
-  ext/Time/HiRes/HiRes.xs
+  ext/Time-HiRes/HiRes.xs
                         - Various timers not available
-  ext/Time/HiRes/Makefile.PL
+  ext/Time-HiRes/Makefile.PL
                         - Find w32api/windows.h
   ext/Win32/Makefile.PL - Use various libraries under Cygwin
   ext/Win32/Win32.xs    - Child dir and child env under Cygwin
@@ -659,11 +658,11 @@ be kept as clean as possible.
 =item Perl Modules/Scripts
 
   ext/B/t/OptreeCheck.pm - Comment about stderr/stdout order under Cygwin
-  ext/Digest/SHA/bin/shasum
+  ext/Digest-SHA/bin/shasum
                         - Use binary mode under Cygwin
   ext/Sys/Syslog/win32/Win32.pm
                         - Convert paths to Windows paths
-  ext/Time/HiRes/HiRes.pm
+  ext/Time-HiRes/HiRes.pm
                         - Comment about various timers not available
   ext/Win32API-File/File.pm
                         - _open_osfhandle not implemented under Cygwin
@@ -674,7 +673,7 @@ be kept as clean as possible.
   lib/CPANPLUS/Internals/Constants/Report.pm
                         - OS classifications
   lib/CPANPLUS/Internals/Constants.pm
-                        - Contants for Cygwin
+                        - Constants for Cygwin
   lib/CPANPLUS/Internals/Report.pm
                         - Example of Cygwin report
   lib/CPANPLUS/Module.pm
@@ -715,19 +714,19 @@ be kept as clean as possible.
 
 =item Perl Module Tests
 
-  ext/Compress/Zlib/t/14gzopen.t
-  ext/Cwd/t/cwd.t
+  dist/Cwd/t/cwd.t
+  ext/Compress-Zlib/t/14gzopen.t
   ext/DB_File/t/db-btree.t
   ext/DB_File/t/db-hash.t
   ext/DB_File/t/db-recno.t
   ext/DynaLoader/t/DynaLoader.t
-  ext/File/Glob/t/basic.t
+  ext/File-Glob/t/basic.t
   ext/GDBM_File/t/gdbm.t
   ext/POSIX/t/sysconf.t
   ext/POSIX/t/time.t
   ext/SDBM_File/t/sdbm.t
   ext/Sys/Syslog/t/syslog.t
-  ext/Time/HiRes/t/HiRes.t
+  ext/Time-HiRes/t/HiRes.t
   ext/Win32/t/Unicode.t
   ext/Win32API-File/t/file.t
   ext/Win32CORE/t/win32core.t