Updated func docs

Author: lostbard

inst/@octave_sqlite/close.m

@@ -18,18 +18,20 @@
 
 ## -*- texinfo -*-
 ## @deftypefn {} {} close (@var{db})
-## Close the sqlite connection represented by the object @var{db}.
+## Close a sqlite connection
+##
+## Close the previously opened sqlite connection @var{db}.
 ##
 ## @subsubheading Inputs
 ## @table @asis
 ## @item @var{db}
-## Previously created octave_sqlite object
+## A previously created octave_sqlite object
 ## @end table
 ##
 ## @subsubheading Outputs
 ## None
 ##
-## @seealso{sqlite}
+## @seealso{sqlite, isopen}
 ## @end deftypefn
 
 function close (db)

inst/@octave_sqlite/commit.m

@@ -18,7 +18,9 @@
 
 ## -*- texinfo -*-
 ## @deftypefn {} {} commit (@var{db})
-## Commit pending transactions of sqlite connection that has AutoCommit = off.
+## Commit changes to a database
+##
+## Commit pending transactions of sqlite connection that has AutoCommit = off set.
 ##
 ## @subsubheading Inputs
 ## @table @asis

inst/@octave_sqlite/execute.m

@@ -18,6 +18,8 @@
 
 ## -*- texinfo -*-
 ## @deftypefn {} {} execute (@var{db}, @var{sqlquery})
+## Execute a SQL statement on a sqlite database
+##
 ## Execute non select SQL query @var{sqlquery} on a sqlite database.
 ##
 ## @subsubheading Inputs
@@ -36,7 +38,7 @@
 ## @example
 ## @code {
 ## # create sql connection
-## db = sqlite("mytest.db");
+## db = sqlite("mytest.db", "create");
 ## # create table and then insert a row
 ## execute(db, 'CREATE TABLE Test (Id INTEGER PRIMARY KEY AUTOINCREMENT, Name TEXT)');
 ## execute(db, 'INSERT INTO Test (Name) VALUES ("Line1")');

inst/@octave_sqlite/fetch.m

@@ -19,6 +19,8 @@
 ## -*- texinfo -*-
 ## @deftypefn {} {@var{data} =} fetch (@var{db}, @var{sqlquery})
 ## @deftypefnx {} {@var{data} =} fetch (@var{db}, @var{sqlquery}, @var{propertyname}, @var{propertyvalue} @dots{})
+## Run a SQL query on a sqlite database
+##
 ## Return rows of data after running a SQL query on a sqlite database.
 ##
 ## @subsubheading Inputs

inst/@octave_sqlite/isopen.m

@@ -18,12 +18,15 @@
 
 ## -*- texinfo -*-
 ## @deftypefn {} {@var{yesno} =} isopen (@var{db})
-## Return true if the sqlite connection is open.
+## Check if a sqlite connection is open
+##
+## Return true if the sqlite connection is open, otherwise
+## return false.
 ##
 ## @subsubheading Inputs
 ## @table @asis
 ## @item @var{db}
-##  previously opened sqlite database.
+##  A previously opened sqlite database.
 ## @end table
 ##
 ## @subsubheading Outputs

inst/@octave_sqlite/rollback.m

@@ -18,7 +18,10 @@
 
 ## -*- texinfo -*-
 ## @deftypefn {} {} rollback (@var{db})
-## Rollback pending transactions of sqlite connection.
+## Rollback changes to a database
+##
+## Rollback pending transactions of sqlite connection that has
+## AutoCommit = off set.
 ##
 ## @subsubheading Inputs
 ## @table @asis

inst/@octave_sqlite/sqlread.m

@@ -19,8 +19,9 @@
 ## -*- texinfo -*-
 ## @deftypefn {} {@var{data} =} sqlread (@var{db}, @var{tablename})
 ## @deftypefnx {} {@var{data} =} sqlread (@var{db}, @var{tablename}, @var{propertyname}, @var{propertyvalue} @dots{})
-## Return rows of data from table @var{tablename} in a sqlite database.
+## Read rows of data from a table
 ##
+## Return rows of data from table @var{tablename} in a sqlite database.
 ## This function is the equivalent of running SELECT * FROM @var{table}.
 ##
 ## @subsubheading Inputs
@@ -49,7 +50,7 @@
 ## Select all rows of data from a database table
 ## @example
 ## @code {
-## # create sql connection
+## # create sql connection to an existing database
 ## db = sqlite("mytest.db");
 ## data = sqlread(db, 'TestTable');
 ## }

inst/@octave_sqlite/sqlwrite.m

@@ -20,9 +20,10 @@
 ## @deftypefn {} {} sqlwrite (@var{db}, @var{tablename}, @var{data})
 ## @deftypefnx {} {} sqlwrite (@var{db}, @var{tablename}, @var{data}, @var{columntypes})
 ## @deftypefnx {} {} sqlwrite (@var{db}, @var{tablename}, @var{data}, @var{propertyname}, @var{propertyvalue} @dots{})
-## Insert rows of data from @var{tablename}.
+## Insert rows of data into a table.
 ##
-## If the table does not exist it will be created, using the ColumnType properyy if available
+## Insert rows of data into a sqlite database table.
+## If the table does not exist it will be created, using the ColumnType property if available
 ## otherwise, the type of input data will be used to determine field types.
 ##
 ## @subsubheading Inputs
@@ -53,8 +54,8 @@
 ## @example
 ## @code {
 ## # create sql connection
-## db = sqlite("mytest.db");
-## # create table (if doesnt exist) and then insert 2 rows
+## db = sqlite("mytest.db", "create");
+## # create table (if it does not exist) and then insert 2 rows
 ## t = dbtable([1;2],['Name1';'Name2'], 'VariableNames', @{'Id','Name'@});
 ## # insert table data
 ## sqlwrite(db, "Test", t, 'ColumnType', @{'numeric', 'text'@});

inst/dbtable.m

@@ -19,7 +19,9 @@
   ## @deftypefn {} {@var{table} =} dbtable()
   ## @deftypefnx {} {@var{table} =} dbtable (@var{var1}, @dots{} @var{varn})
   ## @deftypefnx {} {@var{table} =} dbtable (@dots{} @var{propertyname}, @var{propertyvalue})
-  ## Basic implementation of a table type to avoid dependencies on other packages.
+  ## Create a table of data
+  ##
+  ## dbtable is a basic implementation of a table type to avoid dependencies on other packages.
   ##
   ## @subsubheading Inputs
   ## @table @asis

inst/readdbtable.m

@@ -18,7 +18,8 @@
 ## @deftypefn {} {@var{t} =} readdbtable (@var{filename})
 ## Create a dbtable from a file
 ##
-## Currently, this is using a very simplistic approach
+## Currently, this is using a very simplistic approach to read data from a CSV
+## formatted file only.
 ## 
 ## @subsubheading Inputs
 ## @table @asis

inst/struct2dbtable.m

@@ -18,6 +18,13 @@
 ## @deftypefn {} {@var{t} =} struct2dbtable (@var{astruct})
 ## Create a dbtable from a struct
 ## 
+## This function uses the field names and data of the fields to create a table
+## representation of the struct.
+##
+## Each fieldname will be a variable in the table. The data for each variable
+## will be the data of the fieldname, and is expected to be a uniform size for
+## all fields in the struct.
+##
 ## @subsubheading Inputs
 ## @table @asis
 ## @item @var{astruct}