sqlanywhere 0.1.0-i386-mswin32 → 0.1.1-i386-mswin32

data/ext/sqlanywhere.c

@@ -24,7 +24,7 @@
 #include "ruby.h"
 #include "sacapidll.h"
 
-const char* VERSION = "0.1.0";
+const char* VERSION = "0.1.1";
 
 // Defining the Ruby Modules
 static VALUE mSQLAnywhere;
@@ -173,10 +173,10 @@ static VALUE C2RB(a_sqlany_data_value* value)
  *  looks up all the entry points of the DLL. 
  *
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> -- an API structure to initialize
+ *  - <tt>VALUE api</tt> -- An API structure to initialize.
  *
  *  <b>Returns</b>:
- *  - <tt>result</tt>: <tt>1</tt> on successful initialization, <tt>0</tt> on failure
+ *  - <tt>result</tt>: <tt>1</tt> on successful initialization, <tt>0</tt> on failure.
  *   
  */
 static VALUE
@@ -198,13 +198,14 @@ static_API_sqlany_initialize_interface(VALUE module, VALUE api)
  *
  *  Finalize and free resources associated with the SQL Anywhere C API DLL.
  *
- *  This function will unload the library and uninitialize the supplied SQLAnywhereInterface structure. 
+ *  This function will unload the library and uninitialize the supplied
+ *  SQLAnywhereInterface structure. 
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
  *
  *  <b>Returns</b>:
- *  - <tt>nil</tt>
+ *  - <tt>nil</tt>.
  *   
  */
 static VALUE
@@ -238,14 +239,14 @@ static_SQLAnywhereInterface_alloc(VALUE class)
  * call-seq:
  *   sqlany_init(VALUE api) -> [VALUE result, VALUE version] 
  *
- *  Initialize the interface..
+ *  Initializes the interface.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
  *
  *  <b>Returns</b>:
- *  - <tt>VALUE result</tt>: <tt>1</tt> on success, <tt>0</tt> on failure
- *  - <tt>VALUE version</tt>: The maximum API version that is supported.  
+ *  - <tt>VALUE result</tt>: <tt>1</tt> on success, <tt>0</tt> on failure.
+ *  - <tt>VALUE version</tt>: The maximum API version that is supported.
  *   
  */
 static VALUE
@@ -278,15 +279,15 @@ static_SQLAnywhereInterface_sqlany_init(VALUE api)
  *
  *  Creates a connection object.
  *
- *  An API connection object needs to be created before a database connection is 
- *  established. Errors can be retrieved from the connection object. Only one 
- *  request can be processed on a connection at a time. 
+ *  An API connection object needs to be created before a database connection
+ *  is established. Errors can be retrieved from the connection object. Only
+ *  one request can be processed on a connection at a time. 
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
  *
  *  <b>Returns</b>:
- *  - <tt>VALUE connection</tt>: A connection object.  
+ *  - <tt>VALUE connection</tt>: A connection object.
  *   
  */
 static VALUE
@@ -310,17 +311,17 @@ static_SQLAnywhereInterface_sqlany_new_connection(VALUE api)
  *
  *  Creates a connection object.
  *
- *  An API connection object needs to be created before a database connection is 
- *  established. Errors can be retrieved from the connection object. Only one 
- *  request can be processed on a connection at a time. 
+ *  An API connection object needs to be created before a database connection
+ *  is established. Errors can be retrieved from the connection object. Only
+ *  one request can be processed on a connection at a time.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
- *  - <tt>VALUE sqlany_conn</tt> -- A connection object that was created by sqlany_new_connection()
- *  - <tt>VALUE str</tt> -- A SQL Anywhere connection string
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
+ *  - <tt>VALUE sqlany_conn</tt> -- A connection object that was created by sqlany_new_connection().
+ *  - <tt>VALUE str</tt> -- A SQL Anywhere connection string.
  *
  *  <b>Returns</b>:
- *  - <tt>VALUE result</tt>: <tt>1</tt> on success, <tt>0</tt> on failure 
+ *  - <tt>VALUE result</tt>: <tt>1</tt> on success, <tt>0</tt> on failure.
  *   
  */
 static VALUE
