home *** CD-ROM | disk | FTP | other *** search
/ Dream 52 / Amiga_Dream_52.iso / RiscOS / APP / DEVS / PERL / RPC106.ZIP / Rpc106 / ReadMe
Text File  |  1998-03-09  |  6KB  |  117 lines
  1. ****************************************************************************
  2. *                                       *
  3. *                        Perl                   *
  4. *          Practical Extraction and Report Language           *
  5. *                  Version  5.004_04                   *
  6. *                  RISC OS port 1.06                   *
  7. *                   RiscPC  Archive                   *
  8. *                                       *
  9. ****************************************************************************
  10.  
  11.                  NO WARRANTY
  12.  
  13.      BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
  14. FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
  15. OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
  16. PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
  17. OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  18. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
  19. TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
  20. PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
  21. REPAIR OR CORRECTION.
  22.  
  23.      IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
  24. WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
  25. REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
  26. INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
  27. OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
  28. TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
  29. YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
  30. PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
  31. POSSIBILITY OF SUCH DAMAGES.
  32.  
  33.  
  34.  
  35. Perl is a language optimized for scanning arbitrary text files, extracting
  36. information from those text files, and printing reports based on that
  37. information. It's also a good language for many system management tasks.
  38. The language is intended to be practical (easy to use, efficient, complete)
  39. rather than beautiful (tiny, elegant, minimal).
  40.  
  41.         This is a staticly linked perl for a Risc PC
  42.           (Risc PCs, A7000s and Network Computers)
  43.  
  44. This archive contains a !Perl application, a !System folder containing two
  45. support modules and a Docs directory containing perl documentation in text
  46. format.
  47.  
  48. Merge the !System in this archive with your existing !System, either by
  49. Risc PC:    Double click on !Boot to run configure.
  50.         The "Configuration" window will open
  51.         Click on the "System" icon - a "System" window will open
  52.         Drag this archive's !System to the window
  53.         Close all the windows - the job is done
  54. Archimedes:    Drag this archive's !System to the directory containing your
  55.         copy of !System (usually the root directory of your hard
  56.         disc). This will update your copy of system
  57.  
  58. This will copy gdbm 0.03 (the Gnu database manager) and CallASWI into your
  59. !System, where perl will be able to find them.
  60.  
  61. *IF YOU HAVE USED A PREVIOUS PERL PORT* note that this perl defaults to
  62. "Unix style" filenames. (consistent with perl ports to other OSes)
  63. To *TURN OFF* automatic filename conversion
  64.  
  65.     use RiscOS::Filespec;
  66.  
  67. at the start of your script (or invoke perl as perl -MRiscOS::Filespec)
  68.  
  69. As well as documentation on this port and the RISC OS libraries, the Docs
  70. directory contains the basic documentation from the perl distribution as
  71. text files. The full documentation and FAQ is available in various formats
  72. (text, HTML, ddf, Impression documents) from the same site as this archive,
  73. or ftp://www.unfortu.net/pub/flirble/users/nick/P/
  74.  
  75. Perl documentation as HTML is avaiable online from a local site via
  76. http://www.perl.com/CPAN/doc/manual/html/
  77.  
  78.  
  79. The !Perl application in this archive contains a perl binary with staticly
  80. linked extensions (including socket support), standard perl libraries
  81. (providing many useful functions), and some RISC OS libraries providing
  82. RISC OS specific functions and perl-like interfaces to RISC OS system calls.
  83. When first seen by the filer !Perl will set an icon for perl files,
  84. initialise some variables needed by the perl binary, add the directory
  85. containing the perl binary to your Run$Path, and set a run-type for perl
  86. files so that double-clicking will run perl.
  87.  
  88. Running the !Perl application will also open the directory, set the
  89. WimpSlot "next" to 1024K, and change directory to the !Perl directory.
  90.  
  91. You may wish to copy the perl binary to a library directory where you keep
  92. other command line programs (such as compilers). If so, you should ensure
  93. that the actions performed by the !Boot file inside !Perl occur when you
  94. start your machine, so that perl can find its libraries. This can be done by
  95. placing !Perl in the !Boot.Choices.Boot.Tasks directory on a Risc PC, or by
  96. placing !Perl in a directory that is "seen" when your machine starts (ie a
  97. directory where you keep your common applications).
  98.  
  99.  
  100. UnixLib malloc (the memory allocator) cannot increase an application's
  101. WimpSlot size once perl is running. However, it does allow perl to use a
  102. dynamic area instead, which allows perl to claim (and release!) memory
  103. whilst running. However, as code cannot be run from a dynamic area this
  104. prevents the use of dynamic linking, so this perl binary is supplied with
  105. all extensions staticly linked, which gives theáperl binary full
  106. functionality at the expense of making it slightly larger. Because of this
  107. it is most suitable for use with Risc PCs (A7000s and Network Computers).
  108. An archive containing a statically linked perl binary is available from the
  109. same site as this archive, which is more suited to use on an A-Series machine
  110. (A300s, A400s, A3000s, A4000s, A5000s and A4s).
  111.  
  112. Perl may be copied subject to the conditions of the "Artistic License"
  113. which you will find in the file "Artistic".
  114.  
  115. The perl source code and utilities needed to remake perl from scratch are
  116. available from the same site as this archive.
  117.