This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Update the installation URL for Cygwin
[perl5.git] / README.cygwin
index 3933e56..5885ac5 100644 (file)
@@ -1,10 +1,10 @@
 If you read this file _as_is_, just ignore the funny characters you
-see. It is written in the POD format (see pod/perlpod.pod) which is
+see. It is written in the POD format (see F<pod/perlpod.pod>) which is
 specially designed to be readable as is.
 
 =head1 NAME
 
-README.cygwin - Perl for Cygwin
+perlcygwin - Perl for Cygwin
 
 =head1 SYNOPSIS
 
@@ -27,11 +27,11 @@ 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<https://www.cygwin.com/>
 
 A recent net or commercial release of Cygwin is required.
 
-At the time this document was last updated, Cygwin 1.5.24 was current.
+At the time this document was last updated, Cygwin 1.7.16 was current.
 
 
 =head2 Cygwin Configuration
@@ -41,9 +41,9 @@ that Perl builds cleanly.  These changes are B<not> required for normal
 Perl usage.
 
 B<NOTE:> The binaries that are built will run on all Win32 versions.
-They do not depend on your host system (Win9x/WinME, WinNT/Win2K)
-or your Cygwin configuration (I<ntea>, I<ntsec>, binary/text mounts).
-The only dependencies come from hard-coded pathnames like C</usr/local>.
+They do not depend on your host system (WinXP/Win2K/Win7) or your
+Cygwin configuration (binary/text mounts, cvgserver).
+The only dependencies come from hard-coded pathnames like F</usr/local>.
 However, your host system and Cygwin configuration will affect Perl's
 runtime behavior (see L</"TEST">).
 
@@ -52,7 +52,7 @@ runtime behavior (see L</"TEST">).
 =item * C<PATH>
 
 Set the C<PATH> environment variable so that Configure finds the Cygwin
-versions of programs.  Any Windows directories should be removed or
+versions of programs. Any not-needed Windows directories should be removed or
 moved to the end of your C<PATH>.
 
 =item * I<nroff>
@@ -60,28 +60,13 @@ moved to the end of your C<PATH>.
 If you do not have I<nroff> (which is part of the I<groff> package),
 Configure will B<not> prompt you to install I<man> pages.
 
-=item * Permissions
-
-On WinNT with either the I<ntea> or I<ntsec> C<CYGWIN> settings, directory
-and file permissions may not be set correctly.  Since the build process
-creates directories and files, to be safe you may want to run a
-C<chmod -R +w *> on the entire Perl source tree.
-
-Also, it is a well known WinNT "feature" that files created by a login
-that is a member of the I<Administrators> group will be owned by the
-I<Administrators> group.  Depending on your umask, you may find that you
-can not write to files that you just created (because you are no longer
-the owner).  When using the I<ntsec> C<CYGWIN> setting, this is not an
-issue because it "corrects" the ownership to what you would expect on
-a UNIX system.
-
 =back
 
 =head1 CONFIGURE PERL ON CYGWIN
 
 The default options gathered by Configure with the assistance of
 F<hints/cygwin.sh> will build a Perl that supports dynamic loading
-(which requires a shared F<libperl.dll>).
+(which requires a shared F<cygperl5_16.dll>).
 
 This will run Configure and keep a record:
 
@@ -98,7 +83,8 @@ binaries to be stripped, you can either add a B<-s> option when Configure
 prompts you,
 
   Any additional ld flags (NOT including libraries)? [none] -s
-  Any special flags to pass to g++ to create a dynamically loaded library?
+  Any special flags to pass to g++ to create a dynamically loaded
+  library?
   [none] -s
   Any special flags to pass to gcc to use dynamic linking? [none] -s
 
@@ -122,16 +108,8 @@ DES crypt port by Corinna Vinschen.
 
 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.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.franken.de/pub/win32/develop/gnuwin32/cygwin/porters/Okhapkin_Sergey/libcrypt.tgz
+As of libcrypt 1.3 (March 2016), you will need to install the
+libcrypt-devel package for Configure to detect crypt().
 
 =item * C<-lgdbm_compat> (C<use GDBM_File>)
 
@@ -143,8 +121,7 @@ NOTE: The GDBM library only works on NTFS partitions.
 
 BerkeleyDB is available for Cygwin.
 
