diff options
| author | June McEnroe <june@causal.agency> | 2019-02-24 14:45:12 -0500 |
|---|---|---|
| committer | June McEnroe <june@causal.agency> | 2019-02-24 14:45:12 -0500 |
| commit | 1f9165e3db2c2d3a069a7b45a212f47e5a9babc4 (patch) | |
| tree | ff3019620878b117321097ad8bf46864384c7eec /bin/man1 | |
| parent | Match make targets as Tag (diff) | |
| download | src-1f9165e3db2c2d3a069a7b45a212f47e5a9babc4.tar.gz src-1f9165e3db2c2d3a069a7b45a212f47e5a9babc4.zip | |
Add setopt
Diffstat (limited to 'bin/man1')
| -rw-r--r-- | bin/man1/setopt.1 | 48 |
1 files changed, 48 insertions, 0 deletions
diff --git a/bin/man1/setopt.1 b/bin/man1/setopt.1 new file mode 100644 index 00000000..a148b28f --- /dev/null +++ b/bin/man1/setopt.1 @@ -0,0 +1,48 @@ +.Dd February 24, 2019 +.Dt SETOPT 1 +.Os +. +.Sh NAME +.Nm setopt +.Nd parse command options +. +.Sh SYNOPSIS +.Nm +.Ar optstring +.Op Ar args ... +. +.Sh DESCRIPTION +.Nm +behaves similarly to +.Xr getopt 1 , +except that it produces quoted output +appropriate for use with the +.Nm eval +shell builtin. +This allows arguments containing whitespace +to survive parsing. +. +.Sh EXAMPLES +.Bd -literal -offset indent +args=$(setopt abo: "$@") +eval set -- "$args" +.Ed +. +.Sh SEE ALSO +.Xr getopt 1 , +.Xr sh 1 , +.Xr getopt 3 +. +.Sh HISTORY +The +.Xr getopt 1 +manual page of +.Fx +reads, +.Do +Arguments containing white space +or embedded shell metacharacters +generally will not survive intact; +this looks easy to fix but isn't. +.Dc +Yet here we are. |