perl-aol Code

add some of the reference docs I was given on the irc channel

outline conversion from cvs to git

* trying Brandon O'Dea's perl packages; they work with perl-aol!
* moving where aolserver is installed
* add vars PERLMODDIR and PERLMODLIBDIR which locate these items for the build

* update Aolserver::Ns_DbHandle for aolserver version 4+, which has libnsdb
* small change in how libs and install prefixes are located

* factor do_perl down into several smaller functions incl. messages;
reconstitute do_perl by having it call the factored functions
* small changes to methods by which libs are located

Get rid of inappropriate logging

Fix problem in DbHandle where storing the row set from Ns_DbHandleSelect()
produced "Read only" error as a result of the sv_setsv (which was replaced
with an hv_store; this was the fix.)

Add "does the perl reference own the Ns_DString it points at" flag
variable to Ns_DString objects

Fix a small problem where Ns_DStringMaps.c couldn't see the LOG() macro

Instrumented (using LOG(StringF(...)) calls) NsDbHandleStoreSelectRow
so it lets me know just before and just after the sv_setsv call

some overall cleanup, mostly removing newlines from LOG calls

Stop setting perl infrastructure pointers to null in order to protect
what they point at.

Instead, introduce ownership variable; if true, the perl infrastructure
"owns" the aolserver data structure and should therefore free it;
if false, only free the perl infrastructure, and NOT the aolserver
data.

Also, add warning in case a perl script which is supposed to return
browser content does not; earlier failures to do so caused unbounded
recursion.