README_cygwin.pod

   1 This file is best viewed with "perldoc README.cygwin".
   2
   3 =head1 NAME
   4
   5 README.cygwin - Parrot under Cygwin
   6
   7 =head1 SYNOPSIS
   8
   9 Parrot builds out of the box under Cygwin.  Some tweaks are needed for
  10 different names of dynamic loading of some dll's.
  11
  12 =head1 Packages
  13
  14 You'll need the following Cygwin packages to build Parrot.
  15
  16 =over 4
  17
  18 =item gcc
  19
  20 =item make
  21
  22 =item perl
  23
  24 =item subversion
  25
  26 If you use SVN to get a copy of Parrot, you should use the Cygwin SVN
  27 and not the TortoiseSVN client to avoid build errors.  Similarly you will
  28 need Cygwin Perl rather than ActiveState or Strawberry Perl.
  29
  30 =item ICU
  31
  32 This is no official Cygwin package yet.  However, icu4c-3_8 builds out of the
  33 box on Cygwin.
  34
  35   http://download.icu-project.org/files/icu4c/3.8/icu4c-3_8-src.tgz
  36
  37 Note that ICU is now optional, you can build Parrot without it,
  38 by not installing it or asking Parrot to ignore it (C<--without-icu>).
  39
  40 =back
  41
  42 =head1 BUILD
  43
  44   export PATH=`pwd`/blib/lib:$PATH
  45   perl Configure.pl
  46   make
  47   make test # see PLATFORMS for known issues.
  48   make reallyinstall
  49
  50 =head1 TODO
  51
  52 =over
  53
  54 =item Makefile tuning
  55
  56 rename libparrot.dll to cygparrot.dll, create an interim libparrot.dll.a
  57
  58 fix the blib/lib PATH issue
  59
  60 =item DLL versioning
  61
  62 cyg*-1.1.dll instead of lib*.so.1.1
  63
  64 Thanks to the L<Windows DLL Hell / http://> and the impossibility of file
  65 hardlinks, windows dll names are versioned, so the loadlib function or the
  66 various pir's needs more logic.
  67
  68 Either add the version to each loadlib call, and stem the version from POSIX
  69 versions within get_path(), or add an optional version argument to loadlib for
  70 win32. Or just fix all the pir's.
  71
  72 =item Features
  73
  74 Threads, Events, and Signals are missing.
  75
  76 =back
  77
  78 =head1 AUTHORS
  79
  80 =over
  81
  82 =item Reini Urban E<lt>rurban@cpan.orgE<gt>
  83
  84 =back
  85
  86 =head1 SEE ALSO
  87
  88     L<parrot>
  89
  90 =head1 HISTORY
  91
  92 Last updated: 1 June 2008
  93
  94 =cut