PROBLEMS.pod

   1 =head1 NAME
   2
   3 Current Problems and Workarounds
   4
   5 =head1 AUTHOR
   6
   7 Various Perl6 Contributors
   8
   9 =head1 DESCRIPTION
  10
  11 It is not uncommon for us to do a release, and find some particular
  12 system configuration somewhere is having difficulties.  This file is
  13 intended as a place to accumulate information on symptoms and workarounds
  14 for the current release.  It is mainly intended for developers,
  15 rather than users.
  16
  17 =head1 PROBLEM: "cpan -i Task::Smoke" fails because Test-TAP-Model-0.06 install fails.
  18
  19 B<WORKAROUND:> Force it with "cpan -if Task::TAP::Model".
  20
  21
  22 =head1 PROBLEM: Doesn't build under Debian; aborts with
  23   "Setup: error reading ./.setup-config"
  24
  25 B<WORKAROUND:> Install libghc6-network-dev
  26
  27
  28 =head1 PROBLEM: make pugs fails at link time, with errors like
  29   "undefined reference to `PL_modglobal'".
  30
  31 B<NOTES:>
  32 You may have a misconfigured perl installation, which is breaking perl5
  33 embedding.  You can try building without perl5 embedding, or read on.
  34
  35 Perl5 embedding depends on finding C header files like perl.h, and a
  36 matching perl library (libperl.so, .a, or .dll).  When you run "perl
  37 Makefile.PL", perl provides -I and -L arguments telling which
  38 directories to look in, and in what order.  You can see these
  39 arguments by running "perl -MExtUtils::Embed -e ccopts -e ldopts".
  40 The headers and library must come from the same version of perl that
  41 you ran.
  42
  43 If, for example, a second version of perl has also been installed, and
  44 a libperl.so from it is found earlier in ldopts than the correct one,
  45 the headers and libperl will not match, and make pugs may fail with
  46 "undefined reference" errors as described.  You can either (re)move
  47 the inconsistent file(s), or set LD_LIBRARY_PATH to include the
  48 correct library directory first (it generally ends in "CORE").
  49
  50 Hypothetically, more subtle problems might perhaps arise if headers
  51 and library match each other, but not the perl which ran Makefile.PL
  52 and its Config.  This is never been reported, and even the unsubtle
  53 version is very uncommon.
  54
  55 There doesn't seem to be an easy way to detect this problem short of
  56 the current "try to link and see if it works".
  57
  58 =head1 PROBLEM: perl Makefile.PL fails after "Preprocessing library zlib"
  59   with an error like "Cannot install zlib: 256"
  60
  61 B<SOLUTION:> Please make sure that your $PATH contains ghc (6.8.2+) binaries
  62   first, and then run 'perl Makefile.PL' again.