From db4bb6788d1aaea5d5a08f890e59b2bd3892f9ae Mon Sep 17 00:00:00 2001 From: lePerdu Date: Wed, 30 Jan 2019 20:55:37 -0500 Subject: [PATCH] Make word splitting description more precise --- doc/pages/expansions.asciidoc | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/doc/pages/expansions.asciidoc b/doc/pages/expansions.asciidoc index 5907911d..833e8de8 100644 --- a/doc/pages/expansions.asciidoc +++ b/doc/pages/expansions.asciidoc @@ -53,11 +53,12 @@ inside %-strings or other expansions. So: Like "variable expansion" and "command substitution" in shell programming, Kakoune expansions can expand to multiple "words" - that is, separate arguments on the resulting command-line. However, unlike shell programming, -Kakoune expansions cannot _accidentally_ expand to multiple words, even if -the expansion contains whitespace or other special characters: only list types -can expand to multiple arguments. While in shell-programming it's good practice -to always wrap expansions in double-quotes, in Kakoune it's perfectly safe to -leave expansions unquoted. +Kakoune expansions cannot _accidentally_ expand to multiple words because they +contain whitespace or other special characters. Only expansions which +semantically contain a list of values (list-type options, registers, selections, +etc.) expand to multiple arguments. While in shell-programming it's good +practice to always wrap expansions in double-quotes, in Kakoune it's perfectly +safe to leave expansions unquoted. == Argument expansions