From 99f7ed5726a71703030ded698c7fa2f14d9f068e Mon Sep 17 00:00:00 2001
From: Valerie Wolfe <sleeplessval@gmail.com>
Date: Thu, 22 Aug 2024 10:14:58 -0400
Subject: [PATCH] man: added missing information to cmd man page

---
 man/cmd.8 | 34 ++++++++++++++++++++++++++++------
 1 file changed, 28 insertions(+), 6 deletions(-)

diff --git a/man/cmd.8 b/man/cmd.8
index 7914a6e..7814c4f 100644
--- a/man/cmd.8
+++ b/man/cmd.8
@@ -8,7 +8,7 @@
 .Nm
 .Op Fl DQ
 .Op Fl A|U
-.Op Fl C|K Ar command
+.Op Oo Fl S Oc Fl C|K Ar command
 .Op Fl E Ns = Ns Ar ON|OFF
 .Op Fl T Ns = Ns Ar fb
 .Op Fl V Ns = Ns Ar ON|OFF
@@ -16,28 +16,40 @@
 .Nm
 is a Linux wrapper for Windows Command Prompt. Its options are as follows:
 .Bl -tag -width Ds
+.It Fl ?
+Displays a fairly unhelpful and incomplete help text.
 .It Fl A
 Standard outputs will be redirected in ANSI.
 .It Fl C Ar command
 Executes the specified command and exits.
 .It Fl D
-Disables autorun commands.
+Disables autorun commands. See
+.Sx AUTORUN
+below.
 .It Fl E Ns = Ns Ar ON|OFF
-Enable or disable command extensions.
+Enable or disable command extensions. See
+.Sx COMMAND EXTENSIONS
+below.
 .It Fl F Ns = Ns Ar ON|OFF
-Enable or disable filename completion.
+Enable or disable filename completion. See
+.Sx FILENAME COMPLETION
+below.
 .It Fl K Ar command
 Executes the specified command, then become interactive.
 .It Fl Q
 Disables echoing commands for non-interactive modes.
 .It Fl S
-(TODO) command string modifier?
+Modifies input handling. See
+.Sx MODIFIED INPUT HANDLING
+below.
 .It Fl T Ns = Ns Ar fb
 Output will use colors as if 'color xx' was called; the first digit sets the foreground color, and the second digit sets the background color.
 .It Fl U
 Standard outputs will be redirected in Unicode.
 .It Fl V Ns = Ns Ar ON|OFF
-Enable or disable execution-time environment variable expansion.
+Enable or disable execution-time environment variable expansion. See
+.Sx EXECUTION-TIME ENVIRONMENT VARIABLE EXPANSION
+below.
 .Sh BEHAVIORS
 .Ss AUTORUN
 Autorun is enabled by default, and can be disabled with the
@@ -78,6 +90,16 @@ If enabled, enclosing a variable name with '!' characters will substitute the va
 Filename completion is disabled by default, and can be enabled by setting
 .Fl F Ns = Ns ON .
 If enabled, Ctrl-D and Ctrl-F can be used for directory and file completion respectively.
+.Ss MODIFIED INPUT HANDLING
+If the
+.Fl S
+flag is present, the program will strip the leading and trailing quotes from the
+.Ar command
+supplied to
+.Fl C
+or
+.Fl K
+and pass the remaining string literally as if it was typed directly into the prompt, ignoring special characters.
 .Sh BUGS
 .Nm
 lacks escape characters, meaning arguments with special characters