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.
  10 Some tweaks are needed for 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.
  28
  29 =item ICU
  30
  31 This is no official cygwin package yet.
  32 However, icu4c-3_8 builds out of the box on cygwin.
  33   http://download.icu-project.org/files/icu4c/3.8/icu4c-3_8-src.tgz
  34
  35 Note that ICU is now optional, you can build Parrot without it,
  36 by not installing it or asking Parrot to ignore it (C<--without-icu>).
  37
  38 =back
  39
  40 =head1 BUILD
  41
  42   export PATH=`pwd`/blib/lib:$PATH
  43   perl Configure.pl
  44   make
  45   make test # see PLATFORMS for known issues.
  46   make reallyinstall
  47
  48 =head1 TODO
  49
  50 =over
  51
  52 =item Makefile tuning
  53
  54 rename libparrot.dll to cygparrot.dll, create an interim libparrot.dll.a
  55
  56 for make test:
  57 blib/lib must be added to the PATH, or link blib/lib/libparrot.dll to the parrot root.
  58   ln blib/lib/libparrot.dll libparrot.dll
  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 various
  66 pir's needs more logic.
  67
  68 Either add the version to each loadlib call, and stem the version from
  69 POSIX versions within get_path(), or add an optional version argument to
  70 loadlib for win32. Or just fix all the pir's.
  71
  72 =item Configure
  73
  74 nmake detection probably wrong. replace by make.
  75
  76 =item Features
  77
  78 Threads, Events, and Signals are missing.
  79
  80 =back
  81
  82 =head1 AUTHORS
  83
  84 =over
  85
  86 =item Reini Urban E<lt>rurban@cpan.orgE<gt>
  87
  88 =back
  89
  90 =head1 SEE ALSO
  91
  92     L<parrot>
  93
  94 =head1 HISTORY
  95
  96 Last updated: 2 March 2008
  97
  98 =cut