-NOTE: The BerkeleyDB library only completely works on NTFS partitions
-and db-4.3 is flawed.
+NOTE: The BerkeleyDB library only completely works on NTFS partitions.
 
 =item * C<cygserver> (C<use IPC::SysV>)
 
@@ -177,10 +154,11 @@ prompts you or you can define (undefine) symbols on the command line.
 
 Undefining this symbol forces Perl to be compiled statically.
 
-=item * C<-Uusemymalloc>
+=item * C<-Dusemymalloc>
 
-By default Perl uses the C<malloc()> included with the Perl source.  If you
-want to force Perl to build with the system C<malloc()> undefine this symbol.
+By default Perl does not use the C<malloc()> included with the Perl source,
+because it was slower and not entirely thread-safe.  If you want to force
+Perl to build with the old -Dusemymalloc define this.
 
 =item * C<-Uuseperlio>
 
@@ -190,12 +168,13 @@ default; it is not recommended to disable PerlIO.
 =item * C<-Dusemultiplicity>
 
 Multiplicity is required when embedding Perl in a C program and using
-more than one interpreter instance.  This works with the Cygwin port.
+more than one interpreter instance.  This is only required when you build
+a not-threaded perl with C<-Uuseithreads>.
 
-=item * C<-Duse64bitint>
+=item * C<-Uuse64bitint>
 
-By default Perl uses 32 bit integers.  If you want to use larger 64
-bit integers, define this symbol.
+By default Perl uses 64 bit integers.  If you want to use smaller 32 bit
+integers, define this symbol.
 
 =item * C<-Duselongdouble>
 
@@ -203,12 +182,11 @@ I<gcc> supports long doubles (12 bytes).  However, several additional
 long double math functions are necessary to use them within Perl
 (I<{atan2, cos, exp, floor, fmod, frexp, isnan, log, modf, pow, sin, sqrt}l,
 strtold>).
-These are B<not> yet available with Cygwin.
+These are B<not> yet available with newlib, the Cygwin libc.
 
-=item * C<-Dusethreads>
+=item * C<-Uuseithreads>
 
-POSIX threads are implemented in Cygwin, define this symbol if you want
-a threaded perl.
+Define this symbol if you want not-threaded faster perl.
 
 =item * C<-Duselargefiles>
 
@@ -217,9 +195,9 @@ this will be correctly detected and defined by Configure.
 
 =item * C<-Dmksymlinks>
 
-Use this to build perl outside of the source tree.  This works with Cygwin.
-Details can be found in the F<INSTALL> document.  This is the recommended
-way to build perl from sources.
+Use this to build perl outside of the source tree.  Details can be
+found in the F<INSTALL> document.  This is the recommended way to
+build perl from sources.
 
 =back
 
@@ -234,12 +212,13 @@ You may see some messages during Configure that seem suspicious.
 Win9x does not correctly report C<EOF> with a non-blocking read on a
 closed pipe.  You will see the following messages:
 
 But it also returns -1 to signal EOF, so be careful!
 WARNING: you can't distinguish between EOF and no data!
+ But it also returns -1 to signal EOF, so be careful!
+ WARNING: you can't distinguish between EOF and no data!
 
-  *** WHOA THERE!!! ***
-      The recommended value for $d_eofnblk on this machine was "define"!
-      Keep the recommended value? [y]
+ *** WHOA THERE!!! ***
+     The recommended value for $d_eofnblk on this machine was
+     "define"!
+     Keep the recommended value? [y]
 
 At least for consistency with WinNT, you should keep the recommended
 value.
@@ -334,7 +313,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
 
@@ -349,33 +328,29 @@ to portability, more information can be found in the Cygwin documentation.
 
 =item * Pathnames
 
