Add Olivier Mengué to AUTHORS

[perl5.git] / README.cygwin

diff --git a/README.cygwin b/README.cygwin
index 017c452..8414a97 100644 (file)
--- a/README.cygwin
+++ b/README.cygwin
@@ -31,7 +31,7 @@ L<http://www.cygwin.com/>
 
 A recent net or commercial release of Cygwin is required.
 
 
 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
 
 
 =head2 Cygwin Configuration


@@ -43,7 +43,7 @@ Perl usage.
 B<NOTE:> 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).
 B<NOTE:> 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</usr/local>.
+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">).
 
 However, your host system and Cygwin configuration will affect Perl's
 runtime behavior (see L</"TEST">).
 


@@ -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<//UNC>) are also supported Since cygwin-1.7 non-POSIX
 
 Cygwin pathnames are separated by forward (F</>) slashes, Universal
 Naming Codes (F<//UNC>) 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
 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
 
 
 =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
 
 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:
 
 
 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<http://cygwin.com/faq/faq-nochunks.html#faq.using.fixing-fork-failures>
   46 [main] perl 3488 fork: child 3588 - died waiting for dll loading, errno11
 
 See L<http://cygwin.com/faq/faq-nochunks.html#faq.using.fixing-fork-failures>


@@ -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.
 
 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<http://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
 =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
   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
   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/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/Embed.t
   lib/ExtUtils/t/eu_command.t
   lib/ExtUtils/t/MM_Cygwin.t