rst fixes

starts-with and ends-before

end before

rst fixes

fix

Author: Chris Cho

source/code-snippets/collation/aggregation-collation.js

@@ -2,10 +2,12 @@
   Retrieve the total number of matching names, grouped by the first_name
   field and sorted by using the German phonebook collation.
 */
+// start aggregation collation
 myColl.aggregate(
   [
     { $group: { "_id": "$first_name", "nameCount": { "$sum": 1 } } },
     { $sort: { "_id": 1 } },
   ],
   { collation: { locale: "de@collation=phonebook" } },
 );
+// end aggregation collation

source/code-snippets/collation/collection-auto-collation.js

@@ -1,2 +1,4 @@
 // Retrieve documents that match "photograph" in the "type" field
-myColl.find({type: "photograph"});
+// start auto collation
+myColl.find({type: "photograph"});
+// end auto collation

source/code-snippets/collation/collection-collation.js

@@ -1,4 +1,6 @@
 // Create the "souvenirs" collection and specify the French Canadian collation
+// start collection collation
 db.createCollection("souvenirs", {
   collation: { locale: "fr_CA" },
-});
+});
+// end collection collation

source/code-snippets/collation/collection-specify-collation.js

@@ -2,7 +2,8 @@
    Retrieve documents that match "photograph" in the "type" field,
    sorted by the Iceland collation and uppercase precedence.
 */
+// start specified collation
  myColl.find({type: "photograph"},
    { collation: { locale: "is", caseFirst: "upper" } }
  );
-
+ // end specified collation

source/code-snippets/collation/find-sort-collation.js

@@ -2,5 +2,7 @@
    Retrieve documents that match "New York" in the "city" field,
    sorted by the "name" field by using the German collation.
 */
+// start find sort collation
 myColl.find({ city: "New York" }, { collation: { locale: "de" } })
   .sort({ name: 1 });
+// end find sort collation

source/code-snippets/collation/findOneAndUpdate-collation.js

@@ -3,8 +3,10 @@
    that precedes "Gunter" when ordered by using the
    German phonebook collation order.
 */
+// start findOneAndUpdate collation
 myColl.findOneAndUpdate(
   { first_name: { $lt: "Gunter" } },
   { $set: { verified: true } },
   { collation: { locale: "de@collation=phonebook" } },
-);
+);
+// end findOneAndUpdate collation

source/code-snippets/collation/index-collation.js

@@ -3,6 +3,8 @@
    locale collation, specifying ascending ordering of the
    "title" field.
 */
+// start create index collation
 myColl.createIndex(
   { 'title' : 1 },
   { 'collation' : { 'locale' : 'en_US' } });
+// end create index collation

source/code-snippets/collation/query-index-collation.js

@@ -3,5 +3,7 @@
    in descending order of the value of the "title" field,
    specifying a collation that uses the index.
 */
+// start query index collation
 myColl.find({"year": 1980}, {"collation" : {"locale" : "en_US" }})
-  .sort({"title": -1});
+  .sort({"title": -1});
+// end query index collation

source/code-snippets/collation/query-index-no-collation.js

@@ -2,6 +2,8 @@
    Retrieve documents that match the "year" value "1980"
    in descending order of the value of the "title" field
    that does not use the collation index.
-*/ 
+*/
+// start index no collation
 myColl.find({"year": 1980})
   .sort({"title": -1});
+// end index no collation

source/code-snippets/collation/query-not-indexed-collation.js

@@ -4,5 +4,7 @@
    specifying a collation that does not use the collation
    index.
 */
+// start not indexed collation
 myColl.find({"year": 1980}, {"collation" : {"locale" : "en_US", "strength": 2 }})
-  .sort({"title": -1});
+  .sort({"title": -1});
+// end not indexed collation

source/fundamentals/collations.txt

@@ -120,23 +120,26 @@ collection.
 
 .. literalinclude:: /code-snippets/collation/collection-collation.js
    :language: javascript
-   :lineno-start: 2
+   :start-after: start collection collation
+   :end-before: end collection collation
 
 Any of the operations that support collations automatically apply the collation
 defined on the collection. The query below searches the ``souvenirs``
 collection and applies the "``fr_CA``" locale collation:
 
 .. literalinclude:: /code-snippets/collation/collection-auto-collation.js
    :language: javascript