-Cygwin pathnames can be separated by forward (F</>) or backward (F<\\>)
-slashes.  They may also begin with drive letters (F<C:>) or Universal
-Naming Codes (F<//UNC>).  DOS device names (F<aux>, F<con>, F<prn>,
-F<com*>, F<lpt?>, F<nul>) are invalid as base filenames.  However, they
-can be used in extensions (e.g., F<hello.aux>).  Names may contain all
-printable characters except these:
-
-  : * ? " < > |
+Cygwin pathnames are separated by forward (F</>) slashes, Universal
+Naming Codes (F<//UNC>) are also supported Since cygwin-1.7 non-POSIX
+pathnames are discouraged.  Names may contain all printable
+characters.
 
 File names are case insensitive, but case preserving.  A pathname that
-contains a backslash or drive letter is a Win32 pathname (and not subject
-to the translations applied to POSIX style pathnames).
+contains a backslash or drive letter is a Win32 pathname, and not
+subject to the translations applied to POSIX style pathnames, but
+cygwin will warn you, so better convert them to POSIX.
 
 For conversion we have C<Cygwin::win_to_posix_path()> and
 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/>
+Since cygwin-1.7 pathnames are UTF-8 encoded.
 
 =item * Text/Binary
 
+Since cygwin-1.7 textmounts are deprecated and strongly discouraged.
+
 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:
@@ -411,8 +386,8 @@ extension transparent by looking for F<foo.exe> when you ask for F<foo>
 (unless a F<foo> also exists).  Cygwin does not require a F<.exe>
 extension, but I<gcc> adds it automatically when building a program.
 However, when accessing an executable as a normal file (e.g., I<cp>
-in a makefile) the F<.exe> is not transparent.  The I<install> included
-with Cygwin automatically appends a F<.exe> when necessary.
+in a makefile) the F<.exe> is not transparent.  The I<install> program
+included with Cygwin automatically appends a F<.exe> when necessary.
 
 =item * Cygwin vs. Windows process ids
 
@@ -420,7 +395,7 @@ Cygwin processes have their own pid, which is different from the
 underlying windows pid.  Most posix compliant Proc functions expect
 the cygwin pid, but several Win32::Process functions expect the
 winpid. E.g. C<$$> is the cygwin pid of F</usr/bin/perl>, which is not
-the winpid.  Use C<Cygwin::winpid_to_pid()> and C<Cygwin::winpid_to_pid()>
+the winpid.  Use C<Cygwin::pid_to_winpid()> and C<Cygwin::winpid_to_pid()>
 to translate between them.
 
 =item * Cygwin vs. Windows errors
@@ -428,6 +403,34 @@ to translate between them.
 Under Cygwin, $^E is the same as $!.  When using L<Win32 API Functions|Win32>,
 use C<Win32::GetLastError()> to get the last Windows error.
 
+=item * rebase errors on fork or system
+
+Using C<fork()> or C<system()> out to another perl after loading multiple dlls
+may result on a DLL baseaddress conflict. The internal cygwin error
+looks like like the following:
+
+ 0 [main] perl 8916 child_info_fork::abort: data segment start:
+ parent (0xC1A000) != child(0xA6A000)
+
+or:
+
+ 183 [main] perl 3588 C:\cygwin\bin\perl.exe: *** fatal error -
+ unable to remap C:\cygwin\bin\cygsvn_subr-1-0.dll to same address
+ as parent(0x6FB30000) != 0x6FE60000 46 [main] perl 3488 fork: child
+ 3588 - died waiting for dll loading, errno11
+
+See L<https://cygwin.com/faq/faq-nochunks.html#faq.using.fixing-fork-failures>
+It helps if not too many DLLs are loaded in memory so the available address space is larger,
+e.g. stopping the MS Internet Explorer might help.
+
+Use the perlrebase or rebase utilities to resolve the conflicting dll addresses.
+The rebase package is included in the Cygwin setup. Use F<setup.exe>
+from L<https://cygwin.com/install.html> to install it.
+
+1. kill all perl processes and run C<perlrebase> or
+
+2. kill all cygwin processes and services, start dash from cmd.exe and run C<rebaseall>.
+
 =item * C<chown()>
 
 On WinNT C<chown()> can change a file's user and group IDs.  On Win9x C<chown()>
@@ -448,18 +451,6 @@ of the file being edited C<perl -i.bak> because of windowish restrictions,
 therefore Perl adds the suffix C<.bak> automatically if you use C<perl -i>
 without specifying a backup extension.
 
-Using C<fork()> after loading multiple dlls may fail with an internal cygwin
-error like the following:
-
-  C:\CYGWIN\BIN\PERL.EXE: *** couldn't allocate memory 0x10000(4128768) for 'C:\CYGWIN\LIB\PERL5\5.6.1\CYGWIN-MULTI\AUTO\SOCKET\SOCKET.DLL' alignment, Win32 error 8
-
-    200 [main] perl 377147 sync_with_child: child -395691(0xB8) died before initialization with status code 0x1
-   1370 [main] perl 377147 sync_with_child: *** child state child loading dlls
-
-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.
-
 =back
 
 =head2 Prebuilt methods:
