home *** CD-ROM | disk | FTP | other *** search
/ PC World 2003 March / PCWorld_2003-03_cd.bin / Software / Topware / activeperl / ActivePerl / Perl / lib / Pod / perluts.pod < prev    next >
Encoding:
Text File  |  2001-07-16  |  3.2 KB  |  108 lines
  1. If you read this file _as_is_, just ignore the funny characters you
  2. see. It is written in the POD format (see perlpod manpage) which is
  3. specially designed to be readable as is.
  4.  
  5. =head1 NAME
  6.  
  7. perluts - Perl under UTS
  8.  
  9. =head1 SYNOPSIS
  10.  
  11. This document can be read I<as is>: as F<README.uts>, or you
  12. can read it after you build your package using "man perluts".
  13.  
  14. The purpose is to help you build Perl for UTS, which, if you
  15. follow these instructions, should be easy, and result in
  16. a solidly working installation.
  17.  
  18. =head1 DESCRIPTION
  19.  
  20. Perl 5.7.2 (Developmental) or Perl 5.8.x (forthcoming) for UTS
  21.  
  22. =head1 BUILDING PERL ON UTS
  23.  
  24. NOTE: Some sites have redefined the way uname works, and if yours
  25. does this, special steps must be taken so that Configure can
  26. recognize your system as a UTS system.  To see if you are in
  27. this category, issue the command "uname -a".  It should look
  28. something like:
  29.  
  30.   uts juno 4 4.4 9672 370
  31.  
  32. At any rate, the first field should be "uts".  If this is not
  33. the case; supposing it is, say telcoUTS, create a script, uts/uname
  34. (i.e. uname, in the subdirectory "uts" of the main Perl source dir):
  35.    # uname
  36.    /usr/bin/uname "$@" | sed -e 's/^telcoUTS/uts/'
  37.  
  38. and when you execute Configure, do it as below, except for adding
  39. PATH=uts:$PATH as a prefix.  I.e. do:
  40.  
  41.    PATH=uts:$PATH ./Configure ...
  42.  
  43. There is no need to do an interactive configure, just type
  44.  
  45.   ./Configure -de [-Dusedevel] [-Doptimize=-g ] 2>&1 | tee Conf.out
  46.  
  47. "-Dusedevel" may be required to configure Perl 5.7.2 non-interactively.
  48. Use -Doptimize=-g if you want to run Perl under sdb or gdb, OR
  49. if you want to be able to use the -D command line flags to perl,
  50. which are occasionally useful in debugging perl scripts.
  51.  
  52. In this and the following steps, the "2>&1 | tee XXX.out" records all
  53. output from the process, which will be useful if anything unexpected
  54. goes wrong.
  55.  
  56. Then do the compilation with
  57.  
  58.   make 2>&1 | tee make.out
  59.  
  60. Finally, test using
  61.  
  62.   make test 2>&1 | tee make-test.out
  63.  
  64. In the output, the only failures you should see should look like:
  65.  
  66.    lib/Math/BigInt/t/bigfltpm.........Use of uninitialized value ...
  67.    FAILED at test 57
  68.    lib/Math/BigInt/t/bigintc..........ok
  69.    lib/Math/BigInt/t/bigintpm.........FAILED at test 204
  70.    lib/Math/BigInt/t/mbimbf...........Use of uninitialized value ...
  71.    Illegal division by zero at ../lib/Math/BigInt/Calc.pm line 314.
  72.    FAILED at test 71
  73.    lib/Math/Complex...................exp: OVERFLOW
  74.    FAILED at test 250
  75.    lib/Math/Trig......................exp: OVERFLOW
  76.    ok
  77.    lib/Memoize/t/array................ok
  78.        ...
  79.    lib/Net/protoent...................ok
  80.    lib/Net/servent....................FAILED at test 0
  81.  
  82. This means that everything passes except for some problems in the
  83. packages "Math::BigInt", "Math::Complex", and "Math::Trig".
  84. The lib/Net/servent failure seems to be a bug in the test
  85. program.  To confirm this, from the main Perl source dir, do:
  86.  
  87.    LD_LIBRARY_PATH=`pwd` ./perl -Ilib lib/Net/servent.t
  88.  
  89. and it should output
  90.  
  91.    1..3
  92.    ok 1
  93.    ok 2
  94.    ok 3
  95.  
  96. =head1 Installing the built perl on UTS
  97.  
  98. Run the command "make install"
  99.  
  100. =head1 AUTHOR
  101.  
  102.    Hal Morris
  103.    UTS Global LLC
  104.    email: hom00@utsglobal.com
  105.  
  106. =cut
  107.  
  108.