regorganize and index the operators page

Author: Sam Kleinman

source/reference/operators.txt

@@ -3,16 +3,19 @@ Operator Reference
 ==================
 
 .. default-domain:: mongodb
-.. highlight:: javascript
 
 This document contains a reference to all :term:`operators <operator>`
 used with MongoDB in version |version|.
 
+.. index:: query selectors
 .. _query-selectors:
 
 Query Selectors
 ---------------
 
+.. index:: query selectors; comparison
+.. _query-selectors-comparison:
+
 Comparison
 ~~~~~~~~~~
 
@@ -94,6 +97,9 @@ This statement returns all documents with ``field`` between
 
       { field: [-1,3] }
 
+.. index:: query selectors; document
+.. _query-selectors-document:
+
 Document
 ~~~~~~~~
 
@@ -203,6 +209,9 @@ Document
    returns all documents in ``collection`` where the value of ``age``
    is *not* 3, 5, or 7.
 
+
+.. index:: query selectors; geospatial
+.. _query-selectors-geospatial:
 .. _geospatial-query-operators:
 .. _geolocation-operators:
 
@@ -319,6 +328,9 @@ Geospatial
    You cannot specify :operator:`$uniqueDocs` with :operator:`$near`
    or haystack queries.
 
+.. index:: query selectors; logical
+.. _query-selectors-logical:
+
 Logical
 ~~~~~~~
 
@@ -348,7 +360,7 @@ Logical
    field that has the value ``19``, and *either* a ``key1`` field with
    ``value1`` *or* a ``key2`` field with ``value2``.
 
-   .. versionadded: 2.0
+   .. versionadded:: 2.0
       You may nest :operator:`$or` operations; however, these
       expressions are not as efficiently optimized as top-level
       :operator:`$or` operations.
@@ -422,6 +434,9 @@ Logical
 
    .. see:: The :operator:`$type` operator, used in the above example.
 
+.. index:: query selectors; element
+.. _query-selectors-element:
+
 Element
 ~~~~~~~
 
@@ -524,7 +539,6 @@ Element
      - ``s`` allows the dot (e.g. ``.``) character to match all
        characters *including* newline characters.
 
-
      :option:`$regex` only provides the ``i` and ``m`` options in the
      short JavaScript syntax (i.e. ``/acme.*corp/i``). To use ``x``
      and ``s`` you must use the ":operator:`$regex`" operator with the
@@ -569,6 +583,9 @@ Element
 
       db.collection.find( "field % d == m" );
 
+.. index:: query selectors; javascript
+.. _query-selectors-javascript:
+
 JavaScript
 ~~~~~~~~~~
 
@@ -595,6 +612,9 @@ JavaScript
       standard query operator to filter the result set. Using
       :operator:`$where` alone requires a table scan.
 
+.. index:: query selectors; array
+.. _query-selectors-array:
+
 Array
 ~~~~~
 
@@ -656,11 +676,20 @@ Array
 
       { array: [ { value1:1, value2:0 }, { value1:1, value2:2 } ] }
 
+.. index:: operators; update
+.. index:: update operators
 .. _update-operators:
 
 Update
 ------
 
+.. index:: update operators; fields
+.. _operators-update-fields:
+.. _update-operators-fields:
+
+Fields
+~~~~~~
+
 .. operator:: $set
 
   Use the :operator:`$set` operator to set a particular value. The
@@ -725,6 +754,32 @@ Update
 
    :operator:`$inc` accepts positive and negative incremental amounts.
 
+.. operator:: $rename
+
+  The :operator:`$rename` operator changes the name of a field. Consider the
+  following example:
+
+  .. code-block:: javascript
+
+     db.collection.update( { field: value }, { $rename: { old_field: new_field  } } );
+
+  Here, the :operator:`$rename` operator changes the name of the ``old_field``
+  field to ``new_field``, in the document that matches the query ``{
+  field: value }`` in ``collection``.
+
+  The :operator:`$rename` operator will expand arrays and
+  sub-documents to find a match for field names (e.g. ``old_field``
+  in the example above.)
+
+   .. versionadded:: 1.7.2
+
+.. index:: update operators; array
+.. _operators-update-array:
+.. _update-operators-array:
+
+Array
+~~~~~
+
 .. operator:: $push
 
    The :operator:`$push` operator appends a specified value to an array. For
@@ -853,24 +908,12 @@ Update
    the array in ``field1``, in the document that matches the
    query statement ``{ field: value }`` in ``collection``.
 
-.. operator:: $rename
-
-  The :operator:`$rename` operator changes the name of a field. Consider the
-  following example:
+.. index:: update operators; bitwise
+.. _operators-update-bitwise:
+.. _update-operators-bitwise:
 
-  .. code-block:: javascript
-
-     db.collection.update( { field: value }, { $rename: { old_field: new_field  } } );
-
-  Here, the :operator:`$rename` operator changes the name of the ``old_field``
-  field to ``new_field``, in the document that matches the query ``{
-  field: value }`` in ``collection``.
-
-  The :operator:`$rename` operator will expand arrays and
-  sub-documents to find a match for field names (e.g. ``old_field``
-  in the example above.)
-
-   .. versionadded:: 1.7.2
+Bitwise
+~~~~~~~
 
 .. operator:: $bit
 
@@ -885,6 +928,13 @@ Update
    named ``field`` with a bitwise ``and: 5`` operation. This
    operator only works with number types.
 
+.. index:: update operators; isolation
+.. _operators-update-isolation:
+.. _update-operators-isolation:
+
+Isolation
+~~~~~~~~~
+
 .. operator:: $atomic
 
    In multi-update mode, it's possible to specify an
@@ -905,6 +955,7 @@ Update
    .. seealso:: See :func:`db.collection.update()` for more information about the
       :func:`db.collection.update()` method.
 
+.. index:: projection operators
 .. _projection-operators:
 
 Projection