X-Git-Url: https://perl5.git.perl.org/perl5.git/blobdiff_plain/5bc802de7e259c78b42107eb3d64a617e13556f9..e06f856f7209ef9f86a20d46b2c039a3c7852762:/README.cygwin?ds=sidebyside diff --git a/README.cygwin b/README.cygwin index 017c452..8414a97 100644 --- a/README.cygwin +++ b/README.cygwin @@ -31,7 +31,7 @@ L A recent net or commercial release of Cygwin is required. -At the time this document was last updated, Cygwin 1.7.10 was current. +At the time this document was last updated, Cygwin 1.7.16 was current. =head2 Cygwin Configuration @@ -43,7 +43,7 @@ Perl usage. B The binaries that are built will run on all Win32 versions. 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 C. +The only dependencies come from hard-coded pathnames like F. However, your host system and Cygwin configuration will affect Perl's runtime behavior (see L). @@ -325,7 +325,7 @@ to portability, more information can be found in the Cygwin documentation. Cygwin pathnames are separated by forward (F) slashes, Universal Naming Codes (F) are also supported Since cygwin-1.7 non-POSIX -pathnames are disencouraged. Names may contain all printable +pathnames are discouraged. Names may contain all printable characters. File names are case insensitive, but case preserving. A pathname that @@ -340,7 +340,7 @@ Since cygwin-1.7 pathnames are UTF-8 encoded. =item * Text/Binary -Since cywgin-1.7 textmounts are deprecated and stronlgy discouraged. +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 @@ -409,7 +409,8 @@ looks like like the following: 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 + 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 @@ -513,6 +514,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 does not initialize all original Win32 environment variables. +See the bottom of this page L +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 @@ -653,15 +665,6 @@ be kept as clean as possible. 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 - - Constants 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 @@ -717,8 +720,6 @@ be kept as clean as possible. 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