From 5cc286d5505c5e0c4769309a152c4610755e7f1b Mon Sep 17 00:00:00 2001
From: Minh Nguyen <47629273+m11nh@users.noreply.github.com>
Date: Tue, 19 Jul 2022 00:28:52 +1000
Subject: [PATCH] Add information about token (#849)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* [issue-814] added information about token

* Tweaks

Co-authored-by: “minh” <“minh.nguyen19997@hotmail.com”>
Co-authored-by: Pokey Rule <755842+pokey@users.noreply.github.com>
---
 docs/user/README.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/user/README.md b/docs/user/README.md
index 46a1ba046..9d403e7b5 100644
--- a/docs/user/README.md
+++ b/docs/user/README.md
@@ -211,6 +211,14 @@ The word file can be used to expand the target to refer to the entire file.
 
 For example, `"take file [blue] air"` selects the file including the token containing letter 'a' with a blue hat.
 
+##### `"token"`
+
+The `"token"` modifier expands its input to the nearest containing token. This modifier is often used without a mark, either to select the token adjacent to your cursor or to expand your selection to the nearest containing token range. For example:
+
+- `"copy token"`
+- `"take token"`
+- `"chuck token"`
+
 ##### Surrounding pair
 
 Cursorless has support for expanding the selection to the nearest containing paired delimiter, eg the surrounding parentheses.