more pod patches

[perl5.git] / plan9 / perlplan9.doc

     PLAN9/PERLPLAN9(1)   (perl 5.003, patch 05)    PLAN9/PERLPLAN9(1)

     N\bN\bN\bNA\bA\bA\bAM\bM\bM\bME\bE\bE\bE
          perlplan9 - Plan 9-specific documentation for Perl

     D\bD\bD\bDE\bE\bE\bES\bS\bS\bSC\bC\bC\bCR\bR\bR\bRI\bI\bI\bIP\bP\bP\bPT\bT\bT\bTI\bI\bI\bIO\bO\bO\bON\bN\bN\bN
          These are a few notes describing features peculiar to Plan 9
          Perl. As such, it is not intended to be a replacement for
          the rest of the Perl 5 documentation (which is both copious
          and excellent). If you have any questions to which you can't
          find answers in these man pages, contact Luther Huffman at
          lutherh@stratcom.com and we'll try to answer them.

          I\bI\bI\bIn\bn\bn\bnv\bv\bv\bvo\bo\bo\bok\bk\bk\bki\bi\bi\bin\bn\bn\bng\bg\bg\bg P\bP\bP\bPe\be\be\ber\br\br\brl\bl\bl\bl

          Perl is invoked from the command line as described in the
          _\bp_\be_\br_\bl manpage. Most perl scripts, however, do have a first
          line such as "#!/usr/local/bin/perl". This is known as a
          shebang (shell-bang) statement and tells the OS shell where
          to find the perl interpreter. In Plan 9 Perl this statement
          should be "#!/bin/perl" if you wish to be able to directly
          invoke the script by its name.
               Alternatively, you may invoke perl with the command
          "Perl" instead of "perl". This will produce Acme-friendly
          error messages of the form "filename:18".

          Some scripts, usually identified with a *.PL extension, are
          self-configuring and are able to correctly create their own
          shebang path from config information located in Plan 9 Perl.
          These you won't need to be worried about.

          W\bW\bW\bWh\bh\bh\bha\ba\ba\bat\bt\bt\bt'\b'\b'\b's\bs\bs\bs i\bi\bi\bin\bn\bn\bn P\bP\bP\bPl\bl\bl\bla\ba\ba\ban\bn\bn\bn 9\b9\b9\b9 P\bP\bP\bPe\be\be\ber\br\br\brl\bl\bl\bl

          Although Plan 9 Perl currently only  provides static
          loading, it is built with a number of useful extensions.
          These include Opcode, FileHandle, Fcntl, and POSIX. Expect
          to see others (and DynaLoading!) in the future.

          W\bW\bW\bWh\bh\bh\bha\ba\ba\bat\bt\bt\bt'\b'\b'\b's\bs\bs\bs n\bn\bn\bno\bo\bo\bot\bt\bt\bt i\bi\bi\bin\bn\bn\bn P\bP\bP\bPl\bl\bl\bla\ba\ba\ban\bn\bn\bn 9\b9\b9\b9 P\bP\bP\bPe\be\be\ber\br\br\brl\bl\bl\bl

          As mentioned previously, dynamic loading isn't currently
          available nor is MakeMaker. Both are high-priority items.

          P\bP\bP\bPe\be\be\ber\br\br\brl\bl\bl\bl5\b5\b5\b5 F\bF\bF\bFu\bu\bu\bun\bn\bn\bnc\bc\bc\bct\bt\bt\bti\bi\bi\bio\bo\bo\bon\bn\bn\bns\bs\bs\bs n\bn\bn\bno\bo\bo\bot\bt\bt\bt c\bc\bc\bcu\bu\bu\bur\br\br\brr\br\br\bre\be\be\ben\bn\bn\bnt\bt\bt\btl\bl\bl\bly\by\by\by s\bs\bs\bsu\bu\bu\bup\bp\bp\bpp\bp\bp\bpo\bo\bo\bor\br\br\brt\bt\bt\bte\be\be\bed\bd\bd\bd

          Some, such as chown and umask aren't provided because the
          concept does not exist within Plan 9. Others, such as some
          of the socket-related functions, simply haven't been written
          yet. Many in the latter category may be supported in the
          future.

          The functions not currently implemented include:

     Page 1                      9/Oct/96            (printed 10/9/96)

     PLAN9/PERLPLAN9(1)   (perl 5.003, patch 05)    PLAN9/PERLPLAN9(1)

              chown, chroot, dbmclose, dbmopen, getsockopt,
              setsockopt, recvmsg, sendmsg, getnetbyname,
              getnetbyaddr, getnetent, getprotoent, getservent,
              sethostent, setnetent, setprotoent, setservent,
              endservent, endnetent, endprotoent, umask

          There may be several other functions that have undefined
          behavior so this list shouldn't be considered complete.

          S\bS\bS\bSi\bi\bi\big\bg\bg\bgn\bn\bn\bna\ba\ba\bal\bl\bl\bls\bs\bs\bs

          For compatibility with perl scripts written for the Unix
          environment, Plan 9 Perl uses the POSIX signal emulation
          provided in Plan 9's ANSI POSIX Environment (APE). Signal
          stacking isn't supported. The signals provided are:

              SIGHUP, SIGINT, SIGQUIT, SIGILL, SIGABRT,
              SIGFPE, SIGKILL, SIGSEGV, SIGPIPE, SIGPIPE, SIGALRM,
              SIGTERM, SIGUSR1, SIGUSR2, SIGCHLD, SIGCONT,
              SIGSTOP, SIGTSTP, SIGTTIN, SIGTTOU

     B\bB\bB\bBU\bU\bU\bUG\bG\bG\bGS\bS\bS\bS
          "As many as there are grains of sand on all the beaches of
          the world . . ." - Carl Sagan

     R\bR\bR\bRe\be\be\bev\bv\bv\bvi\bi\bi\bis\bs\bs\bsi\bi\bi\bio\bo\bo\bon\bn\bn\bn d\bd\bd\bda\ba\ba\bat\bt\bt\bte\be\be\be
          This document was revised 09-October-1996 for Perl 5.003_7.

     A\bA\bA\bAU\bU\bU\bUT\bT\bT\bTH\bH\bH\bHO\bO\bO\bOR\bR\bR\bR
          Luther Huffman,    lutherh@stratcom.com

     Page 2                      9/Oct/96            (printed 10/9/96)