[Informixdb-cvs] SF.net SVN: informixdb: [175] trunk/informixdb

[<ch...@us...>]

Revision: 175
          http://informixdb.svn.sourceforge.net/informixdb/?rev=175&view=rev
Author:   chaese
Date:     2007-10-15 20:26:29 -0700 (Mon, 15 Oct 2007)

Log Message:
-----------
document new features, set release date

Modified Paths:
--------------
    trunk/informixdb/README
    trunk/informixdb/doc/manual.txt

Modified: trunk/informixdb/README
===================================================================
--- trunk/informixdb/README	2007-10-16 03:08:54 UTC (rev 174)
+++ trunk/informixdb/README	2007-10-16 03:26:29 UTC (rev 175)
@@ -77,8 +77,12 @@
 ====
 
 From 2.4 to 2.5:
-- ...
-
+- Compatibility with CSDK 3.00
+- Ability to manually interrupt or automatically time out SQL execution
+- Proper binding of boolean parameters in WHERE clauses
+- Make version information about server and client available
+- Various bug fixes
+ 
 From 2.3 to 2.4:
 - Implement 'named' parameter style to optionally bind query parameters
   by name
@@ -284,7 +288,7 @@
 2.2      2006-03-26  Carsten Haese
 2.3      2006-10-01  Carsten Haese
 2.4      2006-12-02  Carsten Haese
-2.5      TBD         Carsten Haese
+2.5      2007-10-16  Carsten Haese
 
 --
 Carsten Haese <ch...@us...>

Modified: trunk/informixdb/doc/manual.txt
===================================================================
--- trunk/informixdb/doc/manual.txt	2007-10-16 03:08:54 UTC (rev 174)
+++ trunk/informixdb/doc/manual.txt	2007-10-16 03:26:29 UTC (rev 175)
@@ -3,8 +3,8 @@
 ==========================
 
 :Authors: Daniel Smertnig and Carsten Haese
-:Version: informixdb 2.4
-:Date: 2006-12-02
+:Version: informixdb 2.5
+:Date: 2007-10-16
 :Homepage: `InformixDB on Sourceforge`_
 
 .. contents:: InformixDB
@@ -379,6 +379,27 @@
 `value` is the number of rows by which you want to scroll from the current
 row.
 
+Interrupting Queries
+--------------------
+`(new in version 2.5)`
+
+Cursor objects provide two mechanisms for interrupting long-running queries,
+configurable with the attributes ``sqltimeout`` and ``sqlinterrupt``.
+``sqltimeout`` is an integer that specifies how many milliseconds a query is
+allowed to take.  If a query takes longer than that, it is automatically
+aborted.  If ``sqltimeout`` is zero, no timeout is in effect and queries are
+allowed to run indefinitely.
+
+``sqlinterrupt`` is a boolean attribute that indicates whether interrupt
+signals during query execution interrupt the query. Note that turning this
+feature on disables Python's handling of interrupt signals while queries are
+executed.
+
+Connection objects have ``sqltimeout`` and ``sqlinterrupt`` attributes that
+set the defaults for the corresponding attributes of any cursor objects
+that the connection object creates. By default, ``sqltimeout`` is zero,
+and ``sqlinterrupt`` is False.
+
 Transactions
 ============
 
@@ -643,7 +664,33 @@
   `Connection` object's messages attribute, and if the error is an actual
   error (i.e. not of type `Warning`), an exception is raised. 
 
+Inspecting Version Numbers
+==========================
 
+Occasionally it may be useful to inspect the version numbers of the database
+engine, the ESQL/C driver, or of InformixDB itself. The following version
+information is available at runtime:
 
+Module-level attribute:
+
+  * ``version``: The version number of InformixDB itself.
+    (`new in version 2.3`)
+
+Versions 2.0 through 2.2 didn't provide any version information. If you
+have an installation of InformixDB that doesn't have a ``version`` attribute,
+you should probably upgrade, since you're missing out on a lot of features
+and bug fixes.
+
+Connection attributes (`new in version 2.5`):
+
+  * ``dbms_name``, ``dbms_version``: The name and version number of the
+    database engine. For older engines such as Standard Engine, the name can
+    not be determined and the string "Unknown" is returned instead.
+
+  * ``driver_name``, ``driver_version``: The name and version number of the
+    ESQL/C installation with which InformixDB was compiled. The name is either
+    "INFORMIX-ESQL" or "IBM Informix-ESQL"
+
+
 .. _InformixDB on Sourceforge: http://informixdb.sourceforge.net/
 .. [#pep249] http://www.python.org/peps/pep-0249.html


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.