@@ -529,6 +520,17 @@ User mounts override system mounts.
 Returns true if the given cygwin path is binary mounted, false if the
 path is mounted in textmode.
 
+=item C<Cygwin::sync_winenv>
+
+Cygwin does not initialize all original Win32 environment variables.
+See the bottom of this page L<https://cygwin.com/cygwin-ug-net/setup-env.html>
+for "Restricted Win32 environment".
+
+Certain Win32 programs called from cygwin programs might need some environment
+variable, such as e.g. ADODB needs %COMMONPROGRAMFILES%.
+Call Cygwin::sync_winenv() to copy all Win32 environment variables to your
+process and note that cygwin will warn on every encounter of non-POSIX paths.
+
 =back
 
 =head1 INSTALL PERL ON CYGWIN
@@ -557,205 +559,200 @@ be kept as clean as possible.
 
 =item Documentation
 
-  INSTALL README.cygwin README.win32 MANIFEST
-  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 pod/perlrepository.pod
-  Porting/checkAUTHORS.pl
-  ext/Compress-Raw-Zlib/Changes ext/Compress-Raw-Zlib/README
-  ext/Compress-Zlib/Changes cpan/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
+ INSTALL README.cygwin README.win32 MANIFEST
+ 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 Porting/Glossary pod/perlgit.pod
+ Porting/checkAUTHORS.pl
+ dist/Cwd/Changes ext/Compress-Raw-Zlib/Changes
+ dist/Time-HiRes/Changes
+ ext/Compress-Raw-Zlib/README ext/Compress-Zlib/Changes
+ ext/DB_File/Changes ext/Encode/Changes ext/Sys-Syslog/Changes
+ ext/Win32API-File/Changes
+ lib/ExtUtils/CBuilder/Changes lib/ExtUtils/Changes
+ lib/ExtUtils/NOTES lib/ExtUtils/PATCHING lib/ExtUtils/README
+ 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
 
 cygwin/Makefile.SHs
 ext/IPC/SysV/hints/cygwin.pl
 ext/NDBM_File/hints/cygwin.pl
 ext/ODBM_File/hints/cygwin.pl
 hints/cygwin.sh
 Configure             - help finding hints from uname,
-                          shared libperl required for dynamic loading
 Makefile.SH Cross/Makefile-cross-SH
-                        - linklibperl
 Porting/patchls       - cygwin in port list
 installman            - man pages with :: translated to .
 installperl           - install dll, install to 'pods'
 makedepend.SH         - uwinfix
 regen_lib.pl          - file permissions
-
 NetWare/Makefile
 plan9/mkfile
 symbian/sanity.pl symbian/sisify.pl
 hints/uwin.sh
 vms/descrip_mms.template
 win32/Makefile win32/makefile.mk
+ cygwin/Makefile.SHs
+ ext/IPC/SysV/hints/cygwin.pl
+ ext/NDBM_File/hints/cygwin.pl
+ ext/ODBM_File/hints/cygwin.pl
+ hints/cygwin.sh
+ Configure             - help finding hints from uname,
+                         shared libperl required for dynamic loading
+ Makefile.SH Cross/Makefile-cross-SH
+                       - linklibperl
+ Porting/patchls       - cygwin in port list
+ installman            - man pages with :: translated to .
+ installperl           - install dll, install to 'pods'
+ makedepend.SH         - uwinfix
+ regen_lib.pl          - file permissions
+
+ NetWare/Makefile
+ plan9/mkfile
+ symbian/sanity.pl symbian/sisify.pl
+ hints/uwin.sh
+ vms/descrip_mms.template
+ win32/Makefile win32/makefile.mk
 
 =item Tests
 
