   * sql-tokens is a vector of alternating string and param-pair vectors
   * param-pair is a vector of two elements [param-key param-type] (param keys are used to extract map params)
   * result-types is a vector of result types
-  See asphalt.type for supported SQL types."
+  See:
+    `compile-sql-template` to compile a SQL template for efficiency/enhancement
+    asphalt.type for supported SQL types."
   ([^String sql]
     (parse-sql sql {}))
   ([^String sql {:keys [sql-name escape-char param-start-char type-start-char name-encoder]

    `(def ~var-symbol (let [opts# (merge {:sql-name ~(name var-symbol)} ~options)]
                        (->> opts#
                          (conj (parse-sql ~sql opts#))
                          (apply build-sql-source ))))))



(defmacro defsql
  "Define a parsed/compiled SQL template that can be used to execute it later."
  ([var-symbol sql]
    (when-not (symbol? var-symbol)
      (i/expected "a symbol" var-symbol))
