diff --git a/doc/nvim-surround.txt b/doc/nvim-surround.txt
index c2bd0fb..1553e1e 100644
--- a/doc/nvim-surround.txt
+++ b/doc/nvim-surround.txt
@@ -45,9 +45,9 @@ and "modifying" (deleting/changing) delimiter pairs.
 
 The primary way of adding a new pair to the buffer is via the normal-mode *ys*
 operator, which stands for "you surround". It can be used via
-`ys{motion}{char}`, which surrounds a given {motion} with a delimiter pair
-associated with {char}. For example, `ysa")` means "you surround around quotes
-with parentheses".
+`ys{motion}{char}`, which surrounds a given |motion| or |text-object| with a
+delimiter pair associated with {char}. For example, `ysa")` means "you surround
+around quotes with parentheses".
 
 In all of the following examples, the `*` denotes the cursor position: