Doc update

doc/ref/jsonpath/jsonpath_expression/evaluate.md

@@ -15,6 +15,8 @@ normalized path expressions.
 (2) Evaluates the root value against the compiled JSONPath expression and calls a provided
 callback repeatedly with the results.
 
+Note: This function is kept for backwards compatability. New code should use the [select](select.md) function. 
+
 #### Parameters
 
 <table>

doc/ref/jsonpath/jsonpath_expression/update.md

@@ -23,6 +23,8 @@ It must have function call signature equivalent to
   </tr>
 </table>
 
+The callback receives nodes with duplicates removed, and paths sorted in descending order.
+
 ### Examples
 
 #### Update in place
@@ -41,7 +43,7 @@ int main()
     std::ifstream is(/*path_to_books_file*/);
     json doc = json::parse(is);
 
-    auto callback = [](const jsonpath::path_node& /*location*/, json& book)
+    auto callback = [](const jsonpath::path_node& /*path*/, json& book)
     {
         if (book.at("category") == "memoir" && !book.contains("price"))
         {