From 26741450e6f5d8f19820e9a03e2c85d09d683aa9 Mon Sep 17 00:00:00 2001 From: Sean Corfield Date: Sun, 14 Feb 2021 14:00:28 -0800 Subject: [PATCH] Note relation between :lift and honeysql.format/value --- doc/differences-from-1-x.md | 2 +- doc/special-syntax.md | 2 ++ 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/doc/differences-from-1-x.md b/doc/differences-from-1-x.md index 591a94e..6ba6831 100644 --- a/doc/differences-from-1-x.md +++ b/doc/differences-from-1-x.md @@ -105,7 +105,7 @@ The following new syntax has been added: * `:default` -- for `DEFAULT` values (in inserts) and for declaring column defaults in table definitions, * `:inline` -- used as a function to replace the `sql/inline` / `#sql/inline` machinery, * `:interval` -- used as a function to support `INTERVAL `, e.g., `[:interval 30 :days]`. -* `:lift` -- used as a function to prevent interpretation of a Clojure data structure as DSL syntax (e.g., when passing a vector or hash map as a parameter value), +* `:lift` -- used as a function to prevent interpretation of a Clojure data structure as DSL syntax (e.g., when passing a vector or hash map as a parameter value) -- this should mostly be a replacement for `honeysql.format/value`, * `:nest` -- used as a function to add an extra level of nesting (parentheses) around an expression, * `:not` -- this is now explicit syntax, * `:param` -- used as a function to replace the `sql/param` / `#sql/param` machinery, diff --git a/doc/special-syntax.md b/doc/special-syntax.md index f75a6cf..fe47013 100644 --- a/doc/special-syntax.md +++ b/doc/special-syntax.md @@ -98,6 +98,8 @@ This can be useful when dealing with JSON types: ;;=> ["WHERE json_col = ?" {:a 1 :b "two"}] ``` +> Note: HoneySQL 1.x used `honeysql.format/value` for this. + ## nest Used to wrap an expression when you want an extra