-  t/io/fs.t             - no file mode checks if not ntsec
-                          skip rename() check when not check_case:relaxed
-  t/io/tell.t           - binmode
-  t/lib/cygwin.t        - builtin cygwin function tests
-  t/op/groups.t         - basegroup has ID = 0
-  t/op/magic.t          - $^X/symlink WORKAROUND, s/.exe//
-  t/op/stat.t           - no /dev, skip Win32 ftCreationTime quirk
-                          (cache manager sometimes preserves ctime of file
-                          previously created and deleted), no -u (setuid)
-  t/op/taint.t          - can't use empty path under Cygwin Perl
-  t/op/time.t           - no tzset()
+ t/io/fs.t             - no file mode checks if not ntsec
+                         skip rename() check when not
+                         check_case:relaxed
+ t/io/tell.t           - binmode
+ t/lib/cygwin.t        - builtin cygwin function tests
+ t/op/groups.t         - basegroup has ID = 0
+ t/op/magic.t          - $^X/symlink WORKAROUND, s/.exe//
+ t/op/stat.t           - no /dev, skip Win32 ftCreationTime quirk
+                         (cache manager sometimes preserves ctime of
+                         file previously created and deleted), no -u
+                         (setuid)
+ t/op/taint.t          - can't use empty path under Cygwin Perl
+ t/op/time.t           - no tzset()
 
 =item Compiled Perl Source
 
-  EXTERN.h              - __declspec(dllimport)
-  XSUB.h                - __declspec(dllexport)
-  cygwin/cygwin.c       - os_extras (getcwd, spawn, and several Cygwin:: functions)
-  perl.c                - os_extras, -i.bak
-  perl.h                - binmode
-  doio.c                - win9x can not rename a file when it is open
-  pp_sys.c              - do not define h_errno, init _pwent_struct.pw_comment
-  util.c                - use setenv
-  util.h                - PERL_FILE_IS_ABSOLUTE macro
-  pp.c                  - Comment about Posix vs IEEE math under Cygwin
-  perlio.c              - CR/LF mode
-  perliol.c             - Comment about EXTCONST under Cygwin
+ EXTERN.h              - __declspec(dllimport)
+ XSUB.h                - __declspec(dllexport)
+ cygwin/cygwin.c       - os_extras (getcwd, spawn, and several
+                         Cygwin:: functions)
+ perl.c                - os_extras, -i.bak
+ perl.h                - binmode
+ doio.c                - win9x can not rename a file when it is open
+ pp_sys.c              - do not define h_errno, init
+                         _pwent_struct.pw_comment
+ util.c                - use setenv
+ util.h                - PERL_FILE_IS_ABSOLUTE macro
+ pp.c                  - Comment about Posix vs IEEE math under
+                         Cygwin
+ perlio.c              - CR/LF mode
+ perliol.c             - Comment about EXTCONST under Cygwin
 
 =item Compiled Module Source
 
-  ext/Compress-Raw-Zlib/Makefile.PL
-                        - Can't install via CPAN shell under Cygwin
-  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
-  ext/SDBM_File/sdbm/pair.c
-                        - EXTCONST needs to be redefined from EXTERN.h
-  ext/SDBM_File/sdbm/sdbm.c
-                        - binary open
-  ext/Sys/Syslog/Syslog.xs
-                        - Cygwin has syslog.h
-  ext/Sys/Syslog/win32/compile.pl
-                        - Convert paths to Windows paths
-  ext/Time-HiRes/HiRes.xs
-                        - Various timers not available
-  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
-  ext/Win32API-File/File.xs
-                        - _open_osfhandle not implemented under Cygwin
-  ext/Win32CORE/Win32CORE.c
-                        - __declspec(dllexport)
+ ext/Compress-Raw-Zlib/Makefile.PL
+                       - Can't install via CPAN shell under Cygwin
+ 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
+ ext/SDBM_File/sdbm/pair.c
+                       - EXTCONST needs to be redefined from
+                         EXTERN.h
+ ext/SDBM_File/sdbm/sdbm.c
+                       - binary open
+ ext/Sys/Syslog/Syslog.xs
+                       - Cygwin has syslog.h
+ ext/Sys/Syslog/win32/compile.pl
+                       - Convert paths to Windows paths
+ ext/Time-HiRes/HiRes.xs
+                       - Various timers not available
+ 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
+ ext/Win32API-File/File.xs
+                       - _open_osfhandle not implemented under
+                         Cygwin
+ ext/Win32CORE/Win32CORE.c
+                       - __declspec(dllexport)
 
 =item Perl Modules/Scripts
 
