doc: regenerate docs

Author: aldum

docs/reference.md

@@ -158,7 +158,10 @@ dbClient.transaction { db =>
       sql"INSERT INTO buyer (name, date_of_birth) VALUES ($newName, $newDateOfBirth), ($newName, $newDateOfBirth)"
     )
 
-  assert(generatedIds == Seq(4, 5))
+  if (!this.isInstanceOf[MsSqlSuite])
+    assert(generatedIds == Seq(4, 5))
+  else
+    assert(generatedIds == Seq(5))
 
   db.run(Buyer.select) ==> List(
     Buyer[Sc](1, "James Bond", LocalDate.parse("2001-02-03")),
@@ -236,7 +239,10 @@ dbClient.transaction { db =>
       LocalDate.parse("2000-01-01")
     )
   )
-  assert(generatedKeys == Seq(4, 5))
+  if (!this.isInstanceOf[MsSqlSuite])
+    assert(generatedKeys == Seq(4, 5))
+  else
+    assert(generatedKeys == Seq(5))
 
   db.run(Buyer.select) ==> List(
     Buyer[Sc](1, "James Bond", LocalDate.parse("2001-02-03")),
@@ -1997,7 +2003,6 @@ Buyer.select
   .leftJoin(ShippingInfo)(_.id `=` _.buyerId)
   .map { case (b, si) => (b.name, si.map(_.shippingDate)) }
   .sortBy(_._2)
-  .nullsFirst
 ```
 
 
@@ -2006,7 +2011,7 @@ Buyer.select
     SELECT buyer0.name AS res_0, shipping_info1.shipping_date AS res_1
     FROM buyer buyer0
     LEFT JOIN shipping_info shipping_info1 ON (buyer0.id = shipping_info1.buyer_id)
-    ORDER BY res_1 NULLS FIRST
+    ORDER BY res_1
     ```
 
 
@@ -3395,7 +3400,7 @@ Purchase.delete(_ => true)
 
 *
     ```sql
-    DELETE FROM purchase WHERE ?
+    DELETE FROM purchase
     ```
 
 
@@ -4003,7 +4008,7 @@ Product.select
 
 
 ## UpdateJoin
-`UPDATE` queries that use `JOIN`s
+Basic `UPDATE` queries
 ### UpdateJoin.join
 
 ScalaSql supports performing `UPDATE`s with `FROM`/`JOIN` clauses using the
@@ -6951,7 +6956,7 @@ Select.delete(_ => true)
 
 *
     ```sql
-    DELETE FROM "select" WHERE ?
+    DELETE FROM "select"
     ```
 
 
@@ -9774,7 +9779,7 @@ Expr(Bytes("Hello")).contains(Bytes("ll"))
 
 
 ## ExprMathOps
-Math operations; supported by H2/Postgres/MySql, not supported by Sqlite
+Math operations; supported by H2/Postgres/MySql/MsSql, not supported by Sqlite
 ### ExprMathOps.power
 
 
@@ -10111,7 +10116,7 @@ val value = DataTypes[Sc](
   myInt = 12345678,
   myBigInt = 12345678901L,
   myDouble = 3.14,
-  myBoolean = true,
+  myBoolean = false,
   myLocalDate = LocalDate.parse("2023-12-20"),
   myLocalTime = LocalTime.parse("10:15:30"),
   myLocalDateTime = LocalDateTime.parse("2011-12-03T10:15:30"),
@@ -10122,6 +10127,23 @@ val value = DataTypes[Sc](
   myEnum = MyEnum.bar
 )
 
+val value2 = DataTypes[Sc](
+  67.toByte,
+  mySmallInt = 32767.toShort,
+  myInt = 12345678,
+  myBigInt = 9876543210L,
+  myDouble = 2.71,
+  myBoolean = true,
+  myLocalDate = LocalDate.parse("2020-02-22"),
+  myLocalTime = LocalTime.parse("03:05:01"),
+  myLocalDateTime = LocalDateTime.parse("2021-06-07T02:01:03"),
+  myUtilDate = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS").parse("2021-06-07T02:01:03.000"),
+  myInstant = Instant.parse("2021-06-07T02:01:03Z"),
+  myVarBinary = new geny.Bytes(Array[Byte](9, 8, 7, 6, 5, 4, 3, 2)),
+  myUUID = new java.util.UUID(9876543210L, 1234567890L),
+  myEnum = MyEnum.baz
+)
+
 db.run(
   DataTypes.insert.columns(
     _.myTinyInt := value.myTinyInt,
@@ -10140,8 +10162,26 @@ db.run(
     _.myEnum := value.myEnum
   )
 ) ==> 1
+db.run(
+  DataTypes.insert.columns(
+    _.myTinyInt := value2.myTinyInt,
+    _.mySmallInt := value2.mySmallInt,
+    _.myInt := value2.myInt,
+    _.myBigInt := value2.myBigInt,
+    _.myDouble := value2.myDouble,
+    _.myBoolean := value2.myBoolean,
+    _.myLocalDate := value2.myLocalDate,
+    _.myLocalTime := value2.myLocalTime,
+    _.myLocalDateTime := value2.myLocalDateTime,
+    _.myUtilDate := value2.myUtilDate,
+    _.myInstant := value2.myInstant,
+    _.myVarBinary := value2.myVarBinary,
+    _.myUUID := value2.myUUID,
+    _.myEnum := value2.myEnum
+  )
+) ==> 1
 
-db.run(DataTypes.select) ==> Seq(value)
+db.run(DataTypes.select) ==> Seq(value, value2)
 ```
 
 
@@ -11181,6 +11221,24 @@ val rowSome = OptDataTypes[Sc](
   myUUID = Some(new java.util.UUID(1234567890L, 9876543210L)),
   myEnum = Some(MyEnum.bar)
 )
+val rowSome2 = OptDataTypes[Sc](
+  myTinyInt = Some(67.toByte),
+  mySmallInt = Some(32767.toShort),
+  myInt = Some(23456789),
+  myBigInt = Some(9876543210L),
+  myDouble = Some(2.71),
+  myBoolean = Some(false),
+  myLocalDate = Some(LocalDate.parse("2020-02-22")),
+  myLocalTime = Some(LocalTime.parse("03:05:01")),
+  myLocalDateTime = Some(LocalDateTime.parse("2021-06-07T02:01:03")),
+  myUtilDate = Some(
+    new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS").parse("2021-06-07T02:01:03.000")
+  ),
+  myInstant = Some(Instant.parse("2021-06-07T02:01:03Z")),
+  myVarBinary = Some(new geny.Bytes(Array[Byte](9, 8, 7, 6, 5, 4, 3, 2))),
+  myUUID = Some(new java.util.UUID(9876543210L, 1234567890L)),
+  myEnum = Some(MyEnum.baz)
+)
 
 val rowNone = OptDataTypes[Sc](
   myTinyInt = None,
@@ -11198,12 +11256,11 @@ val rowNone = OptDataTypes[Sc](
   myUUID = None,
   myEnum = None
 )
-
 db.run(
-  OptDataTypes.insert.values(rowSome, rowNone)
-) ==> 2
+  OptDataTypes.insert.values(rowSome, rowSome2, rowNone)
+) ==> 3
 
-db.run(OptDataTypes.select) ==> Seq(rowSome, rowNone)
+db.run(OptDataTypes.select) ==> Seq(rowSome, rowSome2, rowNone)
 ```
 
 
@@ -12376,3 +12433,80 @@ db.concatWs(" ", "i", "am", "cow", 1337)
     ```
 
 
+
+## MsSqlDialect
+Operations specific to working with Microsoft SQL Databases
+### MsSqlDialect.top
+
+For ScalaSql's Microsoft SQL dialect provides, the `.take(n)` operator translates
+into a SQL `TOP(n)` clause
+
+```scala
+Buyer.select.take(0)
+```
+
+
+*
+    ```sql
+    SELECT TOP(?) buyer0.id AS id, buyer0.name AS name, buyer0.date_of_birth AS date_of_birth
+    FROM buyer buyer0
+    ```
+
+
+
+*
+    ```scala
+    Seq[Buyer[Sc]]()
+    ```
+
+
+
+### MsSqlDialect.bool vs bit
+
+Insert rows with BIT values
+
+```scala
+db.run(
+  BoolTypes.insert.columns(
+    _.nullable := value.nullable,
+    _.nonNullable := value.nonNullable,
+    _.a := value.a,
+    _.b := value.b,
+    _.comment := value.comment
+  )
+) ==> 1
+db.run(
+  BoolTypes.insert.columns(
+    _.nullable := value2.nullable,
+    _.nonNullable := value2.nonNullable,
+    _.a := value2.a,
+    _.b := value2.b,
+    _.comment := value2.comment
+  )
+) ==> 1
+```
+
+
+
+
+
+
+### MsSqlDialect.uodate BIT
+
+
+
+```scala
+BoolTypes
+  .update(_.a `=` 1)
+  .set(_.nonNullable := true)
+```
+
+
+*
+    ```sql
+    UPDATE bool_types SET non_nullable = ? WHERE (bool_types.a = ?)
+    ```
+
+
+
+