Update docs.

book/tutorial/rows.nim

@@ -110,6 +110,15 @@ nbCode:
     echo customer.user[]
 
 nbText: """
+You can pass a `Model` subtype to `select` proc instead of the object instance. Norm will instantiate the container object implicitly:
+"""
+
+nbCode:
+  let userFoo2 = dbConn.select(User, "email = ?", "[email protected]")
+  echo()
+
+nbText: """
+Note that this will only work with types that can be instantiated by calling `new <Type>`, i.e. types that don't require explicit instantiation.
 
 If you query relationships that are nested, such as when customers can have pets and you want to query all pets of all customers of users with a specific email address, you will need  to concatenate the foreign-key fields, separeted by a `_` in your query.
 """
@@ -245,4 +254,4 @@ If you need to check if a row selected by a given condition exists, use `exists`
 nbCode:
   echo dbConn.exists(Customer, "name = ?", "Alice")
 
-nbSave
+nbSave

src/norm/postgres.nim

@@ -293,6 +293,8 @@ proc select*[T: Model](dbConn; typ: typedesc[T], cond: string, params: varargs[D
   ##[ Populate a sequence of `Model`_ instances from DB.
 
   ``typ`` is a `Model`_ subtype to contain the values.
+
+  **Note:** This works only with types that can be instantiated by calling ``new <Type>``, i.e. types that don't require explicit instantiation.
   ]##
 
   result.add(new T)
@@ -313,6 +315,8 @@ proc selectAll*[T: Model](dbConn; typ: typedesc[T]): seq[T] =
 
   ``typ`` is a `Model`_ subtype to contain the values.
 
+  **Note:** This works only with types that can be instantiated by calling ``new <Type>``, i.e. types that don't require explicit instantiation.
+
   **Warning:** this is a dangerous operation because you don't control how many rows will be fetched.
   ]##
 

src/norm/sqlite.nim

@@ -264,6 +264,8 @@ proc select*[T: Model](dbConn; typ: typedesc[T], cond: string, params: varargs[D
   ##[ Populate a sequence of `Model`_ instances from DB.
 
   ``typ`` is a `Model`_ subtype to contain the values.
+
+  **Note:** This works only with types that can be instantiated by calling ``new <Type>``, i.e. types that don't require explicit instantiation.
   ]##
 
   result.add(new T)
@@ -284,6 +286,8 @@ proc selectAll*[T: Model](dbConn; typ: typedesc[T]): seq[T] =
 
   ``typ`` is a `Model`_ subtype to contain the values.
 
+  **Note:** This works only with types that can be instantiated by calling ``new <Type>``, i.e. types that don't require explicit instantiation.
+
   **Warning:** this is a dangerous operation because you don't control how many rows will be fetched.
   ]##