Permalink
Browse files

Update to include a DESCRIPTION and some additional information on ho…

…w to resolve various problems to close issue #700.
  • Loading branch information...
ayardley committed May 24, 2012
1 parent 93841d7 commit 647008502c85a12b3385108fdb46bcef0c3ea7a4
Showing with 34 additions and 6 deletions.
  1. +3 −3 DONORS.pod
  2. +31 −3 README_cygwin.pod
View
@@ -4,10 +4,10 @@
DONORS
-=head1 DONORS
+=head1 DESCRIPTION
-We would like to thank the following people and institutions,
-whose financial contributions help support the development of Parrot.
+We want to thank the following people and institutions, whose financial
+contributions help to support the development of Parrot.
=over 4
View
@@ -4,10 +4,10 @@ This file is best viewed with "perldoc README.cygwin".
README.cygwin - Parrot under Cygwin
-=head1 SYNOPSIS
+=head1 DESCRIPTION
-Parrot builds out of the box under Cygwin,
-when no other parrot is installed. See below at PROBLEMS.
+Parrot builds out of the box under Cygwin, when no other parrot is installed.
+I<See> PROBLEMS below.
There are official cygwin parrot packages available via
L<http://cygwin.com/setup.exe>.
@@ -152,6 +152,34 @@ F</usr/lib/libparrot.dll.a>, F</usr/local/lib/libparrot.dll.a>
This is a known Windows limitation with NTFS junctions on files.
+=item *** fatal error - unable to remap ....
+
+Evidently, this problem results from a relocated C<cygwin1.dll>. For more on
+this problem, I<see> http://www.cygwin.com/ml/cygwin/2009-05/msg00413.html
+
+The fix is to issue a C<rebaseall> command in Cygwin's C<rebase> package.
+For information on how to do this, I<see>
+http://www.heikkitoivonen.net/blog/2008/11/26/cygwin-upgrades-and-rebaseall/
+For more information on the problem, I<see also>
+I<and see> http://code.google.com/p/chromium/wiki/CygwinDllRemappingFailure
+
+=item Exception: STATUS_ACCESS_VIOLATION ....
+
+If this exception results, please ensure you have only a single version of
+C<cygwin1.dll> present on your system or, alternatively, ensure no application
+interferes with Cygwin. For more information on this problem, I<see> the
+Cygwin/X FAQ at
+http://x.cygwin.com/docs/faq/cygwin-x-faq.html#q-status-access-violation
+I<and see> the main Cygwin FAQ at
+http://cygwin.com/faq-nochunks.html#faq.using.bloda
+
+=item build aborts
+
+If the build aborts, it might be necessary to include already built DLLs in
+the rebase. For instructions on how to resolve this problem, I<see> the
+"PROBLEMS" section
+http://cpansearch.perl.org/src/BFREE/OpenGL-0.57/README.cygwin
+
=back
=head1 TODO

0 comments on commit 6470085

Please sign in to comment.