2017-11-02 03:03:24 +01:00
|
|
|
|
= Expansions
|
2016-02-02 20:15:12 +01:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
While parsing a command (see <<command-parsing#,`:doc command-parsing`>>),
|
|
|
|
|
Kakoune recognises certain patterns and will replace them with their
|
|
|
|
|
associated value before executing the command. These patterns are called
|
|
|
|
|
expansions.
|
2016-02-03 18:15:35 +01:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
Every expansion consists of a `%`, followed by the expansion _type_ (one
|
2019-01-30 21:46:40 +01:00
|
|
|
|
or more alphabetic characters), a quoting character, and then all the text
|
|
|
|
|
up to and including its matching character.
|
|
|
|
|
|
2019-01-31 03:02:19 +01:00
|
|
|
|
If a nestable punctuation character (`(`, `[`, `{`, or `<`) is used as the
|
|
|
|
|
opening quoting character, the expansion will end at its matching opposite
|
|
|
|
|
(`)`, `]`, `}`, or `>`). Nested pairs of the braces used in the expansion are
|
|
|
|
|
allowed, but they must be balanced. Braces other than the ones used in the
|
|
|
|
|
expansion need not be balanced, however. For example, `%{nest{ed} non[nested}`
|
|
|
|
|
is valid and expands to `nest{ed} non[nested`.
|
|
|
|
|
|
|
|
|
|
If any other character is used, the expansion will end at the next occurrence of
|
|
|
|
|
that character. The quoting character can be escaped inside the expansion if it
|
2019-01-30 21:46:40 +01:00
|
|
|
|
is doubled-up. For example, `%|abc||def|` expands to the text `abc|def`.
|
|
|
|
|
|
|
|
|
|
It doesn't matter which character is used, but `{}` are most common.
|
|
|
|
|
|
|
|
|
|
There are 2 types of quoting which can be used to group together words separated
|
|
|
|
|
by whitespace into a single argument or prevent expansions from expanding:
|
|
|
|
|
|
|
|
|
|
"double quoted strings"::
|
|
|
|
|
Double quoted strings are mainly for grouping multiple `%` expansions or
|
|
|
|
|
`%` expansions and regular text as a single argument. `%` and `"` can be
|
|
|
|
|
escaped by doubling the characters (i.e. `%%` and `""`).
|
|
|
|
|
|
|
|
|
|
'single quoted strings'::
|
|
|
|
|
Expansions are not processed inside single quoted strings. Single quotes can
|
|
|
|
|
be escaped by doubling up (i.e. `''`).
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-27 07:37:38 +02:00
|
|
|
|
Expansions are processed when unquoted and anywhere inside double-quoted
|
|
|
|
|
strings, but not inside unquoted words, inside single-quoted strings, or
|
|
|
|
|
inside %-strings or other expansions. So:
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
* `echo %val{session}` echoes the current session ID
|
2018-06-03 22:23:17 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
* `echo x%val{session}x` echoes the literal text `x%val{session}x`
|
2018-06-03 22:23:17 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
* `echo '%val{session}'` echoes the literal text `%val{session}`
|
2018-06-03 22:23:17 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
* `echo "x%val{session}x"` echoes the current session ID, surrounded by `x`
|
2018-06-03 22:23:17 +02:00
|
|
|
|
|
2018-09-27 07:37:38 +02:00
|
|
|
|
* `echo %{%val{session}}"` echoes the the literal text `%val{session}`
|
2016-02-02 20:15:12 +01:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
* `echo %sh{ echo %val{session} }"` echoes the literal text `%val{session}`
|
2017-11-01 12:49:13 +01:00
|
|
|
|
|
2018-09-27 07:37:38 +02:00
|
|
|
|
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,
|
2019-01-31 02:55:37 +01:00
|
|
|
|
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.
|
2017-11-01 12:49:13 +01:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
== Argument expansions
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
Expansions with the type `arg` can only be used inside the "commands" parameter
|
|
|
|
|
of the `define-command` command (See <<commands#declaring-new-commands,`:doc
|
|
|
|
|
commands declaring-new-commands`>>).
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
The following expansions are available:
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%arg{n}*::
|
|
|
|
|
(where _n_ is a decimal number) +
|
|
|
|
|
expands to argument number _n_ of the current command
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%arg{@}*::
|
2018-09-27 07:37:38 +02:00
|
|
|
|
expands to all the arguments of the current command, as individual words
|
2018-09-25 08:41:53 +02:00
|
|
|
|
|
|
|
|
|
== Option expansions
|
|
|
|
|
|
|
|
|
|
Expansions with the type `opt` expand to the value associated with the named
|
|
|
|
|
option in the current scope (See <<options#,`:doc options`>>).
|
|
|
|
|
|
|
|
|
|
For example, `%opt{BOM}` expands to `utf8` or to `none`, according to the
|
|
|
|
|
current state of the `BOM` option.
|
|
|
|
|
|
|
|
|
|
== Register expansions
|
|
|
|
|
|
|
|
|
|
Expansions with the type `reg` expand to the contents of the named
|
|
|
|
|
register. For registers named after symbols (like the search register
|
|
|
|
|
`/`), the expansion can use either the symbol or the alphabetic name (See
|
|
|
|
|
<<registers#,`:doc registers`>>).
|
|
|
|
|
|
|
|
|
|
For example, `%reg{/}` expands to the content of the `/` register, and so does
|
|
|
|
|
`%reg{slash}`.
|
2016-02-02 20:15:12 +01:00
|
|
|
|
|
2017-11-02 03:03:24 +01:00
|
|
|
|
== Shell expansions
|
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
Expansions with the type `sh` are executed as shell-scripts, and whatever
|
|
|
|
|
the script prints to standard output replaces the expansion. For example,
|
|
|
|
|
the command `echo %sh{date}` will echo the output of the `date` command.
|
2016-02-02 20:15:12 +01:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
TIP: If a shell expansion writes to standard error, that output is appended to
|
|
|
|
|
Kakoune's `\*debug*` buffer. If you're trying to debug a shell expansion,
|
|
|
|
|
check the debug buffer with `:buffer \*debug*` to see if anything shows up.
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
Because Kakoune does not expand expansions inside the text of an expansion,
|
|
|
|
|
you can't use normal expansions inside `%sh{}`. Instead, Kakoune can export
|
|
|
|
|
expansions as environment variables to make them available to the shell.
|
|
|
|
|
Here's how expansion patterns map to variable names:
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%arg{n}*::
|
|
|
|
|
(where _n_ is a decimal number) +
|
|
|
|
|
becomes `$_n_`. For example, `%arg{3}` becomes `$3`.
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%arg{@}*::
|
|
|
|
|
becomes `$@`
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%opt{x}*::
|
|
|
|
|
becomes `$kak_opt_x`
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%reg{x}*::
|
|
|
|
|
(where _x_ is the alphabetic name of a register) +
|
|
|
|
|
`$kak_reg_x` contains all the selections in register _x_ +
|
|
|
|
|
`$kak_main_reg_x` contains only the main selection
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%val{x}*::
|
|
|
|
|
becomes `$kak_x`
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
When turned into environment variables, list-type options, `$kak_reg_x`, and
|
|
|
|
|
"quoted list" values will be shell-quoted so the shell doesn't get confused
|
|
|
|
|
about how many items the list contains. You will need to apply `eval` to get
|
|
|
|
|
back the original values. For example, if you want to process the contents
|
|
|
|
|
of each selection, you can do something like:
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
----
|
2018-12-21 21:19:53 +01:00
|
|
|
|
eval set -- "$kak_selections"
|
2018-09-25 08:41:53 +02:00
|
|
|
|
while [ $# -gt 0 ]; do
|
2018-09-28 10:00:20 +02:00
|
|
|
|
# ... do a thing with $1 ...
|
2018-09-25 08:41:53 +02:00
|
|
|
|
shift
|
|
|
|
|
done
|
|
|
|
|
----
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
The `eval` command will take the expanded `$kak_selections` and unquote them,
|
|
|
|
|
then execute the resulting `set` command, which sets the shell's argument
|
|
|
|
|
variables to the items from `$kak_selections`. The `while` loop with `shift`
|
|
|
|
|
iterates through the arguments one by one.
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
Only variables actually mentioned in the body of the shell expansion will
|
|
|
|
|
be exported into the shell's environment. For example:
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
----
|
|
|
|
|
echo %sh{ env | grep ^kak_ }
|
|
|
|
|
----
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-28 10:00:20 +02:00
|
|
|
|
... will find none of Kakoune's special environment variables, but:
|
2018-04-09 09:04:51 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
----
|
2018-09-27 07:37:38 +02:00
|
|
|
|
echo %sh{ env | grep ^kak_ # kak_session }
|
2018-09-25 08:41:53 +02:00
|
|
|
|
----
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-28 10:00:20 +02:00
|
|
|
|
... will find the `$kak_session` variable because it was mentioned by name
|
2018-09-27 07:37:38 +02:00
|
|
|
|
in a comment, even though it wasn't directly used.
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
TIP: These environment variables are also available in other contexts where
|
|
|
|
|
Kakoune uses a shell command, such as the `|`, `!` or `$` normal mode commands
|
|
|
|
|
(See <<keys#,`:doc keys`>>).
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
== Value expansions
|
2018-06-03 06:46:44 +02:00
|
|
|
|
|
2018-09-27 07:37:38 +02:00
|
|
|
|
Expansions with the type `val` give access to Kakoune internal data that is
|
|
|
|
|
not stored in an option or a register. Some value expansions can only be used
|
|
|
|
|
in certain contexts, like `%val{hook_param}` that expands to the parameter
|
|
|
|
|
string of the currently-executing hook, and is not available outside a hook.
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-27 07:37:38 +02:00
|
|
|
|
The following expansions are supported (with required context _in italics_):
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%val{buffile}*::
|
2018-09-28 10:01:17 +02:00
|
|
|
|
_in buffer, window scope_ +
|
2018-09-25 08:41:53 +02:00
|
|
|
|
full path of the file or same as `%val{bufname}` when there’s no
|
|
|
|
|
associated file
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%val{buf_line_count}*::
|
2018-09-28 10:01:17 +02:00
|
|
|
|
_in buffer, window scope_ +
|
2018-09-25 08:41:53 +02:00
|
|
|
|
number of lines in the current buffer
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%val{buflist}*::
|
|
|
|
|
quoted list of the names of currently-open buffers (as seen in
|
|
|
|
|
`%val{bufname}`)
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%val{bufname}*::
|
2018-09-28 10:01:17 +02:00
|
|
|
|
_in buffer, window scope_ +
|
2018-09-25 08:41:53 +02:00
|
|
|
|
name of the current buffer
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%val{client_env_X}*::
|
|
|
|
|
_in window scope_ +
|
|
|
|
|
value of the `$X` environment variable in the client displaying the current
|
|
|
|
|
window (e.g. `%val{client_env_SHELL}` is `$SHELL` in the client's
|
|
|
|
|
environment)
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%val{client_list}*::
|
|
|
|
|
unquoted list of the names of clients (as seen in `%val{client}`)
|
|
|
|
|
connected to the current session
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%val{client}*::
|
|
|
|
|
_in window scope_ +
|
|
|
|
|
name of the client displaying the current window
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%val{client_pid}*::
|
|
|
|
|
_in window scope_ +
|
|
|
|
|
process id of the client displaying the current window
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%val{config}*::
|
|
|
|
|
directory containing the user configuration
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%val{count}*::
|
|
|
|
|
_in `map` command <keys> parameter_ +
|
|
|
|
|
current count when the mapping was triggered, defaults to 0 if no
|
|
|
|
|
count given
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%val{cursor_byte_offset}*::
|
|
|
|
|
_in window scope_ +
|
|
|
|
|
offset of the main cursor from the beginning of the buffer (in bytes)
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%val{cursor_char_column}*::
|
|
|
|
|
_in window scope_ +
|
2018-10-09 05:18:21 +02:00
|
|
|
|
1-based offset from the start of the line to the cursor position in
|
|
|
|
|
Unicode codepoints, which may differ from visible columns if the document
|
|
|
|
|
contains full-width codepoints (which occupy two columns) or zero-width
|
|
|
|
|
codepoints
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%val{cursor_char_value}*::
|
|
|
|
|
_in window scope_ +
|
|
|
|
|
unicode value of the codepoint under the main cursor
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%val{cursor_column}*::
|
|
|
|
|
_in window scope_ +
|
2018-10-09 05:18:21 +02:00
|
|
|
|
1-based offset from the start of the line to the first byte of the
|
|
|
|
|
character under the main cursor (in bytes), the fourth component of
|
|
|
|
|
`%val{selection_desc}`
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%val{cursor_line}*::
|
|
|
|
|
_in window scope_ +
|
|
|
|
|
line of the main cursor, the third component of `%val{selection_desc}`
|
2018-09-20 04:46:52 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%val{history_id}*::
|
2018-09-28 10:01:17 +02:00
|
|
|
|
_in buffer, window scope_ +
|
2018-09-25 08:41:53 +02:00
|
|
|
|
history id of the current buffer, an integer value which refers to a
|
|
|
|
|
specific buffer version in the undo tree (see also `%val{timestamp}`)
|
2018-04-03 13:33:30 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%val{hook_param_capture_n}*::
|
|
|
|
|
_in `hook` command <command> parameter_ +
|
|
|
|
|
text captured by capture group _n_, if the executing hook's filter regex
|
|
|
|
|
used capture groups
|
2018-05-31 13:14:21 +02:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%val{hook_param}*::
|
|
|
|
|
_in `hook` command <command> parameter_ +
|
|
|
|
|
the complete parameter string of the executing hook
|
2016-02-02 20:15:12 +01:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%val{modified}*::
|
2018-09-28 10:01:17 +02:00
|
|
|
|
_in buffer, window scope_ +
|
2018-09-25 08:41:53 +02:00
|
|
|
|
`true` if the buffer has modifications not saved, otherwise `false`
|
|
|
|
|
|
|
|
|
|
*%val{register}*::
|
|
|
|
|
_in `map` command <keys> parameter_ +
|
|
|
|
|
current register when the mapping was triggered
|
|
|
|
|
|
|
|
|
|
*%val{runtime}*::
|
|
|
|
|
directory containing the kak support files, determined from Kakoune's
|
|
|
|
|
binary location
|
|
|
|
|
|
|
|
|
|
*%val{selection}*::
|
|
|
|
|
_in window scope_ +
|
|
|
|
|
content of the main selection
|
|
|
|
|
|
|
|
|
|
*%val{selections}*::
|
|
|
|
|
_in window scope_ +
|
|
|
|
|
quoted list of the contents of all selections
|
|
|
|
|
|
|
|
|
|
*%val{selection_desc}*::
|
|
|
|
|
_in window scope_ +
|
2018-10-09 05:18:21 +02:00
|
|
|
|
range of the main selection, represented as `a.b,c.d` where _a_ is the
|
|
|
|
|
anchor line, _b_ is the number of bytes from the start of the line to the
|
|
|
|
|
anchor, _c_ is the cursor line (like `%val{cursor_line}`), _d_ is
|
|
|
|
|
the number of bytes from the start of the line to the cursor (like
|
|
|
|
|
`%val{cursor_column}`), and all are 1-based decimal integers
|
2018-09-25 08:41:53 +02:00
|
|
|
|
|
|
|
|
|
*%val{selections_desc}*::
|
|
|
|
|
_in window scope_ +
|
|
|
|
|
unquoted list of the ranges of all selections, in the same format as
|
|
|
|
|
`%val{selection_desc}`
|
|
|
|
|
|
2018-10-20 12:36:41 +02:00
|
|
|
|
*%val{selection_length}*::
|
|
|
|
|
_in window scope_ +
|
|
|
|
|
length (in codepoints) of the main selection
|
|
|
|
|
|
|
|
|
|
*%val{selections_length}*::
|
|
|
|
|
_in window scope_ +
|
|
|
|
|
unquoted list of the lengths (in codepoints) of the selections
|
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%val{session}*::
|
|
|
|
|
name of the current session
|
|
|
|
|
|
|
|
|
|
*%val{source}*::
|
|
|
|
|
_in `.kak` file_ +
|
|
|
|
|
path of the file currently getting executed (through the source command)
|
|
|
|
|
|
|
|
|
|
*%val{text}*::
|
|
|
|
|
_in `prompt` command <command> parameter_ +
|
|
|
|
|
the text entered by the user in response to the `prompt` command
|
|
|
|
|
|
|
|
|
|
*%val{timestamp}*::
|
2018-09-28 10:01:17 +02:00
|
|
|
|
_in buffer, window scope_ +
|
2018-09-25 08:41:53 +02:00
|
|
|
|
timestamp of the current buffer, an integer that increments each time the
|
|
|
|
|
buffer is modified, including undoing and redoing previous modifications
|
|
|
|
|
(see also `%val{history_id}`)
|
|
|
|
|
|
|
|
|
|
*%val{user_modes}*::
|
|
|
|
|
unquoted list of user modes.
|
|
|
|
|
|
|
|
|
|
*%val{version}*::
|
|
|
|
|
version of the current Kakoune server (git hash or release name)
|
2018-01-23 05:59:46 +01:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%val{window_height}*::
|
|
|
|
|
_in window scope_ +
|
|
|
|
|
height of the current Kakoune window
|
2016-02-02 20:15:12 +01:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
*%val{window_width}*::
|
|
|
|
|
_in window scope_ +
|
|
|
|
|
width of the current Kakoune window
|
2017-11-02 03:03:24 +01:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
Values in the above list that do not mention a context are available
|
2018-09-28 10:01:17 +02:00
|
|
|
|
everywhere.
|
2016-02-10 22:03:49 +01:00
|
|
|
|
|
2018-09-25 08:41:53 +02:00
|
|
|
|
A value described as a "quoted list" will follow the rules of Kakoune string
|
|
|
|
|
quoting (See <<command-parsing#,`:doc command-parsing`>>). An "unquoted list"
|
|
|
|
|
cannot contain any special characters that would require quoting.
|