   of this statement. After the index is created, new data for the column is indexed automatically at
   insertion time.
 
-  Example, creates an index on `users` table, `city` column:
-
-  (create-index conn :users :city
-  (index-name :users_city)
-  (if-not-exists))"
+  Example, creates an index named `users_city_idx' on `users` table, `city` column:
+
+  (create-index *session* :users_city_idx
+                (on-table :users
+                (and-column :city)
+                (if-not-exists)
+  "
   [^Session session & query-params]
   (cc/execute session
               (apply query/create-index query-params)))


  Note that since a row is identified by its primary key, the columns that compose it must be
  specified. Also, since a row only exists when it contains one value for a column not part of
  the primary key, one such value must be specified too."
  [^Session session & query-params]
  (cc/execute session
              (apply query/insert query-params)))


  Example:

  (create-table *session* :userstmp
                (column-definitions {:name        :varchar
                                     :title       :varchar
                                     :primary-key [:name]}))
  "
  [^Session session & query-params]
  (cc/execute session
              (apply query/create-table query-params)))