@@ -347,14 +348,15 @@ static_SQLAnywhereInterface_sqlany_connect(VALUE api, VALUE sqlany_conn, VALUE s
  *
  *  Disconnect an already established connection.
  *
- *  This function disconnects a SQL Anywhere connection. Any uncommited transactions will be rolled back. 
+ *  This function disconnects a SQL Anywhere connection. Any
+ *  uncommitted transactions will be rolled back.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
- *  - <tt>VALUE sqlany_conn</tt> -- A connection object that was connected by sqlany_connect()
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
+ *  - <tt>VALUE sqlany_conn</tt> -- A connection object that was connected by sqlany_connect().
  *
  *  <b>Returns</b>:
- *  - <tt>nil</tt> 
+ *  - <tt>nil</tt>.
  *   
  */
 static VALUE
@@ -379,11 +381,11 @@ static_SQLAnywhereInterface_sqlany_disconnect(VALUE api, VALUE sqlany_conn)
  *  Frees the resources associated with a connection object.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
- *  - <tt>VALUE sqlany_conn</tt> -- A connection object that was disconnected by sqlany_disconnect()
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
+ *  - <tt>VALUE sqlany_conn</tt> -- A connection object that was disconnected by sqlany_disconnect().
  *
  *  <b>Returns</b>:
- *  - <tt>nil</tt> 
+ *  - <tt>nil</tt>.
  *   
  */
 static VALUE
@@ -405,14 +407,15 @@ static_SQLAnywhereInterface_sqlany_free_connection(VALUE api, VALUE sqlany_conn)
  * call-seq:
  *   sqlany_fini(VALUE api) -> nil
  * 	
- *  Finalize the interface.
- *  Frees any resources allocated by the API
+ *  Finalizes the interface.
+ *
+ *  Thus function frees any resources allocated by the API.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
  *
  *  <b>Returns</b>:
- *  - <tt>nil</tt> 
+ *  - <tt>nil</tt>.
  *   
  */
 static VALUE
@@ -433,15 +436,16 @@ static_SQLAnywhereInterface_sqlany_fini(VALUE api)
  * 
  *  Retrieves the last error code and message.
  *
- *  This function can be used to retrieve the last error code and message stored in the connection object. 
+ *  This function can be used to retrieve the last error code and message
+ *  stored in the connection object. 
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
- *  - <tt>VALUE sqlany_conn</tt> -- A connection object that was connected by sqlany_connect()
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
+ *  - <tt>VALUE sqlany_conn</tt> -- A connection object that was connected by sqlany_connect().
  *
  *  <b>Returns</b>:
  *  - <tt>VALUE result</tt>: The last error code. Positive values are warnings, negative values are errors, and <tt>0</tt> is success.
- *  - <tt>VALUE errstr</tt>: The error message corresponding to the error code  
+ *  - <tt>VALUE errstr</tt>: The error message corresponding to the error code.
  *   
  */
 
@@ -472,18 +476,19 @@ static_SQLAnywhereInterface_sqlany_error(VALUE api, VALUE sqlany_conn)
  * call-seq:
  *   sqlany_execute_immediate(VALUE api, VALUE sqlany_conn, VALUE sql) -> VALUE result
  * 
- *  Execute a SQL statement immediately without returning a result set.
+ *  Executes a SQL statement immediately without returning a result set.
  *
- *  Execute the specified SQL statement immediately. This function is useful for SQL statements that do not return a result set. 
+ *  This function executes the specified SQL statement immediately. It is
+ *  useful for SQL statements that do not return a result set. 
  * 
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
- *  - <tt>VALUE sqlany_conn</tt> -- A connection object that was connected by sqlany_connect()
- *  - <tt>VALUE sql</tt> -- A SQL query string
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
+ *  - <tt>VALUE sqlany_conn</tt> -- A connection object that was connected by sqlany_connect().
+ *  - <tt>VALUE sql</tt> -- A SQL query string.
  *
  *  <b>Returns</b>:
- *  - <tt>VALUE result</tt>: <tt>1</tt> on success, <tt>0</tt> on failure 
+ *  - <tt>VALUE result</tt>: <tt>1</tt> on success, <tt>0</tt> on failure.
  *   
  */
 static VALUE
@@ -511,18 +516,20 @@ static_SQLAnywhereInterface_sqlany_execute_immediate(VALUE api, VALUE sqlany_con
  *  Executes a SQL statement and possibly returns a result set.
  *
  *  This function executes the SQL statement specified by the string argument. 
- *  This function is suitable if you want to prepare and then execute a statement, and can be 
- *  used instead of calling sqlany_prepare() followed by sqlany_execute(). 
+ *  This function is suitable if you want to prepare and then execute a
+ *  statement, and can be used instead of calling sqlany_prepare() followed
+ *  by sqlany_execute(). 
  *
- *  This function can not be used for executing a SQL statement with parameters. 
+ *  This function cannot be used for executing a SQL statement with
+ *  parameters.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
- *  - <tt>VALUE sqlany_conn</tt> -- A connection object that was connected by sqlany_connect()
- *  - <tt>VALUE sql</tt> -- A SQL query string
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
+ *  - <tt>VALUE sqlany_conn</tt> -- A connection object that was connected by sqlany_connect().
+ *  - <tt>VALUE sql</tt> -- A SQL query string.
  *
  *  <b>Returns</b>:
- *  - <tt>VALUE result</tt>: A query result set if successful, nil if failed
+ *  - <tt>VALUE result</tt>: A query result set if successful, nil if failed.
  *   
  */
 static VALUE
@@ -557,11 +564,11 @@ static_SQLAnywhereInterface_sqlany_execute_direct(VALUE api, VALUE sqlany_conn,
  * call-seq:
  *   sqlany_num_cols(VALUE api, VALUE sqlany_stmt) -> VALUE num_cols
  * 
- *  Returns number of columns in the result set 
+ *  Returns number of columns in the result set.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
- *  - <tt>VALUE sqlany_stmt</tt> -- A statement object that was created by sqlany_prepare() or sqlany_execute_direct() 
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
+ *  - <tt>VALUE sqlany_stmt</tt> -- A statement object that was created by sqlany_prepare() or sqlany_execute_direct().
  *
  *  <b>Returns</b>:
  *  - <tt>VALUE num_cols</tt>: The number of columns in the result set or <tt>-1</tt> on a failure.
@@ -588,13 +595,13 @@ static_SQLAnywhereInterface_sqlany_num_cols(VALUE api, VALUE sqlany_stmt)
  * 
  *  Returns number of rows in the result set.
  *
- *  By default this function only returns an estimate. To return an exact count,
- *  users must set the ROW_COUNTS option on the connection. 
- *  Refer to SQL Anywhere documentation for the SQL syntax to set this option
+ *  By default, this function only returns an estimate. To return an exact
+ *  count, users must set the ROW_COUNTS option on the connection. 
+ *  Refer to SQL Anywhere documentation for the SQL syntax to set this option.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
- *  - <tt>VALUE sqlany_stmt</tt> -- A statement object that was created by sqlany_prepare() or sqlany_execute_direct() 
+ *  - <tt>VALUE api</tt> --  An initialized API structure to finalize.
+ *  - <tt>VALUE sqlany_stmt</tt> -- A statement object that was created by sqlany_prepare() or sqlany_execute_direct().
  *
  *  <b>Returns</b>:
  *  - <tt>VALUE num_rows</tt>: The number of rows in the result set or <tt>-1</tt> on a failure.
@@ -619,15 +626,15 @@ static_SQLAnywhereInterface_sqlany_num_rows(VALUE api, VALUE sqlany_stmt)
  * call-seq:
  *   sqlany_get_column(VALUE api, VALUE sqlany_stmt, VALUE col_num) -> [VALUE result, VALUE column_value]
  * 
- *  Retrieve the data fetched for the specified column.
+ *  Retrieves the data fetched for the specified column.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
- *  - <tt>VALUE sqlany_stmt</tt> -- A statement object that was created by sqlany_prepare() or sqlany_execute_direct()
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
+ *  - <tt>VALUE sqlany_stmt</tt> -- A statement object that was created by sqlany_prepare() or sqlany_execute_direct().
  *  - <tt>VALUE col_num</tt> -- The number of the column to be retrieved. A column number is between 0 and sqlany_num_cols() - 1.
  *
  *  <b>Returns</b>:
- *  - <tt>VALUE column_value</tt>: The value of the column. nil is returned if the value was NULL
+ *  - <tt>VALUE column_value</tt>: The value of the column. nil is returned if the value was NULL.
  *   
  */
 static VALUE
@@ -671,17 +678,20 @@ static_SQLAnywhereInterface_sqlany_get_column(VALUE api, VALUE sqlany_stmt, VALU
  * call-seq:
  *   sqlany_fetch_next(VALUE api, VALUE sqlany_stmt) -> VALUE result
  * 
- *  Fetch the next row from the result set.
- *  This function fetches the next row from the result set. When the result object is first created, 
- *  the current row pointer is set to before the first row (i.e. row 0). 
- *  This function first advances the row pointer and then fetches the data at the new row. 
+ *  Fetches the next row from the result set.
+ * 
+ *  This function fetches the next row from the result set. When the result
+ *  object is first created, the current row pointer is set to point before
+ *  the first row (that is, row 0). 
+ *  This function advances the row pointer first and then fetches the data
+ *  at the new row. 
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
- *  - <tt>VALUE sqlany_stmt</tt> -- A statement object that was created by sqlany_prepare() or sqlany_execute_direct()
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
+ *  - <tt>VALUE sqlany_stmt</tt> -- A statement object that was created by sqlany_prepare() or sqlany_execute_direct().
  *
  *  <b>Returns</b>:
- *  - <tt>VALUE result</tt>: <tt>1</tt> on successful fetch, <tt>0</tt> otherwise
+ *  - <tt>VALUE result</tt>: <tt>1</tt> on successful fetch, <tt>0</tt> otherwise.
  *   
  */
 static VALUE
@@ -703,26 +713,29 @@ static_SQLAnywhereInterface_sqlany_fetch_next(VALUE api, VALUE sqlany_stmt)
  * call-seq:
  *   sqlany_get_column_info(VALUE api, VALUE sqlany_stmt, VALUE col_num) -> [VALUE result, VALUE col_num, VALUE name, VALUE type, VALUE max_size]
  * 
- *  Fetch the next row from the result set.
- *  This function fetches the next row from the result set. When the result object is first created, 
- *  the current row pointer is set to before the first row (i.e. row 0). 
- *  This function first advances the row pointer and then fetches the data at the new row. 
+ *  Fetches the next row from the result set.
+ * 
+ *  This function fetches the next row from the result set. When the result
+ *  object is first created, the current row pointer is set to point before
+ *  the first row (that is, row 0). 
+ *  This function advances the row pointer first and then fetches the data
+ *  at the new row. 
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
- *  - <tt>VALUE sqlany_stmt</tt> -- A statement object that was created by sqlany_prepare() or sqlany_execute_direct()
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
+ *  - <tt>VALUE sqlany_stmt</tt> -- A statement object that was created by sqlany_prepare() or sqlany_execute_direct().
  *  - <tt>VALUE col_num</tt> -- The number of the column to be retrieved. A column number is between 0 and sqlany_num_cols() - 1.
  *
  *  <b>Returns</b>:
  *  - <tt>VALUE result</tt>: <tt>1</tt> on success. Returns <tt>0</tt> if the column index is out of range, or if the statement does not return a result set.
- *  - <tt>VALUE col_num</tt>: The number of the column retrieved
- *  - <tt>VALUE name</tt>: The name of the column
- *  - <tt>VALUE type</tt>: The type of the column data
- *  - <tt>VALUE native_type</tt>: The SQL Anywhere native type of the column data
- *  - <tt>VALUE precision</tt>: The precision of the column
- *  - <tt>VALUE scale</tt>: The scale of the column
- *  - <tt>VALUE max_size</tt>: The maximum size a data value in this column can take
- *  - <tt>VALUE nullable</tt>: The nullability of the column
+ *  - <tt>VALUE col_num</tt>: The number of the column retrieved.
+ *  - <tt>VALUE name</tt>: The name of the column.
+ *  - <tt>VALUE type</tt>: The type of the column data.
+ *  - <tt>VALUE native_type</tt>: The SQL Anywhere native type of the column data.
+ *  - <tt>VALUE precision</tt>: The precision of the column.
+ *  - <tt>VALUE scale</tt>: The scale of the column.
+ *  - <tt>VALUE max_size</tt>: The maximum size a data value in this column can take.
+ *  - <tt>VALUE nullable</tt>: The nullability of the column.
  *   
  */
 static VALUE
@@ -759,14 +772,14 @@ static_SQLAnywhereInterface_sqlany_get_column_info(VALUE api, VALUE sqlany_stmt,
  * call-seq:
  *   sqlany_commit(VALUE api, VALUE sqlany_conn) -> VALUE result
  * 
- *  Commit the current transaction.
+ *  Commits the current transaction.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
- *  - <tt>VALUE sqlany_conn</tt> -- A connection object that was connected by sqlany_connect()
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
+ *  - <tt>VALUE sqlany_conn</tt> -- A connection object that was connected by sqlany_connect().
  *
  *  <b>Returns</b>:
- *  - <tt>VALUE result</tt>: <tt>1</tt> on successful commit, <tt>0</tt> otherwise
+ *  - <tt>VALUE result</tt>: <tt>1</tt> on successful commit, <tt>0</tt> otherwise.
  *   
  */
 static VALUE
@@ -789,14 +802,14 @@ static_SQLAnywhereInterface_sqlany_commit(VALUE api, VALUE sqlany_conn)
  * call-seq:
  *   sqlany_rollback(VALUE api, VALUE sqlany_conn) -> VALUE result
  * 
- *  Rollback the current transaction.
+ *  Rolls back the current transaction.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
- *  - <tt>VALUE sqlany_conn</tt> -- A connection object that was connected by sqlany_connect()
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
+ *  - <tt>VALUE sqlany_conn</tt> -- A connection object that was connected by sqlany_connect().
  *
  *  <b>Returns</b>:
- *  - <tt>VALUE result</tt>: <tt>1</tt> on successful rollback, <tt>0</tt> otherwise
+ *  - <tt>VALUE result</tt>: <tt>1</tt> on successful rollback, <tt>0</tt> otherwise.
  *   
  */
 static VALUE
@@ -818,16 +831,17 @@ static_SQLAnywhereInterface_sqlany_rollback(VALUE api, VALUE sqlany_conn)
  * call-seq:
  *   sqlany_prepare(VALUE api, VALUE sqlany_conn, VALUE sql) -> VALUE stmt
  * 
- *  Prepare a SQL statement.
+ *  Prepares a SQL statement.
  *
- *  This function prepares the supplied SQL string. Execution does not happen until sqlany_execute() 
- *  is called. The returned statement object should be freed using sqlany_free_stmt(). 
+ *  This function prepares the supplied SQL string. Execution does not
+ *  happen until sqlany_execute() is called. The returned statement object
+ *  should be freed using sqlany_free_stmt(). 
  *  
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
- *  - <tt>VALUE sqlany_conn</tt> -- A connection object that was connected by sqlany_connect()
- *  - <tt>VALUE sql</tt> -- SQL query to prepare
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
+ *  - <tt>VALUE sqlany_conn</tt> -- A connection object that was connected by sqlany_connect().
+ *  - <tt>VALUE sql</tt> -- SQL query to prepare.
  *
  *  <b>Returns</b>:
  *  - <tt>VALUE stmt</tt>: A statement object, or nil on failure. The statement object can be used by sqlany_execute() to execute the statement.
@@ -868,14 +882,15 @@ static_SQLAnywhereInterface_sqlany_prepare(VALUE api, VALUE sqlany_conn, VALUE s
  * 
  *  Frees resources associated with a prepared statement object.
  *
- *  This function frees the resources associated with a prepared statement object. 
+ *  This function frees the resources associated with a prepared statement
+ *  object.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
- *  - <tt>VALUE sqlany_stmt</tt> -- A statement object that was created by sqlany_prepare() or sqlany_execute_direct()
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
+ *  - <tt>VALUE sqlany_stmt</tt> -- A statement object that was created by sqlany_prepare() or sqlany_execute_direct().
  *
  *  <b>Returns</b>:
- *  - <tt>nil</tt>
+ *  - <tt>nil</tt>.
  *   
  */
 static VALUE
@@ -918,14 +933,14 @@ static_SQLAnywhereInterface_sqlany_free_stmt(VALUE api, VALUE sqlany_stmt)
  * call-seq:
  *   sqlany_execute(VALUE api, VALUE sqlany_stmt) -> VALUE result
  * 
- *  This function executes a prepared statement.
+ *  Executes a prepared statement.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
- *  - <tt>VALUE sqlany_stmt</tt> -- A statement object that was created by sqlany_prepare() or sqlany_execute_direct()
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
+ *  - <tt>VALUE sqlany_stmt</tt> -- A statement object that was created by sqlany_prepare() or sqlany_execute_direct().
  *
  *  <b>Returns</b>:
- *  - <tt>VALUE result</tt>: <tt>1</tt> on successful execution, <tt>0</tt> otherwise
+ *  - <tt>VALUE result</tt>: <tt>1</tt> on successful execution, <tt>0</tt> otherwise.
  *   
  */
 static VALUE
@@ -947,10 +962,11 @@ static_SQLAnywhereInterface_sqlany_execute(VALUE api, VALUE sqlany_stmt)
  * call-seq:
  *   sqlany_affected_rows(VALUE api, VALUE sqlany_stmt) -> VALUE result
  * 
- *  Returns the number of rows affected by execution of the prepared statement.
+ *  Returns the number of rows affected by execution of the prepared
+ *  statement.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
  *  - <tt>VALUE sqlany_stmt</tt> -- A statement that was prepared and executed successfully with no result set returned.
  *
  *  <b>Returns</b>:
@@ -978,14 +994,16 @@ static_SQLAnywhereInterface_sqlany_affected_rows(VALUE api, VALUE sqlany_stmt)
  * 
  *  Describes the bind parameters of a prepared statement.
  *
- *  This function allows the caller to determine information about parameters to a prepared statement. 
- *  Depending on the type of the prepared statement (call to stored procedured or a DML), only some information will be provided.
- *  The information that will always be provided is the direction of the parameters (input, output, or input-output). 
+ *  This function allows the caller to determine information about parameters
+ *  to a prepared statement. Depending on the type of the prepared statement
+ *  (call to stored procedure or a DML), only some information will be
+ *  provided. The information that will always be provided is the direction
+ *  of the parameters (input, output, or input-output). 
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
  *  - <tt>VALUE sqlany_stmt</tt> -- A statement object that was returned from sqlany_prepare().
- *  - <tt>VALUE index</tt> -- The index of the parameter. This should be a number between 0 and sqlany_num_params()-  1
+ *  - <tt>VALUE index</tt> -- The index of the parameter. This should be a number between 0 and sqlany_num_params()-  1.
  *
  *  <b>Returns</b>:
  *  - <tt>VALUE result</tt>: <tt>1</tt> on success or <tt>0</tt> on failure.
@@ -1028,13 +1046,13 @@ static_SQLAnywhereInterface_sqlany_describe_bind_param(VALUE api, VALUE sqlany_s
  * call-seq:
  *   sqlany_bind_param(VALUE api, VALUE sqlany_stmt, VALUE index, VALUE sqlany_bind_param) -> VALUE result
  * 
- *  Bind a user supplied buffer as a parameter to the prepared statement.
+ *  Binds a user supplied buffer as a parameter to the prepared statement.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
  *  - <tt>VALUE sqlany_stmt</tt> -- A statement object that was returned from sqlany_prepare().
- *  - <tt>VALUE index</tt> -- The index of the parameter. This should be a number between 0 and sqlany_num_params() - 1
- *  - <tt>VALUE sqlany_bind_param</tt> -- A filled bind object retrieved from sqlany_describe_bind_param()
+ *  - <tt>VALUE index</tt> -- The index of the parameter. This should be a number between 0 and sqlany_num_params() - 1.
+ *  - <tt>VALUE sqlany_bind_param</tt> -- A filled bind object retrieved from sqlany_describe_bind_param().
  *
  *  <b>Returns</b>:
  *  - <tt>VALUE result</tt>: <tt>1</tt> on success or <tt>0</tt> on failure.
@@ -1063,14 +1081,15 @@ static_SQLAnywhereInterface_sqlany_bind_param(VALUE api, VALUE sqlany_stmt, VALU
  * call-seq:
  *   sqlany_get_bind_param_info(VALUE api, VALUE sqlany_stmt, VALUE index) -> [VALUE result, VALUE bind_param]
  * 
- *  Get bound parameter info.
+ *  Gets bound parameter info.
  *
- *  This function retrieves information about the parameters that were bound using sqlany_bind_param(). 
+ *  This function retrieves information about the parameters that were
+ *  bound using sqlany_bind_param(). 
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
  *  - <tt>VALUE sqlany_stmt</tt> -- A statement object that was returned from sqlany_prepare().
- *  - <tt>VALUE index</tt> -- The index of the parameter. This should be a number between 0 and sqlany_num_params() - 1
+ *  - <tt>VALUE index</tt> -- The index of the parameter. This should be a number between 0 and sqlany_num_params() - 1.
  *
  *  <b>Returns</b>:
  *  - <tt>VALUE result</tt>: <tt>1</tt> on success or <tt>0</tt> on failure.
@@ -1110,12 +1129,14 @@ static_SQLAnywhereInterface_sqlany_get_bind_param_info(VALUE api, VALUE sqlany_s
  * call-seq:
  *   sqlany_num_params(VALUE api, VALUE sqlany_stmt) -> VALUE result
  * 
- *  Returns the number of parameters that are expected for a prepared statement.
+ *  Returns the number of parameters that are expected for a prepared
+ *  statement.
  *
- *  This function retrieves information about the parameters that were bound using sqlany_bind_param(). 
+ *  This function retrieves information about the parameters that were bound
+ *  using sqlany_bind_param(). 
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
  *  - <tt>VALUE sqlany_stmt</tt> -- A statement object that was returned from sqlany_prepare().
  *
  *  <b>Returns</b>:
@@ -1141,18 +1162,18 @@ static_SQLAnywhereInterface_sqlany_num_params(VALUE api, VALUE sqlany_stmt)
  * call-seq:
  *   sqlany_get_next_result(VALUE api, VALUE sqlany_stmt) -> VALUE result
  * 
- *  Advance to the next result set in a multiple result set query.
+ *  Advances to the next result set in a multiple result set query.
  *
- *  If a query (such as a call to a stored procedure) returns multiple result sets, 
- *  then this function advances from the current result set to the next. 
+ *  If a query (such as a call to a stored procedure) returns multiple result
+ *  sets, then this function advances from the current result set to the next.
  * 
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
- *  - <tt>VALUE sqlany_stmt</tt> -- A statement object that was executed by sqlany_execute() or sqlany_execute_direct()
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
+ *  - <tt>VALUE sqlany_stmt</tt> -- A statement object that was executed by sqlany_execute() or sqlany_execute_direct().
  *
  *  <b>Returns</b>:
- *  - <tt>VALUE result</tt>: <tt>1</tt> if was successfully able to advance to the next result set, <tt>0</tt> otherwise
+ *  - <tt>VALUE result</tt>: <tt>1</tt> if was successfully able to advance to the next result set, <tt>0</tt> otherwise.
  *   
  */
 static VALUE
@@ -1174,17 +1195,18 @@ static_SQLAnywhereInterface_sqlany_get_next_result(VALUE api, VALUE sqlany_stmt)
  * call-seq:
  *   sqlany_fetch_absolute(VALUE api, VALUE sqlany_stmt, VALUE offset) -> VALUE result
  * 
- *  Fetch data at a specific row number in the result set.
+ *  Fetches data at a specific row number in the result set.
  *
- *  This function moves the current row in the result set to the row number specified and fetches the data at that row. 
+ *  This function moves the current row in the result set to the row number
+ *  specified and fetches the data at that row. 
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
- *  - <tt>VALUE sqlany_stmt</tt> -- A statement object that was executed by sqlany_execute() or sqlany_execute_direct()
- *  - <tt>VALUE offset</tt> -- he row number to be fetched. The first row is <tt>1</tt>, the last row is <tt>-1</tt>.
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
+ *  - <tt>VALUE sqlany_stmt</tt> -- A statement object that was executed by sqlany_execute() or sqlany_execute_direct().
+ *  - <tt>VALUE offset</tt> -- The row number to be fetched. The first row is <tt>1</tt>, the last row is <tt>-1</tt>.
  *
  *  <b>Returns</b>:
- *  - <tt>VALUE result</tt>: <tt>1</tt> if the fetch was successfully, <tt>0</tt> otherwise
+ *  - <tt>VALUE result</tt>: <tt>1</tt> if the fetch was successfully, <tt>0</tt> otherwise.
  *   
  */
 static VALUE
@@ -1207,14 +1229,14 @@ static_SQLAnywhereInterface_sqlany_fetch_absolute(VALUE api, VALUE sqlany_stmt,
  * call-seq:
  *   sqlany_sqlstate(VALUE api, VALUE sqlany_conn) -> VALUE sqlstate_str
  * 
- *  Retrieve the current SQL state.
+ *  Retrieves the current SQL state.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
- *  - <tt>VALUE sqlany_conn</tt> -- A connection object that was connected by sqlany_connect()
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
+ *  - <tt>VALUE sqlany_conn</tt> -- A connection object that was connected by sqlany_connect().
  *
  *  <b>Returns</b>:
- *  - <tt>VALUE sqlstate_str</tt>: The SQL State
+ *  - <tt>VALUE sqlstate_str</tt>: The SQL State.
  *   
  */
 static VALUE
@@ -1240,11 +1262,11 @@ static_SQLAnywhereInterface_sqlany_sqlstate(VALUE api, VALUE sqlany_conn)
  *  Clears the last stored error code.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE api</tt> --  an initialized API structure to finalize
- *  - <tt>VALUE sqlany_conn</tt> -- A connection object that was connected by sqlany_connect()
+ *  - <tt>VALUE api</tt> -- An initialized API structure to finalize.
+ *  - <tt>VALUE sqlany_conn</tt> -- A connection object that was connected by sqlany_connect().
  *
  *  <b>Returns</b>:
- *  - <tt>nil</tt>:
+ *  - <tt>nil</tt>:.
  *   
  */
 static VALUE
@@ -1265,13 +1287,13 @@ static_SQLAnywhereInterface_sqlany_clear_error(VALUE api, VALUE sqlany_conn)
  * call-seq:
  *   get_name(VALUE bind) -> VALUE name
  * 
- *  Get name of the bound paramater.
+ *  Gets the name of the bound parameter.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE bind</tt> -- Bound parameter retrieved from sqlany_describe_bind_param()
+ *  - <tt>VALUE bind</tt> -- Bound parameter retrieved from sqlany_describe_bind_param().
  *
  *  <b>Returns</b>:
- *  - <tt>VALUE name</tt>: The bound variable's name
+ *  - <tt>VALUE name</tt>: The bound variable's name.
  *   
  */
 static VALUE
@@ -1286,11 +1308,11 @@ static_Bind_get_name(VALUE bind)
  * call-seq:
  *   set_value(VALUE bind, VALUE val) -> nil
  * 
- *  Set the value of a bind parameter.
+ *  Sets the value of a bind parameter.
  *
- *  Used to bind a Ruby VALUE to a give parameter in a prepared statement
- *  If the bind_direction is INPUT only, the type INPUT will be bound
- *  based on the RUBY type:
+ *  This function is used to bind a Ruby VALUE to a given parameter in a
+ *  prepared statement. If the bind_direction is INPUT only, the type INPUT
+ *  will be bound based on the RUBY type:
  *
  *    +-------------+------------+
  *    | Ruby Type   |  Bind Type |
@@ -1303,17 +1325,18 @@ static_Bind_get_name(VALUE bind)
  *    | T_NIL      => isnull = 1 |
  *    +--------------------------+
  *
- *  If the bind direction is output, instead use DBCAPI type to set the size of the buffer
+ *  If the bind direction is OUTPUT, instead use the DBCAPI type to set the
+ *  size of the buffer.
  *
- *  In the case of INOUT parameters, it is the applications job to call this method twice, 
- *  once to bind the INPUT, once to bind the OUTPUT
+ *  In the case of INOUT parameters, it is the application's job to call this
+ *  method twice, once to bind the INPUT, and once to bind the OUTPUT.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE bind</tt> -- Bound parameter retrieved from sqlany_describe_bind_param()
- *  - <tt>VALUE val</tt> -- The value to bind into the bound variable
+ *  - <tt>VALUE bind</tt> -- Bound parameter retrieved from sqlany_describe_bind_param().
+ *  - <tt>VALUE val</tt> -- The value to bind into the bound variable.
  *
  *  <b>Returns</b>:
- *  - <tt>nil</tt>
+ *  - <tt>nil</tt>.
  */
 static VALUE
 static_Bind_set_value(VALUE bind, VALUE val)
@@ -1402,14 +1425,14 @@ static_Bind_set_value(VALUE bind, VALUE val)
  * call-seq:
  *   set_direction(VALUE bind, VALUE direction) -> nil
  * 
- *  Set the direction of the bound parameter before binding
+ *  Sets the direction of the bound parameter before binding.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE bind</tt> -- Bound parameter retrieved from sqlany_describe_bind_param()
- *  - <tt>VALUE direction</tt> -- The direction of the binding variable
+ *  - <tt>VALUE bind</tt> -- Bound parameter retrieved from sqlany_describe_bind_param().
+ *  - <tt>VALUE direction</tt> -- The direction of the binding variable.
  *
  *  <b>Returns</b>:
- *  - <tt>nil</tt>
+ *  - <tt>nil</tt>.
  *   
  */
 static VALUE
@@ -1428,14 +1451,15 @@ static_Bind_set_direction(VALUE bind, VALUE direction)
  * call-seq:
  *   set_buffer_size(VALUE bind, VALUE size) -> nil
  * 
- *  For strings and binary, set the buffer size of INOUT and OUT parameters
+ *  Sets the buffer size of INOUT and OUT parameters for string and binary
+ *  data.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE bind</tt> -- Bound parameter retrieved from sqlany_describe_bind_param()
- *  - <tt>VALUE size</tt> -- The size of the buffer to hold the INOUT or OUT parameter
+ *  - <tt>VALUE bind</tt> -- Bound parameter retrieved from sqlany_describe_bind_param().
+ *  - <tt>VALUE size</tt> -- The size of the buffer to hold the INOUT or OUT parameter.
  *
  *  <b>Returns</b>:
- *  - <tt>nil</tt>
+ *  - <tt>nil</tt>.
  *   
  */
 static VALUE
@@ -1454,13 +1478,13 @@ static_Bind_set_buffer_size(VALUE bind, VALUE size)
  * call-seq:
  *   get_direction(VALUE bind) -> VALUE direction
  * 
- *  Get direction of the bound paramater.
+ *  Gets the direction of the bound parameter.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE bind</tt> -- Bound parameter retrieved from sqlany_describe_bind_param()
+ *  - <tt>VALUE bind</tt> -- Bound parameter retrieved from sqlany_describe_bind_param().
  *
  *  <b>Returns</b>:
- *  - <tt>VALUE name</tt>: The direction of the bound parameter
+ *  - <tt>VALUE name</tt>: The direction of the bound parameter.
  *   
  */
 static VALUE
@@ -1476,13 +1500,13 @@ static_Bind_get_direction(VALUE bind)
  * call-seq:
  *   finish(VALUE bind) -> nil
  * 
- *  Free resources associated with the bound parameter
+ *  Frees the resources associated with the bound parameter.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE bind</tt> -- Bound parameter retrieved from sqlany_describe_bind_param()
+ *  - <tt>VALUE bind</tt> -- Bound parameter retrieved from sqlany_describe_bind_param().
  *
  *  <b>Returns</b>:
- *  - <tt>nil</tt>
+ *  - <tt>nil</tt>.
  *   
  */
 static VALUE
@@ -1502,13 +1526,13 @@ static_Bind_finish(VALUE bind)
  * call-seq:
  *  get_info_direction(VALUE bind) -> VALUE direction
  * 
- *  Get name of the bound paramater info object.
+ *  Gets the name of the bound parameter info object.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE bind</tt> -- Bound parameter info retrieved from sqlany_describe_bind_param_info()
+ *  - <tt>VALUE bind</tt> -- Bound parameter info retrieved from sqlany_describe_bind_param_info().
  *
  *  <b>Returns</b>:
- *  - <tt>VALUE direction</tt>: The bound variable's direction
+ *  - <tt>VALUE direction</tt>: The bound variable's direction.
  *   
  */
 static VALUE
@@ -1524,13 +1548,13 @@ static_Bind_get_info_direction(VALUE bind)
  * call-seq:
  *   get_info_output(VALUE bind) -> VALUE name
  * 
- *  Get the value of a bound parameter after execution
+ *  Gets the value of a bound parameter after execution.
  *  
  *  <b>Parameters</b>:
- *  - <tt>VALUE bind</tt> -- Bound parameter retrieved from sqlany_describe_bind_param()
+ *  - <tt>VALUE bind</tt> -- Bound parameter retrieved from sqlany_describe_bind_param().
  *
  *  <b>Returns</b>:
- *  - <tt>VALUE name</tt>: The bound variable value
+ *  - <tt>VALUE name</tt>: The bound variable value.
  *   
  */
 static VALUE
@@ -1616,7 +1640,7 @@ void Init_sqlanywhere()
   rb_define_method(cA_sqlany_bind_param, "set_buffer_size", static_Bind_set_buffer_size, 1);  
   rb_define_method(cA_sqlany_bind_param, "finish", static_Bind_finish, 0);  
   
-  // Define methods for obtainting bind_paramenter_info fields
+  // Define methods for obtaining bind_parameter_info fields
   rb_define_method(cA_sqlany_bind_param_info, "get_direction", static_Bind_get_info_direction, 0);
   rb_define_method(cA_sqlany_bind_param_info, "get_output", static_Bind_get_info_output, 0);
 }