-  ext/B/t/OptreeCheck.pm - Comment about stderr/stdout order under Cygwin
-  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
-                        - Comment about various timers not available
-  ext/Win32API-File/File.pm
-                        - _open_osfhandle not implemented under Cygwin
-  ext/Win32CORE/Win32CORE.pm
-                        - History of Win32CORE under Cygwin
-  lib/CGI.pm            - binmode and path separator
-  lib/CPANPLUS/Dist/MM.pm - Commented out code that fails under Win32/Cygwin
-  lib/CPANPLUS/Internals/Constants/Report.pm
-                        - OS classifications
-  lib/CPANPLUS/Internals/Constants.pm
-                        - Contants for Cygwin
-  lib/CPANPLUS/Internals/Report.pm
-                        - Example of Cygwin report
-  lib/CPANPLUS/Module.pm
-                        - Abort if running on old Cygwin version
-  lib/Cwd.pm            - hook to internal Cwd::cwd
-  lib/ExtUtils/CBuilder/Platform/cygwin.pm
-                        - use gcc for ld, and link to libperl.dll.a
-  lib/ExtUtils/CBuilder.pm
-                        - Cygwin is Unix-like
-  lib/ExtUtils/Install.pm - Install and rename issues under Cygwin
-  lib/ExtUtils/MM.pm    - OS classifications
-  lib/ExtUtils/MM_Any.pm - Example for Cygwin
-  lib/ExtUtils/MakeMaker.pm
-                        - require MM_Cygwin.pm
-  lib/ExtUtils/MM_Cygwin.pm
-                        - canonpath, cflags, manifypods, perl_archive
-  lib/File/Fetch.pm     - Comment about quotes using a Cygwin example
-  lib/File/Find.pm      - on remote drives stat() always sets st_nlink to 1
-  lib/File/Spec/Cygwin.pm - case_tolerant
-  lib/File/Spec/Unix.pm - preserve //unc
-  lib/File/Spec/Win32.pm - References a message on cygwin.com
-  lib/File/Spec.pm      - Pulls in lib/File/Spec/Cygwin.pm
-  lib/File/Temp.pm      - no directory sticky bit
-  lib/Module/Build/Compat.pm - Comment references 'make' under Cygwin
-  lib/Module/Build/Platform/cygwin.pm
-                        - Use '.' for man page separator
-  lib/Module/Build.pm   - Cygwin is Unix-like
-  lib/Module/CoreList.pm - List of all module files and versions
-  lib/Net/Domain.pm     - No domainname command under Cygwin
-  lib/Net/Netrc.pm      - Bypass using stat() under Cygwin
-  lib/Net/Ping.pm       - ECONREFUSED is EAGAIN under Cygwin
-  lib/Pod/Find.pm       - Set 'pods' dir
-  lib/Pod/Perldoc/ToMan.pm - '-c' switch for pod2man
-  lib/Pod/Perldoc.pm    - Use 'less' pager, and use .exe extension
-  lib/Term/ANSIColor.pm - Cygwin terminal info
-  lib/perl5db.pl        - use stdin not /dev/tty
-  utils/perlbug.PL      - Add CYGWIN environment variable to report
+ ext/B/t/OptreeCheck.pm - Comment about stderr/stdout order under
+                          Cygwin
+ 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
+                       - Comment about various timers not available
+ ext/Win32API-File/File.pm
+                       - _open_osfhandle not implemented under
+                         Cygwin
+ ext/Win32CORE/Win32CORE.pm
+                       - History of Win32CORE under Cygwin
+ lib/Cwd.pm            - hook to internal Cwd::cwd
+ lib/ExtUtils/CBuilder/Platform/cygwin.pm
+                       - use gcc for ld, and link to libperl.dll.a
+ lib/ExtUtils/CBuilder.pm
+                       - Cygwin is Unix-like
+ lib/ExtUtils/Install.pm - Install and rename issues under Cygwin
+ lib/ExtUtils/MM.pm    - OS classifications
+ lib/ExtUtils/MM_Any.pm - Example for Cygwin
+ lib/ExtUtils/MakeMaker.pm
+                       - require MM_Cygwin.pm
+ lib/ExtUtils/MM_Cygwin.pm
+                       - canonpath, cflags, manifypods, perl_archive
+ lib/File/Fetch.pm     - Comment about quotes using a Cygwin example
+ lib/File/Find.pm      - on remote drives stat() always sets
+                         st_nlink to 1
+ lib/File/Spec/Cygwin.pm - case_tolerant
+ lib/File/Spec/Unix.pm - preserve //unc
+ lib/File/Spec/Win32.pm - References a message on cygwin.com
+ lib/File/Spec.pm      - Pulls in lib/File/Spec/Cygwin.pm
+ lib/File/Temp.pm      - no directory sticky bit
+ lib/Module/CoreList.pm - List of all module files and versions
+ lib/Net/Domain.pm     - No domainname command under Cygwin
+ lib/Net/Netrc.pm      - Bypass using stat() under Cygwin
+ lib/Net/Ping.pm       - ECONREFUSED is EAGAIN under Cygwin
+ lib/Pod/Find.pm       - Set 'pods' dir
+ lib/Pod/Perldoc/ToMan.pm - '-c' switch for pod2man
+ lib/Pod/Perldoc.pm    - Use 'less' pager, and use .exe extension
+ lib/Term/ANSIColor.pm - Cygwin terminal info
+ lib/perl5db.pl        - use stdin not /dev/tty
+ utils/perlbug.PL      - Add CYGWIN environment variable to report
 
 =item Perl Module Tests
 
