Cross/README

   1 Summary
   2 -------
   3
   4 This is a patch set which adds cross-compilation to the perl
   5 buildsystem.  It was built as a part of the Open Zaurus
   6 (http://www.openzaurus.com/) distribution.  Most / All of the
   7 arm compiler optimisations are "borrowed" from this excellent
   8 project.
   9
  10 The main target is arm-linux but I have also managed to
  11 successfully cross-compile perl for solaris x86 using the same
  12 buildsystem.
  13
  14 We are currently dependent on an existing working local copy of
  15 perl ** of the same version and revision ** which is available
  16 as /usr/bin/perl.  This could be migrated to using native
  17 miniperl with some additional effort.
  18
  19 Obviously you need a working and tested cross-compiler for your
  20 build and target combination.  The binary directory must be in
  21 your path.
  22
  23 1)      You should be reading me (README) in perl-5.x.x/Cross
  24
  25 2)      Make sure you are in the Cross directory.
  26
  27 3)      Edit the file 'config' to contain your target platform information.
  28
  29 4)      make patch      ## This will patch the existing source-tree.
  30 5)      make perl       ## Will make perl
  31
  32 The Obvious Ommissions
  33 ----------------------
  34
  35 This does NOT perform any installation as site installation method will
  36 be dependant on the target arch and OS.
  37
  38 make test will NOT work as the binaries and libraries will not execute.
  39
  40 Due to space limitations on the Zaurus (it's a PDA) we do not provide
  41 documentation in the core - Therefore man pages are not even generated.
  42
  43         Note that the Cross/ directory is also used by a different
  44         cross-compilation setup described in the INSTALL file, and
  45         executed by Configure.  There should be no conflicts since
  46         it is unlikely both that cross-compilation setups are used
  47         simultaneously.
  48
  49 Enjoy!
  50
  51 References
  52 ----------
  53 Redvers Davies <red@criticalintegration.com>
  54 Open Zaurus http://www.openzaurus.org/
  55 Perl OZ Packages http://www.openzaurus.org/official/testing/feed/