@@ -234,7 +234,7 @@ module Prelude
234234 class Functor f where
235235 (<$>) :: forall a b. (a -> b) -> f a -> f b
236236
237− -- | `(<#>)` is `(<$>)` with its arguments flipped. For example:
237+ -- | `(<#>)` is `(<$>)` with its arguments reversed. For example:
238238 -- |
239239 -- | ```purescript
240240 -- | [1, 2, 3] <#> \n -> n * n
@@ -868,13 +868,12 @@ module Data.Function where
868868
869869 -- | The `on` function is used to change the domain of a binary operator.
870870 -- |
871− -- | For example, given a function `height :: Person -> Number`, we can create a function which compares two people by height:
871+ -- | For example, we can create a function which compares two records based on the values of their `x` properties:
872872 -- |
873873 -- | ```purescript
874− -- | taller :: Person -> Person -> Boolean
875− -- | taller = (>) `on` height
874+ -- | compareX :: forall r. { x :: Number | r } -> { x :: Number | r } -> Ordering
875+ -- | compareX = compare `on` _.x
876876 -- | ```
877− -- |
878877 on :: forall a b c. (b -> b -> c) -> (a -> b) -> a -> a -> c
879878 on f g x y = g x `f` g y
880879