apr-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From wr...@apache.org
Subject svn commit: r800544 - in /apr/apr-util/branches/1.3.x: README README.MySQL
Date Mon, 03 Aug 2009 20:32:25 GMT
Author: wrowe
Date: Mon Aug  3 20:32:25 2009
New Revision: 800544

URL: http://svn.apache.org/viewvc?rev=800544&view=rev
Log:
polish up apr-util readme, merging README.MySQL

Removed:
    apr/apr-util/branches/1.3.x/README.MySQL
Modified:
    apr/apr-util/branches/1.3.x/README

Modified: apr/apr-util/branches/1.3.x/README
URL: http://svn.apache.org/viewvc/apr/apr-util/branches/1.3.x/README?rev=800544&r1=800543&r2=800544&view=diff
==============================================================================
--- apr/apr-util/branches/1.3.x/README (original)
+++ apr/apr-util/branches/1.3.x/README Mon Aug  3 20:32:25 2009
@@ -1,3 +1,79 @@
+Apache Portable Runtime Utility Library README
+----------------------------------------------
+
+   The Apache Portable Runtime Utility Library provides a predictable
+   and consistent interface to underlying client library interfaces.
+   This API assures predictable if not identical behavior regardless
+   of which libraries are available on a given platform.
+
+   APR and its companion libraries are implemented entirely in C
+   and provide a common programming interface across a wide variety
+   of operating system platforms without sacrificing performance.
+   Currently supported platforms include:
+
+     UNIX variants
+     Windows
+     Netware
+     Mac OS X
+     OS/2
+
+   To give a brief overview, the primary core
+   subsystems of APR-util 1.3 include the following:
+
+     Hashing and UUID services
+     Multiple SQL DBD client interfaces
+     Multiple flat-database DBM client interfaces
+     Typesafe function Hooks abstraction
+     LDAP SSL connections for a variety of LDAP toolkits   
+     MemCache interface
+     Date parsing rourtines
+     Resource Lists
+     Thread Pools
+     Queues
+     Relocatable Memory Management functions
+     String filename-style pattern matching
+     URI Parsing
+     Charset translation (iconv based)
+     XML parsing (expat based)
+
+   For a more complete list, please refer to the following URLs:
+
+     http://apr.apache.org/docs/apr-util/modules.html
+
+   Users of APR 0.9 should be aware that migrating to the APR 1.x
+   programming interfaces may require some adjustments; APR 1.x is
+   neither source nor binary compatible with earlier APR 0.9 releases.
+   Users of APR 1.x can expect consistent interfaces and binary backwards
+   compatibility throughout the entire APR 1.x release cycle, as defined
+   in our versioning rules:
+
+     http://apr.apache.org/versioning.html
+
+   APR is already used extensively by the Apache HTTP Server
+   version 2 and the Subversion revision control system, to
+   name but a few.  We list all known projects using APR at
+   http://apr.apache.org/projects.html -- so please let us know
+   if you find our libraries useful in your own projects!
+
+
+Database Providers
+------------------
+As of apr-util version 1.2.11, MySQL DBD driver is shipped as part of the
+distribution.  However, to avoid licensing incompatibilities, it is not
+built by default.  To enable MySQL support, use the --with-mysql option,
+but be aware that the MySQL license may introduce licensing implications
+for your compiled code.  Similarly, the bindings for propritary drivers
+such as Oracle (--with-oracle option) must also be explicitly enabled.
+
+On windows, selection of supported drivers is via the environment values
+DBD_LIST (for freetds, mysql, oracle, pgsql, sqlite2 and/or sqlite3) 
+and DBM_LIST (db and/or gdbm).  DBD odbc and DBM sdbm are unconditionally
+compiled and installed, do not include these in the list.
+
+Whenever distributing apr-util in combination with database client 
+drivers, always review the license requirements of all components.
+
+
 Cryptographic Software Notice
 -----------------------------
 This distribution includes cryptographic software.  The country in 
@@ -23,7 +99,7 @@
 software:
 
   APR-Util provides an abstract interface for SSL encrypted LDAP (ldaps
-  and STARTTLS style) connections, which can be powered by OpenLDAP,
+  and STARTTLS style) connections, which can be powered by OpenLDAP, 
   Netscape LDAP SDK, Mozilla LDAP SDK, or other platform specific ldap
   interfaces.
 



Mime
View raw message