home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / perl560.zip / plan9 / perlplan9.doc < prev    next >
Text File  |  1999-07-20  |  5KB  |  92 lines

  1.  
  2.      PLAN9/PERLPLAN9(1)   (perl 5.003, patch 05)    PLAN9/PERLPLAN9(1)
  3.  
  4.      NNNNAAAAMMMMEEEE
  5.           perlplan9 - Plan 9-specific documentation for Perl
  6.  
  7.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  8.           These are a few notes describing features peculiar to Plan 9
  9.           Perl. As such, it is not intended to be a replacement for
  10.           the rest of the Perl 5 documentation (which is both copious
  11.           and excellent). If you have any questions to which you can't
  12.           find answers in these man pages, contact Luther Huffman at
  13.           lutherh@stratcom.com and we'll try to answer them.
  14.  
  15.           IIIInnnnvvvvooookkkkiiiinnnngggg PPPPeeeerrrrllll
  16.  
  17.           Perl is invoked from the command line as described in the
  18.           _p_e_r_l manpage. Most perl scripts, however, do have a first
  19.           line such as "#!/usr/local/bin/perl". This is known as a
  20.           shebang (shell-bang) statement and tells the OS shell where
  21.           to find the perl interpreter. In Plan 9 Perl this statement
  22.           should be "#!/bin/perl" if you wish to be able to directly
  23.           invoke the script by its name.
  24.                Alternatively, you may invoke perl with the command
  25.           "Perl" instead of "perl". This will produce Acme-friendly
  26.           error 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 Perl.
  31.           These you won't need to be worried about.
  32.  
  33.           WWWWhhhhaaaatttt''''ssss iiiinnnn PPPPllllaaaannnn 9999 PPPPeeeerrrrllll
  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.           WWWWhhhhaaaatttt''''ssss nnnnooootttt iiiinnnn PPPPllllaaaannnn 9999 PPPPeeeerrrrllll
  41.  
  42.           As mentioned previously, dynamic loading isn't currently
  43.           available nor is MakeMaker. Both are high-priority items.
  44.  
  45.           PPPPeeeerrrrllll5555 FFFFuuuunnnnccccttttiiiioooonnnnssss nnnnooootttt ccccuuuurrrrrrrreeeennnnttttllllyyyy ssssuuuuppppppppoooorrrrtttteeeedddd
  46.  
  47.           Some, such as chown and umask aren't provided because the
  48.           concept does not exist within Plan 9. Others, such as some
  49.           of the socket-related functions, simply haven't been written
  50.           yet. Many in the latter category may be supported in the
  51.           future.
  52.  
  53.           The functions not currently implemented include:
  54.  
  55.      Page 1                      9/Oct/96            (printed 10/9/96)
  56.  
  57.      PLAN9/PERLPLAN9(1)   (perl 5.003, patch 05)    PLAN9/PERLPLAN9(1)
  58.  
  59.               chown, chroot, dbmclose, dbmopen, getsockopt,
  60.               setsockopt, recvmsg, sendmsg, getnetbyname,
  61.               getnetbyaddr, getnetent, getprotoent, getservent,
  62.               sethostent, setnetent, setprotoent, setservent,
  63.               endservent, endnetent, endprotoent, umask
  64.  
  65.           There may be several other functions that have undefined
  66.           behavior so this list shouldn't be considered complete.
  67.  
  68.           SSSSiiiiggggnnnnaaaallllssss
  69.  
  70.           For compatibility with perl scripts written for the Unix
  71.           environment, Plan 9 Perl uses the POSIX signal emulation
  72.           provided in Plan 9's ANSI POSIX Environment (APE). Signal
  73.           stacking isn't supported. The signals provided are:
  74.  
  75.               SIGHUP, SIGINT, SIGQUIT, SIGILL, SIGABRT,
  76.               SIGFPE, SIGKILL, SIGSEGV, SIGPIPE, SIGPIPE, SIGALRM,
  77.               SIGTERM, SIGUSR1, SIGUSR2, SIGCHLD, SIGCONT,
  78.               SIGSTOP, SIGTSTP, SIGTTIN, SIGTTOU
  79.  
  80.      BBBBUUUUGGGGSSSS
  81.           "As many as there are grains of sand on all the beaches of
  82.           the world . . ." - Carl Sagan
  83.  
  84.      RRRReeeevvvviiiissssiiiioooonnnn ddddaaaatttteeee
  85.           This document was revised 09-October-1996 for Perl 5.003_7.
  86.  
  87.      AAAAUUUUTTTTHHHHOOOORRRR
  88.           Luther Huffman,    lutherh@stratcom.com
  89.  
  90.      Page 2                      9/Oct/96            (printed 10/9/96)
  91.  
  92.