From d67e397f470bd1625969c7d037003a91ae70e944 Mon Sep 17 00:00:00 2001
From: Pokey Rule <755842+pokey@users.noreply.github.com>
Date: Fri, 13 Oct 2023 12:27:04 +0100
Subject: [PATCH] Clarify customization doc (#1948)

## Checklist

- [ ] I have added
[tests](https://www.cursorless.org/docs/contributing/test-case-recorder/)
- [ ] I have updated the
[docs](https://github.com/cursorless-dev/cursorless/tree/main/docs) and
[cheatsheet](https://github.com/cursorless-dev/cursorless/tree/main/cursorless-talon/src/cheatsheet)
- [ ] I have not broken the cheatsheet
---
 docs/user/customization.md | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/docs/user/customization.md b/docs/user/customization.md
index 5fda1a7720a..08de3eb5543 100644
--- a/docs/user/customization.md
+++ b/docs/user/customization.md
@@ -30,13 +30,12 @@ The directory location can be customized using the `user.cursorless_settings_dir
 Note that these csv's:
 
 - support empty lines,
-- supports multiple spoken forms for a single action
+- support multiple spoken forms for a single identifier using `|` as a separator, eg `ditch|chuck, remove`,
 - support comment lines beginning with `#`, and
-- ignore any leading / trailing whitespace on spoken forms and cursorless
-  identifiers
+- ignore leading / trailing whitespace on identifiers and spoken forms
 
 If the spoken form begins with a `-`, it will be disabled. Please do not remove
-these lines, because that will trigger cursorless to add them back on next
+any lines, because that will trigger cursorless to add them back on next
 reload, as cursorless uses these lines to track disabled spoken forms.
 
 ### Changing a spoken form