doc: update collection_find docs for how to specify $orderby

Author: Christian Hergert

doc/mongoc_collection_find.page

@@ -37,15 +37,16 @@ mongoc_collection_find (mongoc_collection_t       *collection,
       <tr><td><p>skip</p></td><td><p>A uint32_t of number of documents to skip or 0.</p></td></tr>
       <tr><td><p>limit</p></td><td><p>A uint32_t of max number of documents to return or 0.</p></td></tr>
       <tr><td><p>batch_size</p></td><td><p>A uint32_t containing batch size of document result sets or 0 for default. Default is 100.</p></td></tr>
-      <tr><td><p>query</p></td><td><p>A bson_t to execute.</p></td></tr>
+      <tr><td><p>query</p></td><td><p>A bson_t containing the query and options to execute.</p></td></tr>
       <tr><td><p>fields</p></td><td><p>A bson_t containing fields to return or NULL.</p></td></tr>
       <tr><td><p>read_prefs</p></td><td><p>A <link xref="mongoc_read_prefs_t">mongoc_read_prefs_t</link> or NULL for default read preferences.</p></td></tr>
     </table>
   </section>
 
   <section id="description">
     <title>Description</title>
-    <p>This function shall execute a query on the underlying <code>collection</code>.  The bson <code>query</code> is not validated, simply passed along as appropriate to the server.  As such, compatibility and errors should be validated in the appropriate server documentation.</p>
+    <p>This function shall execute a query on the underlying <code>collection</code>.</p>
+    <p>If no options are necessary, <code>query</code> can simply contain a query such as <code>{a:1}</code>. If you would like to specify options such as a sort order, the query must be placed inside of <code>{"$query": {}}</code> as specified by the server documentation. See the example below for how to properly specify additional options to <code>query</code>.</p>
   </section>
 
   <section id="return">
@@ -70,7 +71,8 @@ print_all_documents (mongoc_collection_t *collection)
    char *str;
    bson_t *query;
 
-   query = bson_new ();
+   query = BCON_NEW ("$query", "{", "foo", BCON_INT32 (1), "}",
+                     "$orderby": "{", "foo", BCON_INT32 (-1), "}");
    cursor = mongoc_collection_query (collection, MONGOC_QUERY_NONE, 0, 0, 0, query, NULL, NULL);
 
    while (mongoc_cursor_more (cursor) && mongoc_cursor_next (cursor, &doc)) {