updated docs

CHANGELOG

@@ -1,7 +1,7 @@
 This is the changelog file for the POCO C++ Libraries.
 
 
-Release 1.5.0 (2012-10-11)
+Release 1.5.0 (2012-10-14)
 ==========================
 
 - added JSON library

Data/doc/00200-DataUserManual.page

@@ -51,7 +51,7 @@ The following complete example shows how to use POCO Data:
         };
         
         Statement insert(session);
-        insert << "INSERT INTO Person VALUES(:name, :address, :age)",
+        insert << "INSERT INTO Person VALUES(?, ?, ?)",
             use(person.name),
             use(person.address),
             use(person.age);
@@ -112,14 +112,18 @@ Sessions are created via the Session constructor:
 ----
 
 The first parameter contains the type of the Session one wants to create.
-Currently, supported bac-ends are "SQLite", "ODBC" and "MySQL". The second
+Currently, supported backends are "SQLite", "ODBC" and "MySQL". The second
-parameter contains the initialization string.
+parameter contains the connection string.
 
-In the case of SQLite, the location of the database file is sufficient.
+In the case of SQLite, the path of the database file is sufficient as connection string.
-For ODBC, the connection string is required. Connection string may be
+
-simple "DSN=MyDSNName" when a DSN is configured or a complete connection
+For ODBC, the connection string may be a simple "DSN=MyDSNName" when a DSN is configured or 
-string defining all the necessary connection parameters (for details,
+a complete ODBC driver-specific connection string defining all the necessary connection parameters 
-consult your ODBC driver documentation).
+(for details, consult your ODBC driver documentation). 
+
+For MySQL, the connection string is a semicolon-delimited list of name-value pairs 
+specifying various parameters like host, port, user, password, database, compression and 
+automatic reconnect. Example: <["host=localhost;port=3306;db=mydb;user=alice;password=s3cr3t;compress=true;auto-reconnect=true"]>
 
 
 !!!Inserting and Retrieving Data
@@ -508,7 +512,7 @@ later during execution. Thus, one should never pass temporaries to <[use()]>:
     stmt.execute(); // oops!
 ----
 
-It is possible to use bind() instead of use(). The bind() call will always create a
+It is possible to use <[bind()]> instead of <[use()]>. The <[bind()]> call will always create a
 copy of the supplied argument. Also, it is possible to execute a statement returning 
 data without supplying the storage and have the statement itself store the returned
 data for later retrieval through <[RecordSet]>. For details, see <[RecordSet]> chapter.

doc/99100-ReleaseNotes.page

@@ -1,6 +1,63 @@
 POCO C++ Libraries Release Notes
 AAAIntroduction
 
+!!!Release 1.5.0
+
+!!Summary of Changes
+
+  - added JSON library
+  - added Util::JSONConfiguration
+  - added FIFOBuffer and FIFOBufferStream
+  - fixed SF# 3522906: Unregistering handlers from SocketReactor
+  - fixed SF# 3522084: AbstractConfiguration does not support 64-bit integers
+  - HTTPServer::stopAll(): close the socket instead of just shutting it down, as the latter won't wake up a select() on Windows
+  - added SMTPLogger
+  - added cmake support
+  - fixed SF#3538778: NetworkInterface enumeration uses deprecated API
+  - fixed SF#3538779: IPAddress lacks useful constructors: from prefix mask, native SOCKADDR
+  - fixed SF#3538780: SocketAddress needs operator < function
+  - fixed SF#3538775: Issues building on Fedora/Centos, etc. for AMD64
+  - fixed SF#3538786: Use size_t for describing data-blocks in DigestEngine
+  - added IPAddress bitwise operators (&,|,^,~)
+  - added IPAddress BinaryReader/Writer << and >> operators
+  - modified IPAddress to force IPv6 to lowercase (RFC 5952)
+  - fixed SF#3538785: SMTPClientSession::sendMessage() should take recipient list 
+  - added IPAddress::prefixLength()
+  - UTF portability improvements
+  - fixed SF#3556186: Linux shouldn't use <net/if.h> in Net/SocketDefs.h
+  - added IPAddress RFC 4291 compatible site-local prefix support
+  - fixed SF#3012166: IPv6 patch
+  - added SF#3558085: Add formatter to MACAddress object
+  - fixed SF#3552774: Don't hide default target in subordinate makefile
+  - fixed SF#3534307: Building IPv6 for Linux by default
+  - fixed SF#3516844: poco missing symbols with external >=lipcre-8.13 
+  - added SF#3544720: AbstractConfigurator to support 64bit values
+  - fixed SF#3522081: WinRegistryConfiguration unable to read REG_QWORD values
+  - fixed SF#3563626: For Win32 set Up/Running flags on NetworkInterface
+  - fixed SF#3560807: Deprecate setPeerAddress() as this is now done in getifaddrs
+  - fixed SF#3560776: Fix byte-ordering issues with INADDR_* literals
+  - fixed SF#3563627: Set IP address on multicast socket from socket family
+  - fixed SF#3563999: Size BinaryWriter based on buffer's capacity(), not size()
+  - fixed SF#102 Fix building Poco on Debian GNU/FreeBSD
+  - fixed SF#321 Binding DatTime or Timestamp
+  - fixed SF#307 Detect the SQL driver type at run time
+  - added VS 2012 Projects/Solutions
+  - enhanced and accelerated numeric parsing for integers and floats
+  - fixed SF#590 Segfault on FreeBSD when stack size not rounded
+  - added warn function and warnmsg macro in CppUnit
+  - fixed SF# 3558012 Compilation fails when building with -ansi or -std=c++0x
+  - fixed SF# 3563517 Get rid of loss-of-precision warnings on x64 MacOS
+  - fixed SF#3562244: Portability fix for AF_LINK
+  - fixed SF #3562400: DatagramSocketImpl comment is incorrect
+
+!!Incompatible Changes and Possible Transition Issues
+
+  - Keywords for the Data library (now, use, into, etc.) now reside in Poco::Data::Keywords namespace.
+  - Please note that 1.5 releases are development releases and not considered stable. Interfaces may
+    change, and backwards compatibility with the stable 1.4 release series
+    is not guaranteed. The next stable release incorporating 1.5 features will be release 1.6. 
+
+
 !!!Release 1.4.4
 
 !!Summary of Changes