From cc2ca60baaec4b686c1c2bb0ac7824252ee36a2e Mon Sep 17 00:00:00 2001 From: Johannes Altmanninger Date: Mon, 5 May 2025 14:49:01 +0200 Subject: [PATCH] commandline.rst: deprecate --tokens-raw option This was added without a use case. Now there is a use case (#11084) that needs it to include all tokens which the sister option "--tokens-expanded" should not do. The inconsistency is probably not worth it, given that this "--tokens-raw" use case can be served by a future "read -zal --tokenize-raw". --- doc_src/cmds/commandline.rst | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/doc_src/cmds/commandline.rst b/doc_src/cmds/commandline.rst index c81784d8a..942eeaf4c 100644 --- a/doc_src/cmds/commandline.rst +++ b/doc_src/cmds/commandline.rst @@ -90,10 +90,7 @@ The following options change the way ``commandline`` prints the current commandl Perform argument expansion on the selection and print one argument per line. Command substitutions are not expanded but forwarded as-is. -**--tokens-raw** - Print arguments in the selection as they appear on the command line, one per line. - -**-o** or **tokenize** +**-o**, **tokenize**, **--tokens-raw** Deprecated; do not use. If ``commandline`` is called during a call to complete a given string using ``complete -C STRING``, ``commandline`` will consider the specified string to be the current contents of the command line.