1
0
Fork 0
mirror of git://git.code.sf.net/p/cdesktopenv/code synced 2025-03-09 15:50:02 +00:00
cde/src/cmd/ksh93/bltins
Martijn Dekker fa6a180fdd test/[: remove effectively inaccessible self-doc
Did you know that you could get a manual page for the 'test'/'['
builtin command using one of these strange command lines?

	test --man --

	[ --man -- ]

Neither did I. It's not documented or mentioned anywhere (and this
syntax violates POSIX). So nobody knows about it, which makes that
documentation useless. (The regular --man option doesn't work
because that would break 'test'.) I only found out how to invoke it
when I understood what the uncommented C code handling this does.

The test/[ command's self-documentation is unmaintained since 2003
and somewhat incomplete. It's also mostly redundant with the
documentation on Conditional Expressions in the main (k)sh.1 manual
page. But unlike the latter, this is resident in RAM, wasting
working memory in every shell process.

src/cmd/ksh93/sh.1:
- Add documentation for 'test'/'[' commands (yes, they were not
  mentioned in the main manual page until now), describing them
  in terms of differences from '[[' and recommending the latter.

src/cmd/ksh93/include/test.h,
src/cmd/ksh93/bltins/test.c,
src/cmd/ksh93/data/testops.c:
- Remove RAM-resident --man doc for test/[ command.
- Remove the bizarre option parsing that allowed invoking it.
2020-08-30 08:08:01 +01:00
..
alarm.c Version: 2012-08-01-master 2016-01-11 15:54:23 -05:00
cd_pwd.c Fix incorrect behavior of 'cd ../.foo' (#46) 2020-06-26 23:36:29 +01:00
cflow.c Fix regression in 'return' introduced by 98e0fc94 2020-06-12 01:45:17 +02:00
enum.c '#if 0' cleanup 2020-08-30 04:51:20 +01:00
getopts.c Version: 2012-08-01-master 2016-01-11 15:54:23 -05:00
hist.c Make the 'history' and 'r' commands builtins (#76) 2020-07-16 18:56:49 +01:00
misc.c Fix leak and crash upon defining functions in subshells 2020-08-14 00:25:31 +01:00
mkservice.c '#if 0' cleanup 2020-08-30 04:51:20 +01:00
print.c '#if 0' cleanup 2020-08-30 04:51:20 +01:00
read.c SHOPT_MULTIBYTE-related cleanup (re: 8477d2ce) 2020-08-30 04:50:57 +01:00
regress.c Fix 47 typos in user-facing help and error messages 2020-06-12 01:45:12 +02:00
sleep.c Fix how unrecognized options are handled in 'sleep' and 'suspend' (#93) 2020-07-26 02:18:49 +01:00
test.c test/[: remove effectively inaccessible self-doc 2020-08-30 08:08:01 +01:00
trap.c Fix how unrecognized options are handled in 'sleep' and 'suspend' (#93) 2020-07-26 02:18:49 +01:00
typeset.c Make liblist an extern to fix dtksh compile (#108) 2020-08-05 22:18:22 +01:00
ulimit.c Version: 2012-08-01-master 2016-01-11 15:54:23 -05:00
umask.c Version: 2012-08-01-master 2016-01-11 15:54:23 -05:00
whence.c whence -a/type -a: report both function and built-in by same name 2020-07-20 21:16:24 +01:00