home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-dist / perl-5.003-src.tgz / tar.out / fsf / perl / vms / ext / Stdio / 0README.txt next >
Text File  |  1996-09-28  |  2KB  |  48 lines
  1. This directory contains the source code for the Perl extension
  2. VMS::Stdio, which provides access from Perl to VMS-specific
  3. stdio functions.  For more specific documentation of its
  4. function, please see the pod section of Stdio.pm.
  5.  
  6.                        *** Please Note ***
  7.  
  8. This package is the direct descendant of VMS::stdio, but as of Perl
  9. 5.002, the name has been changed to VMS::Stdio, in order to conform
  10. to the Perl naming convention that extensions whose name begins
  11. with a lowercase letter represent compile-time "pragmas", while
  12. extensions which provide added functionality have names whose parts
  13. begin with uppercase letters.  In addition, the functions
  14. vmsfopen and fgetname have been renamed vmsopen and getname,
  15. respectively, in order to more closely resemble related Perl
  16. I/O operators, which do not retain the 'f' from corresponding
  17. C routine names.
  18.  
  19. A transitional interface to the old routine names has been
  20. provided, so that calls to these routines will generate a
  21. warning, and be routed to the corresponding VMS::Stdio
  22. routine.  This interface will be removed in a future release,
  23. so please update your code to use the new names.
  24.  
  25.  
  26. ===> Installation
  27.  
  28. This extension, like most Perl extensions, should be installed
  29. by copying the files in this directory to a location *outside*
  30. the Perl distribution tree, and then saying
  31.  
  32.     $ perl Makefile.PL  ! Build Descrip.MMS for this extension
  33.     $ MMK               ! Build the extension
  34.     $ MMK test          ! Run its regression tests
  35.     $ MMK install       ! Install required files in public Perl tree
  36.  
  37.  
  38. ===> Revision History
  39.  
  40. 1.0  29-Nov-1994  Charles Bailey  bailey@genetics.upenn.edu
  41.      original version - vmsfopen
  42. 1.1  09-Mar-1995  Charles Bailey  bailey@genetics.upenn.edu
  43.      changed calling sequence to return FH/undef - like POSIX::open
  44.      added fgetname and tmpnam
  45. 2.0  28-Feb-1996  Charles Bailey  bailey@genetics.upenn.edu
  46.      major rewrite for Perl 5.002: name changed to VMS::Stdio,
  47.      new functions added, and prototypes incorporated
  48.