   (execute- query-params query/delete-query))
 
 (defn select
-  "Executes `SELECT` statements, which reads one or more columns for one or more rows in a table.
-   It returns a resultset of rows, where each row contains the collection of columns corresponding
-   to the query."
+  "Retrieves one or more columns for one or more rows in a table.
+   It returns a result set, where every row is a collection of columns returned by the query."
   [& query-params]
   (execute- query-params query/select-query))
 
 (defn truncate
-  "Executes `TRUNCATE` statement, which permanently and irreversably removes all data from a table."
+  "Truncates a table: permanently and irreversably removes all rows from the table,
+   not removing the table itself."
   [table]
   (execute- [table] query/truncate-query))
 

  (execute- [ks] query/use-keyspace-query))

(defn alter-table
  "Executes `ALTER` statement, which is used to manipulate table definitions. It allows to add new
   columns, drop existing ones, change the type of existing columns, or update the table options."
  [& query-params]
  (execute- query-params query/alter-table-query))

(defn alter-keyspace
  "Executes `ALTER KEYSPACE` statement, which  alters the properties of an existing keyspace. The
   supported properties are the same that for the CREATE KEYSPACe statement."
  [& query-params]
  (execute- query-params query/alter-keyspace-query))


       client/execute))

(defn update
  "Updates one or more columns for a given row in a table. The `where` clause
   is used to select the row to update and must include all columns composing the PRIMARY KEY.
   Other columns values are specified through assignment within the `set` clause."
  [& query-params]
  (execute- query-params query/update-query))

(defn delete
  "Deletes columns and rows. If the `columns` clause is provided,
   only those columns are deleted from the row indicated by the `where` clause, please refer to
   KV guide (http://clojurecassandra.info/articles/kv.html) for more details. Otherwise whole rows
   are removed. The `where` allows to specify the key for the row(s) to delete."
