home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / perl560.zip / plan9 / perlplan9.pod < prev    next >
Text File  |  1999-07-20  |  3KB  |  88 lines
  1. =head1 NAME
  2.  
  3. perlplan9 - Plan 9-specific documentation for Perl
  4.  
  5. =head1 DESCRIPTION
  6.  
  7. These are a few notes describing features peculiar to
  8. Plan 9 Perl. As such, it is not intended to be a replacement
  9. for the rest of the Perl 5 documentation (which is both 
  10. copious and excellent). If you have any questions to 
  11. which you can't find answers in these man pages, contact 
  12. Luther Huffman at lutherh@stratcom.com and we'll try to 
  13. answer them.
  14.  
  15. =head2 Invoking Perl
  16.  
  17. Perl is invoked from the command line as described in 
  18. L<perl>. Most perl scripts, however, do have a first line 
  19. such as "#!/usr/local/bin/perl". This is known as a shebang 
  20. (shell-bang) statement and tells the OS shell where to find 
  21. the perl interpreter. In Plan 9 Perl this statement should be 
  22. "#!/bin/perl" if you wish to be able to directly invoke the 
  23. script by its name.
  24.      Alternatively, you may invoke perl with the command "Perl"
  25. instead of "perl". This will produce Acme-friendly error
  26. messages of the form "filename:18".
  27.  
  28. Some scripts, usually identified with a *.PL extension, are 
  29. self-configuring and are able to correctly create their own 
  30. shebang path from config information located in Plan 9 
  31. Perl. These you won't need to be worried about.
  32.  
  33. =head2 What's in Plan 9 Perl
  34.  
  35. Although Plan 9 Perl currently only  provides static 
  36. loading, it is built with a number of useful extensions. 
  37. These include Opcode, FileHandle, Fcntl, and POSIX. Expect 
  38. to see others (and DynaLoading!) in the future.
  39.  
  40. =head2 What's not in Plan 9 Perl
  41.  
  42. As mentioned previously, dynamic loading isn't currently 
  43. available nor is MakeMaker. Both are high-priority items.
  44.  
  45. =head2 Perl5 Functions not currently supported
  46.  
  47. Some, such as C<chown> and C<umask> aren't provided 
  48. because the concept does not exist within Plan 9. Others,
  49. such as some of the socket-related functions, simply
  50. haven't been written yet. Many in the latter category 
  51. may be supported in the future.
  52.  
  53. The functions not currently implemented include:
  54.  
  55.     chown, chroot, dbmclose, dbmopen, getsockopt, 
  56.     setsockopt, recvmsg, sendmsg, getnetbyname, 
  57.     getnetbyaddr, getnetent, getprotoent, getservent, 
  58.     sethostent, setnetent, setprotoent, setservent, 
  59.     endservent, endnetent, endprotoent, umask
  60.  
  61. There may be several other functions that have undefined 
  62. behavior so this list shouldn't be considered complete.
  63.  
  64. =head2 Signals
  65.  
  66. For compatibility with perl scripts written for the Unix 
  67. environment, Plan 9 Perl uses the POSIX signal emulation
  68. provided in Plan 9's ANSI POSIX Environment (APE). Signal stacking
  69. isn't supported. The signals provided are:
  70.  
  71.     SIGHUP, SIGINT, SIGQUIT, SIGILL, SIGABRT,
  72.     SIGFPE, SIGKILL, SIGSEGV, SIGPIPE, SIGPIPE, SIGALRM, 
  73.     SIGTERM, SIGUSR1, SIGUSR2, SIGCHLD, SIGCONT,
  74.     SIGSTOP, SIGTSTP, SIGTTIN, SIGTTOU
  75.  
  76. =head1 BUGS
  77.  
  78. "As many as there are grains of sand on all the beaches of the 
  79. world . . ." - Carl Sagan
  80.  
  81. =head1 Revision date
  82.  
  83. This document was revised 09-October-1996 for Perl 5.003_7.
  84.  
  85. =head1 AUTHOR
  86.  
  87. Luther Huffman,    lutherh@stratcom.com
  88.