-   :lineno-start: 2
+   :start-after: start auto collation
+   :end-before: end auto collation
 
 You can specify a different collation as a parameter in an operation that
 supports collations. The following query specifies the "``is``" Iceland locale
 and ``caseFirst`` optional parameter with the value "``upper``":
 
 .. literalinclude:: /code-snippets/collation/collection-specify-collation.js
    :language: javascript
-   :lineno-start: 5
+   :start-after: start specified collation
+   :end-before: end specified collation
 
 Assign a Collation to an Index
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -146,25 +149,29 @@ a collection with a collation set to the "``en_US``" locale.
 
 .. literalinclude:: /code-snippets/collation/index-collation.js
    :language: javascript
-   :lineno-start: 5
+   :start-after: start create index collation
+   :end-before: end create index collation
 
 The following query uses the index we created:
 
 .. literalinclude:: /code-snippets/collation/query-index-collation.js
    :language: javascript
-   :lineno-start: 6
+   :start-after: start query index collation
+   :end-before: end query index collation
 
 The following queries **do not** use the index that we created. The first
 query does not include a collation and the second contains a different
 strength value than the collation on the index.
 
-.. literalinclude:: /code-snippets/collation/query-index-not-indexed-collation.js
+.. literalinclude:: /code-snippets/collation/query-not-indexed-collation.js
    :language: javascript
-   :lineno-start: 6
+   :start-after: start not indexed collation
+   :end-before: end not indexed collation
 
 .. literalinclude:: /code-snippets/collation/query-index-no-collation.js
    :language: javascript
-   :lineno-start: 6
+   :start-after: start index no collation
+   :end-before: end index no collation
 
 Collation Query Examples
 ~~~~~~~~~~~~~~~~~~~~~~~~
@@ -183,6 +190,8 @@ setting the value of the ``locale`` parameter to ``de``.
 
 .. literalinclude:: /code-snippets/collation/find-sort-collation.js
    :language: javascript
+   :start-after: start find sort collation
+   :end-before: end find sort collation
 
 findOneAndUpdate() Example
 ``````````````````````````
@@ -203,7 +212,8 @@ which **does not** specify a collation:
 
 .. literalinclude:: /code-snippets/collation/findOneAndUpdate-default-order-collation.js
    :language: javascript
-   :lineno-start: 6
+   :start-after: start findOneAndUpdate default order collation
+   :end-before: end findOneAndUpdate default order collation
 
 Since "Gunter" is the first sorted result when using a binary collation, none
 of the documents come lexically before and match the ``$lt`` comparison
@@ -219,7 +229,8 @@ umlauts.
 
 .. literalinclude:: /code-snippets/collation/findOneAndUpdate-collation.js
    :language: javascript
-   :lineno-start: 6
+   :start-after: start findOneAndUpdate collation
+   :end-before: end findOneAndUpdate collation 
 
 Since "Günter" lexically comes before "Gunter" using the
 ``de@collation=phonebook`` collation specified in ``findOneAndUpdate()``,
@@ -250,10 +261,8 @@ lexical order.
 
 .. literalinclude:: /code-snippets/collation/findOneAndDelete-collation.js
    :language: javascript
-   :lineno-start: 6
-
-   :start-after: start findOneAndDelete example with collation
-   :end-before: end findOneAndDelete example with collation
+   :start-after: start findOneAndDelete collation
+   :end-before: end findOneAndDelete collation
 
 After you run the operation above, the collection contains the following
 documents:
@@ -270,7 +279,8 @@ document it finds that matches the query criteria.
 
 .. literalinclude:: /code-snippets/collation/findOneAndDelete-no-collation.js
    :language: javascript
-   :lineno-start: 6
+   :start-after: start findOneAndDelete no collation
+   :end-before: end findOneAndDelete no collation
 
 Since all the documents contain lexical values in the ``a`` field that
 match the criteria (greater than the lexical value of "``100``"), the operation
@@ -300,3 +310,5 @@ the German phonebook (``de@collation=phonebook`` locale) order.
 
 .. literalinclude:: /code-snippets/collation/aggregation-collation.js
    :language: javascript
+   :start-after: start aggregation collation
+   :end-before: end aggregation collation