diff --git a/doc/user_guide/interactions.rst b/doc/user_guide/interactions.rst
index d625d104c..4829c371f 100644
--- a/doc/user_guide/interactions.rst
+++ b/doc/user_guide/interactions.rst
@@ -357,7 +357,7 @@ via mouse actions. By default, points are selected on click:
     point = alt.selection_point()
     make_example(point)
 
-By changing some arguments, we can select points on pointerover rather than on
+By changing some arguments, we can select points when hovering over them rather than on
 click. We can also set the ``nearest`` flag to ``True`` so that the nearest
 point is highlighted:
 
diff --git a/doc/user_guide/transform/pivot.rst b/doc/user_guide/transform/pivot.rst
index 3565cba2d..eb3746c73 100644
--- a/doc/user_guide/transform/pivot.rst
+++ b/doc/user_guide/transform/pivot.rst
@@ -50,7 +50,7 @@ values on multiple lines:
    base = alt.Chart(source).encode(x='date:T')
    columns = sorted(source.symbol.unique())
    selection = alt.selection_point(
-       fields=['date'], nearest=True, on='pointerover', empty=False, clear='mouseout'
+       fields=['date'], nearest=True, on='pointerover', empty=False, clear='pointerout'
    )
 
    lines = base.mark_line().encode(y='price:Q', color='symbol:N')
diff --git a/tests/examples_arguments_syntax/selection_zorder.py b/tests/examples_arguments_syntax/selection_zorder.py
index d43f94cb6..c8e3bd84a 100644
--- a/tests/examples_arguments_syntax/selection_zorder.py
+++ b/tests/examples_arguments_syntax/selection_zorder.py
@@ -15,7 +15,7 @@
 
 cars = data.cars.url
 
-hover = alt.selection_point(on='mouseover', nearest=True, empty=False)
+hover = alt.selection_point(on='pointerover', nearest=True, empty=False)
 
 chart = alt.Chart(cars, title='Selection obscured by other points').mark_circle(opacity=1).encode(
     x='Horsepower:Q',