diff -ruN adodb5.orig/fink/patches/01_fix_broken_html_doc_links adodb5/fink/patches/01_fix_broken_html_doc_links --- adodb5.orig/fink/patches/01_fix_broken_html_doc_links 1969-12-31 17:00:00.000000000 -0700 +++ adodb5/fink/patches/01_fix_broken_html_doc_links 2012-07-24 15:21:30.000000000 -0600 @@ -0,0 +1,184 @@ +## Clean up all the failed and moved links in the documentation. +--- libphp-adodb.orig/docs/docs-adodb.htm ++++ libphp-adodb/docs/docs-adodb.htm +@@ -835,12 +835,12 @@ + of ADOdb. +
  • PHAkt: PHP Extension for DreamWeaver ++ href="http://www.interaktonline.com/Products/Free-Products/PHAkt/EOL/">PHAkt: PHP Extension for DreamWeaver + Ultradev allows you to script PHP in the popular Web page editor. + Database handling provided by ADOdb.
  • +
  • Analysis ++ href="http://www.andrew.cmu.edu/user/rdanyliw/snort/snortacid.html">Analysis + Console for Intrusion Databases (ACID): PHP-based analysis engine to + search and process a database of security incidents generated by + security-related software such as IDSes and firewalls (e.g. Snort, +@@ -853,13 +853,13 @@ + and is fully multi-lingual enabled.
  • +
  • EasyPublish ++ href="http://www.escio.no/index.php?page_id=3&lang_id=2">EasyPublish + CMS is another free content management system for managing information + and integrated modules on your internet, intranet- and extranet-sites. + From Norway.
  • +
  • NOLA is a full featured accounting, ++ href="http://www.nolapro.com/nolapro.html">NOLA is a full featured accounting, + inventory, and job tracking application. It is licensed under the GPL, and + developed by Noguska.
  • + +@@ -1987,7 +1987,7 @@ +

    Unix and Windows.
    + Unix install + howto and another ++ href="http://www.linuxjournal.com/article/6636">another + one.

    + + +@@ -3547,7 +3547,7 @@ + +

    Since ADOdb 2.30, we support the generation of SQL to create pivot tables, + also known as cross-tabulations. For further explanation read this DevShed Cross-Tabulation tutorial. ++href="http://www.devshed.com/c/a/MySQL/MySQL-wizardry/1/">Cross-Tabulation tutorial. + We assume that your database supports the SQL case-when expression.

    + +

    In this example, we will use the Northwind database from Microsoft. In the +@@ -4288,7 +4288,7 @@ + ".$ADODB_CACHE_DIR." -name adodb_*.cache`");

    + +

    For general cleanup of all expired files, you should use crontab on Unix, ++href="http://www.adminschoice.com/docs/crontab.htm">crontab on Unix, + or at.exe on Windows, and a shell script similar to the following:
    + #------------------------------------------------------
    +@@ -4788,7 +4788,7 @@ + Oracle, + MySQL, +-and MS SQL Server. ++and MS SQL Server. +

    + +

    GetAssoc($sql,$inputarr=false,$force_array=false,$first2cols=false)

    +--- libphp-adodb.orig/docs/docs-oracle.htm ++++ libphp-adodb/docs/docs-oracle.htm +@@ -35,7 +35,7 @@ +
  • ADOdb library
  • + +

    The wide range of choices is confusing to someone just starting with Oracle and PHP. I will briefly summarize the differences, and show you the advantages of using ADOdb.

    +-

    First we have the C extensions which provide low-level access to Oracle functionality. These C extensions are precompiled into PHP, or linked in dynamically when the web server starts up. Just in case you need it, here's a guide to installing Oracle and PHP on Linux.

    ++

    First we have the C extensions which provide low-level access to Oracle functionality. These C extensions are precompiled into PHP, or linked in dynamically when the web server starts up. Just in case you need it, here's a guide to installing Oracle and PHP on Linux.

    + + + +@@ -457,9 +457,9 @@ + $db->Execute("insert into atable (f1, f2) values (?,?)", array(12, 'abc')); +

      +

    9. Connecting to Oracle

    +-

    Before you can use ADOdb, you need to have the Oracle client installed and setup the oci8 extension. This extension comes pre-compiled for Windows (but you still need to enable it in the php.ini file). For information on compiling the oci8 extension for PHP and Apache on Unix, there is an excellent guide at oracle.com.

    ++

    Before you can use ADOdb, you need to have the Oracle client installed and setup the oci8 extension. This extension comes pre-compiled for Windows (but you still need to enable it in the php.ini file). For information on compiling the oci8 extension for PHP and Apache on Unix, there is an excellent guide at oracle.com.

    +

    Should You Use Persistent Connections

    +-

    One question that is frequently asked is should you use persistent connections to Oracle. Persistent connections allow PHP to recycle existing connections, reusing them after the previous web pages have completed. Non-persistent connections close automatically after the web page has completed. Persistent connections are faster because the cost of reconnecting is expensive, but there is additional resource overhead. As an alternative, Oracle allows you to pool and reuse server processes; this is called Shared Server (also known as MTS).

    ++

    One question that is frequently asked is should you use persistent connections to Oracle. Persistent connections allow PHP to recycle existing connections, reusing them after the previous web pages have completed. Non-persistent connections close automatically after the web page has completed. Persistent connections are faster because the cost of reconnecting is expensive, but there is additional resource overhead. As an alternative, Oracle allows you to pool and reuse server processes; this is called Shared Server (also known as MTS).

    +

    The author's benchmarks suggest that using non-persistent connections and the Shared Server configuration offer the best performance. If Shared Server is not an option, only then consider using persistent connections.

    +

    Connection Examples

    +

    Just in case you are having problems connecting to Oracle, here are some examples:

    +@@ -534,7 +534,7 @@ + +--- libphp-adodb.orig/docs/docs-perf.htm ++++ libphp-adodb/docs/docs-perf.htm +@@ -110,7 +110,7 @@ +
    Oracle extension
    + + +- +@@ -370,7 +370,7 @@ + + + + + +--- libphp-adodb.orig/docs/docs-session.htm ++++ libphp-adodb/docs/docs-session.htm +@@ -299,7 +299,7 @@ +

    Session Cookie Regeneration: adodb_session_regenerate_id()

    +

    Dynamically change the current session id with a newly generated one and update + database. Currently only works with cookies. Useful to improve security by +- reducing the risk of session-hijacking. See this article on Session ++ reducing the risk of session-hijacking. See this article on Session + Fixation for more info + on the theory behind this feature. Usage:

    + 	include('path/to/adodb/session/adodb-session2.php');
    +--- libphp-adodb.orig/docs/docs-session.old.htm
    ++++ libphp-adodb/docs/docs-session.old.htm
    +@@ -279,7 +279,7 @@
    + 

    adodb_session_regenerate_id()

    +

    Dynamically change the current session id with a newly generated one and update database. Currently only + works with cookies. Useful to improve security by reducing the risk of session-hijacking. +-See this article on Session Fixation for more info ++See this article on Session Fixation for more info + on the theory behind this feature. Usage: +

    + 	$ADODB_SESSION_DRIVER='mysql';
    +--- libphp-adodb.orig/docs/tips_portable_sql.htm
    ++++ libphp-adodb/docs/tips_portable_sql.htm
    +@@ -358,7 +358,7 @@
    + sound principles. Learn the theory of normalization and entity-relationship diagrams and model 
    + your data carefully. Understand how joins and indexes work and how they are used to tune performance.
    + 

    Visit the following page for more references on database theory and vendors: +- http://php.weblogs.com/sql_tutorial. ++ http://phplens.com/lens/adodb/tips_portable_sql.htm. + Also read this article on Optimizing PHP. +

    + (c) 2002-2003 John Lim. +--- libphp-adodb.orig/docs/tute.htm ++++ libphp-adodb/docs/tute.htm +@@ -41,7 +41,7 @@ +

    ADODB stands for Active Data Objects DataBase (sorry computer guys are sometimes + not very original). ADODB currently supports MySQL, PostgreSQL, Oracle, Interbase, + Microsoft SQL Server, Access, FoxPro, Sybase, ODBC and ADO. You can download +- ADODB from http://php.weblogs.com/adodb. ++ ADODB from http://adodb.sourceforge.net. +

    MySQL Example

    +

    The most common database used with PHP is MySQL, so I guess you should be familiar + with the following code. It connects to a MySQL server at localhost, +@@ -160,7 +160,7 @@ + $conn->PConnect('localhost','userid','password','database'); + $rs = $conn->Execute('select * from table'); + rs2html($rs); /* recordset to html table */

    +-

    There are many other helper functions that are listed in the documentation available at http://php.weblogs.com/adodb_manual. ++

    There are many other helper functions that are listed in the documentation available at http://phplens.com/adodb/. +

    Advanced Material

    +

    Inserts and Updates

    +

    Let's say you want to insert the following data into a database. +@@ -228,7 +228,7 @@ +

    PHP4 Session Handler Support +

    ADODB also supports PHP4 session handlers. You can store your session variables + in a database for true scalability using ADODB. For further information, visit +- http://php.weblogs.com/adodb-sessions ++ http://phplens.com/lens/adodb/docs-session.htm +

    Commercial Use Encouraged

    +

    If you plan to write commercial PHP applications that you want to resell, you should consider ADODB. It has been released using the lesser GPL, which means you can legally include it in commercial applications, while keeping your code proprietary. Commercial use of ADODB is strongly encouraged! We are using it internally for this reason.

    +

    ADOdb ++ ADOdb + Performance Monitor for localhost, db=test
    + PostgreSQL 7.3.2 on i686-pc-cygwin, compiled by + GCC gcc (GCC) 3.2 20020927 (prerelease)
    data cache buffers250   See tuning ++ href="http://www-128.ibm.com/developerworks/db2/library/techarticle/anshum/0107anshum.html#bufferpoolsize">tuning + reference.