home *** CD-ROM | disk | FTP | other *** search
/ Il CD di internet / CD.iso / SOURCE / D / PERL / _PERL.TAR / usr / doc / perl-4.036 / README.1st < prev    next >
Encoding:
Text File  |  1994-07-28  |  4.1 KB  |  115 lines
  1.      Copyright (c) 1994 Louis J. LaBash, Jr. {lou@minuet.siue.edu}
  2.                          Revised 20 Jul 94 -ljl-
  3.  
  4. Purpose:
  5. Facilitate creation of a custom-fitted Perl; unlike a binary distribution
  6. which necessarily must be one-size-fits-all, configured so it can be used
  7. on any system.  Pre-built programs may lack features supported by your 
  8. installation: in situ compilation eliminates any such restrictions.
  9.  
  10. Note: If your already have perl installed, backup all of its files, then
  11. delete them before running 'Configure' (start with a CLEAN slate).  Perl's
  12. 'Configure' snoops around your system and presents defaults based on its
  13. analysis in conjunction with hints in 'linux.sh'.  You'll need > 8M to
  14. compile perl with "-O2" optimization, I used 8M RAM + 4M Swap.
  15.  
  16.  
  17. Manifest:
  18. README.1st    /* this file */
  19. hints/linux.sh    /* Linux hints, used by Perl's Configure: suggest defaults */
  20. perl.udf    /* Smartens Perl's Configure, fixes doio.c, brands 'perl.c',
  21.                  * and removes trailing comment in 'cpp.t'. */
  22. patch-pwd.udf    /* changes all occurrences of `pwd` to `'pwd'` in t subdir */
  23. Info/perl.*    /* Info files for Perl */
  24. perl-4.036-linux-kit.lsm    /* Linux Software Map */
  25.  
  26.  
  27. Quick Start:
  28.     Unpack sources:
  29.     cd /usr/src
  30.     zcat perl-4.036-linux-kit.tar.gz | tar xvf -
  31.     zcat perl-4.036.tar.gz | tar xvf -
  32.     cd perl-4.036
  33.  
  34.     Patching Perl:
  35.     patch <perl.udf
  36.  
  37.     Making Perl:
  38.     make realclean    /* if exist, remove
  39.     rm config.sh     * old stuff */
  40.     sh Configure    /* accept defaults */
  41.     make depend
  42.     make
  43.     make install
  44.     make test
  45.  
  46.     If you don't see the cherished message "All tests successful"
  47.     then see Trouble: (below)
  48.  
  49.     install -m 444  Info/* /usr/info   /*optional, Perl-Info*/
  50.         cd /usr/info
  51.     Edit 'dir' to include the following line:
  52.   * perl:(perl).  Perl Version 4.036 (Practical Extraction & Report Language)
  53.  
  54.  
  55. Trouble:
  56. if 'make test' issues " Can't exec "pwd": No such file or directory ..."
  57.     patch <patch-pwd.udf 
  58.     rerun 'make test'
  59. No errors should be reported, read Perl's README for other help.
  60.  
  61.  
  62. Notes & Hints:
  63. Perl built with this kit has Linux's conventional signal behaviour.
  64. If you require BSD-ish style signals ..., see Mitch DSouza's GCC-FAQ.
  65.  
  66. Larry Wall, creator of Perl, assumed all machines have an external
  67. 'pwd' (aka C-Shell).  Two of his test programs, in the t subdirectory,
  68. use the following Perl syntax: $val=`pwd`.  In Perl, COMMAND SUBSTITUTION
  69. only works for external commands, -normally.  However, shell's internal
  70. commands *can* be used if they are encapsulated in single-quotes, then
  71. placed inside back-quotes; this is what 'patch-pwd.udf' does.  Another
  72. work-around is to use an external 'pwd'.  The following elegant BASH
  73. script was provided by Chet Ramey (chet@odin.ins.cwru.edu):
  74.     #! /bin/bash
  75.     builtin pwd
  76. Create a file named 'pwd' containing the above two lines, make it
  77. executable with 'chmod', and then move it to '/usr/bin'.
  78.  
  79. Another problem, 'cpp.t' has a *trailing-comment* : '#' (sharp) is a
  80. reserved character for the C Pre Processor (cpp) and this isn't allowed.
  81. The 'perl.udf' correct this error as well as another in 'doio.c'.
  82. Some binaries disabled SysV IPC in order to compile perl because of
  83. the bug in 'doio.c'.
  84.  
  85.  
  86. Resource Guide:
  87. Locations having Perl related materials:
  88.     convex.com[130.168.1.1]: /pub/perl/info/faq
  89.     ftp.uu.net [192.48.96.9]: /languages/perl
  90.     (see also) /published/oreilly/nutshell/programming_perl/perl.tar.Z
  91.  
  92.     ftp.cis.ufl.edu [128.227.100.198]: /pub/perl
  93.  
  94. USENET's news group "comp.lang.perl", in digest format, is available on
  95. Internet via mail:
  96.     request-address: almanac@ruby.oce.orst.edu
  97.     body-of-mail   : subscribe perl-users
  98.  
  99. If as a result of this package, or its product; you learned one thing:
  100. I've been rewarded; I have :-).
  101.  
  102. I thank the following for their valuable feedback:
  103. A. V. LeBlanc {LeBlanc@mcc.ac.uk}
  104. Clay Haapala {clay@haapi.mn.org}
  105. Lance Shorb {les@gasco.com}
  106. Richard Soderberg {richard@micb.mic.ki.se}
  107. Warren Smith {warrens@asbestos.lib.rmit.edu.au}
  108. Dimitri Bougoulias {dbougo@leon.nrcps.ariadne-t.gr}
  109. Fritz Heinrichmeyer {fritz.heinrichmeyer@fernuni-hagen.de}
  110.  
  111. Antoinette J. LaBash {mother@heaven.space}
  112.  
  113. Louis-ljl-{lou@minuet.siue.edu}
  114. ---------
  115.