-  ext/Compress-Zlib/t/14gzopen.t
-  cpan/Cwd/t/cwd.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/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/Win32/t/Unicode.t
-  ext/Win32API-File/t/file.t
-  ext/Win32CORE/t/win32core.t
-  lib/AnyDBM_File.t
-  lib/Archive/Extract/t/01_Archive-Extract.t
-  lib/Archive/Tar/t/02_methods.t
-  lib/CPANPLUS/t/05_CPANPLUS-Internals-Fetch.t
-  lib/CPANPLUS/t/20_CPANPLUS-Dist-MM.t
-  lib/ExtUtils/t/Embed.t
-  lib/ExtUtils/t/eu_command.t
-  lib/ExtUtils/t/MM_Cygwin.t
-  lib/ExtUtils/t/MM_Unix.t
-  lib/File/Compare.t
-  lib/File/Copy.t
-  lib/File/Find/t/find.t
-  lib/File/Path.t
-  lib/File/Spec/t/crossplatform.t
-  lib/File/Spec/t/Spec.t
-  lib/Module/Build/t/destinations.t
-  lib/Net/hostent.t
-  lib/Net/Ping/t/110_icmp_inst.t
-  lib/Net/Ping/t/500_ping_icmp.t
-  lib/Net/t/netrc.t
-  lib/Pod/Simple/t/perlcyg.pod
-  lib/Pod/Simple/t/perlcygo.txt
-  lib/Pod/Simple/t/perlfaq.pod
-  lib/Pod/Simple/t/perlfaqo.txt
-  lib/User/grent.t
-  lib/User/pwent.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/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/Win32/t/Unicode.t
+ ext/Win32API-File/t/file.t
+ ext/Win32CORE/t/win32core.t
+ lib/AnyDBM_File.t
+ lib/Archive/Extract/t/01_Archive-Extract.t
+ lib/Archive/Tar/t/02_methods.t
+ lib/ExtUtils/t/Embed.t
+ lib/ExtUtils/t/eu_command.t
+ lib/ExtUtils/t/MM_Cygwin.t
+ lib/ExtUtils/t/MM_Unix.t
+ lib/File/Compare.t
+ lib/File/Copy.t
+ lib/File/Find/t/find.t
+ lib/File/Path.t
+ lib/File/Spec/t/crossplatform.t
+ lib/File/Spec/t/Spec.t
+ lib/Net/hostent.t
+ lib/Net/Ping/t/110_icmp_inst.t
+ lib/Net/Ping/t/500_ping_icmp.t
+ lib/Net/t/netrc.t
+ lib/Pod/Simple/t/perlcyg.pod
+ lib/Pod/Simple/t/perlcygo.txt
+ lib/Pod/Simple/t/perlfaq.pod
+ lib/Pod/Simple/t/perlfaqo.txt
+ lib/User/grent.t
+ lib/User/pwent.t
 
 =back
 
@@ -781,4 +778,4 @@ Jerry D. Hedden <jdhedden@cpan.org>.
 
 =head1 HISTORY
 
-Last updated: 2007-09-25
+Last updated: 2012-02-08