[svn:parrot] r35883 - trunk

Author: rurban
Date: Thu Jan 22 04:26:17 2009
New Revision: 35883

Modified:
   trunk/README_cygwin.pod

Log:

[cage] Update README_cygwin.pod
       - Added a new PROBLEMS section.
       - Removed parrot-languages.



Modified: trunk/README_cygwin.pod
==============================================================================
--- trunk/README_cygwin.pod	(original)
+++ trunk/README_cygwin.pod	Thu Jan 22 04:26:17 2009
@@ -12,10 +12,12 @@
 There are official cygwin parrot packages available via
 L<http://cygwin.com/setup.exe>.
 
-  parrot libparrot0 libparrot-devel parrot-perl6 parrot-languages
+  parrot libparrot0 libparrot-devel parrot-perl6
 
 Some tweaks are needed for different names for the ffi to some dll's.
-See L</loadlib DLL versioning>
+See L</loadlib DLL versioning>.
+
+parrot-languages was dropped with 0.9.0.
 
 
 =head1 Packages
@@ -46,13 +48,11 @@
 
 Optional perl packages for testing: 
 
-  L<Test::TAP::HTMLMatrix> if you want to run the language smoke tests
-  with C<make languages-smoke>.
+  L<Test::TAP::HTMLMatrix> if you want to run the smoke tests
+  with C<make smoke>.
 
   L<Test::Base> for some APL language tests.
 
-  perl L<Moose> for smartlink
-
   perl L<Test::Perl::Critic> and L<Perl::Critic>
 
 =over 4
@@ -108,24 +108,60 @@
   make test # see PLATFORMS for known issues.
   make reallyinstall
 
-=head1 TODO
+=head1 PROBLEMS
 
 =over
 
-=item Makefile tuning
+=item perl fatal error - unable to remap Glob.dll
+
+Something like:
+  F<perl.exe>: *** fatal error - unable to remap 
+  F<C:\cygwin\lib\perl5\5.10\i686-cygwin\auto\File\Glob\Glob.dll>
+  to same address as parent(C<0x860000>) != C<0x14D0000>
+
+This is a known cygwin problem with dll's, esp. perl on non-XP 32bit platforms.
+You need to install the C<rebase> package and run C<rebaseall> from an C<ash>
+shell.
+
+=item Crash at miniparrot.exe config_lib.pasm
+
+Invoking Parrot to generate runtime/parrot/include/config.fpmc --cross your
+fingers
+
+  F<./miniparrot.exe config_lib.pasm > runtime/parrot/include/config.fpmc>
+crashes
+
+See below.
+
+=item Spurious stackdumps while building
 
-Rename libparrot.dll to cygparrot0_8_2.dll and create an interim
-libparrot.dll.a
+Building with an already installed library fails. See RT#39742
 
-  [perl #56998] [TODO]  rename cygwin dll to cygparrot$MAJOR_$MINOR_$PATCH.dll
-  [perl #56562] [PATCH] root.in: add cygwin importlib
+Be sure that there's no other libparrot.dll.a or libparrot.a 
+in the linker libpath. 
+
+F</usr/lib/libparrot.dll.a>, F</usr/local/lib/libparrot.dll.a>
+
+=item os hardlink test fail
+
+  t/pmc/os....................................
+  #   Failed test 'hard link was really created'
+  #   at t/pmc/os.t line 312.
+
+This is a known Windows limitation with NTFS junctions on files.
+
+=back
+
+=head1 TODO
+
+=over
 
 =item loadlib DLL versioning
 
 Use cyg*-1.1.dll naming conventions instead of lib*.so.1.1 names for
 loadlib, the FFI.
 
-Thanks to the L<Windows DLL Hell> and the impossibility of
+Thanks to the C<Windows DLL Hell> and the impossibility of
 file hardlinks, windows dll names are versioned, so the loadlib
 function or the various pir's needs more logic.
 
@@ -154,6 +190,6 @@
 
 =head1 HISTORY
 
-Last updated: 20 July 2008
+Last updated: 22 January 2009
 
 =cut