---

yaml
---
r: 35857
b: refs/heads/try2
c: 1d47c0a
h: refs/heads/master
i:
  35855: 725177d
v: v3

Author: graydon

[refs]

@@ -5,7 +5,7 @@ refs/heads/snap-stage3: eb8fd119c65c67f3b1b8268cc7341c22d39b7b61
 refs/heads/try: d324a424d8f84b1eb049b12cf34182bda91b0024
 refs/tags/release-0.1: 1f5c5126e96c79d22cb7862f75304136e204f105
 refs/heads/ndm: f3868061cd7988080c30d6d5bf352a5a5fe2460b
-refs/heads/try2: eff4a36b3e5cfbd2b08bb5a3e8d07396dc532033
+refs/heads/try2: 1d47c0a830ac6d735128d3c6cd7ff3b41b874f94
 refs/heads/incoming: d9317a174e434d4c99fc1a37fd7dc0d2f5328d37
 refs/heads/dist-snap: 22efa39382d41b084fde1719df7ae8ce5697d8c9
 refs/tags/release-0.2: c870d2dffb391e14efb05aa27898f1f6333a9596

branches/try2/doc/rust.md

@@ -1697,7 +1697,7 @@ The default meaning of the operators on standard types is given here.
 
 #### Bitwise operators
 
-Bitwise operators apply are, like the [arithmetic operators](#arithmetic-operators),
+Bitwise operators are, like the [arithmetic operators](#arithmetic-operators),
 syntactic sugar for calls to built-in traits.
 This means that bitwise operators can be overridden for user-defined types.
 The default meaning of the operators on standard types is given here.
@@ -1730,21 +1730,31 @@ and `&&` only when it evaluates to `true`.
 
 #### Comparison operators
 
+Comparison operators are, like the [arithmetic operators](#arithmetic-operators),
+and [bitwise operators](#bitwise-operators),
+syntactic sugar for calls to built-in traits.
+This means that comparison operators can be overridden for user-defined types.
+The default meaning of the operators on standard types is given here.
+
 `==`
   : Equal to.
+    Calls the `eq` method on the `core::cmp::Eq` trait.
 `!=`
   : Unequal to.
+    Calls the `ne` method on the `core::cmp::Eq` trait.
 `<`
   : Less than.
+    Calls the `lt` method on the `core::cmp::Ord` trait.
 `>`
   : Greater than.
+    Calls the `gt` method on the `core::cmp::Ord` trait.
 `<=`
   : Less than or equal.
+    Calls the `le` method on the `core::cmp::Ord` trait.
 `>=`
   : Greater than or equal.
+    Calls the `ge` method on the `core::cmp::Ord` trait.
 
-The binary comparison operators can be applied to any two operands of
-the same type, and produce a boolean value.
 
 #### Type cast expressions