ignore dist dirs and MYMETA.*
[catagits/fcgi2.git] / perl / README
index 2b4f8eb..50d96ee 100644 (file)
@@ -1,4 +1,4 @@
-$Id: README,v 1.3 2000/04/09 19:00:12 skimo Exp $
+$Id: README,v 1.7 2001/10/04 08:08:34 skimo Exp $
 
     Copyright (c) 1996 Open Market, Inc.
     See the file "LICENSE.TERMS" for information on usage and redistribution
@@ -12,14 +12,13 @@ that comes with Open Market's FastCGI Developer's Kit, but does
 not require you to recompile perl.
 
 It even no longer requires perl to be compiled with sfio.
-The sfio version has had more testing though.
 To compile with sfio you'll need at least perl 5.003_02 and you'll have
 to have configured it with eg './Configure -Duseperlio -Dusesfio'.
 (See the INSTALL file that comes with the perl distribution.)
 To compile without sfio you'll need an even more recent perl version.
 (perl 5.004 and up should be fine.)
 
-See http://fastcgi.idle.com/ for more information about fastcgi.
+See http://www.fastcgi.com/ for more information about fastcgi.
 Lincoln D. Stein's perl CGI module also contains some information
 about fastcgi programming.
 
@@ -31,9 +30,21 @@ perl Makefile.PL
 make
 make install
 
-If Makefile.PL finds an already installed (exported) fcgi library
-it will use that instead of the included files. Edit Makefile.PL
-if you don't want that or if it doesn't find them.
+If you want to use the (experimental) pure perl version, that
+doesn't require a compiler and currently only works on Unix,
+you have to pass the --pure-perl option as in
+"perl Makefile.PL --pure-perl".
+
+Note that the pure version does not support Window's Named Pipes.
+Support for Named Pipes is not a requirement of the FastCGI specification.
+Named Pipes are used by mod_fastcgi and the FastCGI application library as a
+replacement for Unix sockets.  mod_fastcgi uses Named Pipes on Windows (Unix
+sockets on Unix) by default (see the mod_fastcgi docs for more information).
+
+If you want the module to use a previously installed fcgi library
+instead of the included files, use the --use-installed option,
+optionally followed by the name of the directory in which it can 
+be found.
 
 To configure the library Makefile.PL will run ./configure .
 You may want to run it yourself beforehand because its findings