Documentation "Select" command switch order incorrect

rps

Jul 6, 2008
436
6
The help documentation shows switch order:

SELECT [/1 /A[[:][-][+]rhsadecijopt] /C /D /E /H /I"text" /J /L /O........
which doesn't work as documented

Code:
D:\bat>select /a:-r /i"[]" describe (*)
TCC: (Sys) The parameter is incorrect.
"i"[]""
Usage : SELECT [/A[[:][-][+]rhsdaecjot] /CDEH /I"text" /JL /O[[:][-]acdeginorsu] /Q /T:acw /XZ /1] [command ] ... (files...) ...

D:\bat>select /a:-r /i"*4nt*" describe (*)
TCC: (Sys) The parameter is incorrect.
 "i"*4nt*""
Usage : SELECT [/A[[:][-][+]rhsdaecjot] /CDEH /I"text" /JL /O[[:][-]acdeginorsu] /Q /T:acw /XZ /1] [command ] ... (files...) ...
Using the following order works.

Code:
D:\bat>select /i"[]" /a:-r describe (*)

D:\bat>select /i"*4nt*" /1 describe (*)

D:\bat>select /i"*4nt*" /a:-r describe (*)
I also tested the /1 /c /d /e /h switches and received the same error message when they proceed
/I"text".
Recommend the /i"text" precede the /1 /A... /C /D /E /H in the docs.

This issue exists with both V16.03.55 x64 and V17.00.53 x64
 
Jun 2, 2008
376
2
Newton, MA
So I changed them to be in alphabetical order, and nobody's complained since (until now).

That is perhaps fine for the listing at the beginning of the help (under "Format"), but there ought at least to be a note somewhere (probably right under that and certainly with the description of the individual switch) explaining any special requirement on the order. If I remember correctly, you do that for the range switches.

In fact, it might be good to have a section after "Format" section that explains any limitations on the order of parameters and switches for any commands with such limitations.
 

rconn

Administrator
Staff member
May 14, 2008
12,340
149
That is perhaps fine for the listing at the beginning of the help (under "Format"), but there ought at least to be a note somewhere (probably right under that and certainly with the description of the individual switch) explaining any special requirement on the order. If I remember correctly, you do that for the range switches.

In fact, it might be good to have a section after "Format" section that explains any limitations on the order of parameters and switches for any commands with such limitations.

It already does -- /I is a range, and the help for SELECT says "Ranges must appear immediately after the SELECT keyword."
 

rps

Jul 6, 2008
436
6
WAD -- once upon a time I put the options in the order of their use, and got endless complaints & bug reports that the options were missing or out of order. So I changed them to be in alphabetical order, and nobody's complained since (until now).

Not intended as a complaint, just trying to offer constructive suggestions. :coldfeet:

That is perhaps fine for the listing at the beginning of the help (under "Format"), but there ought at least to be a note somewhere (probably right under that and certainly with the description of the individual switch) explaining any special requirement on the order. If I remember correctly, you do that for the range switches.

In fact, it might be good to have a section after "Format" section that explains any limitations on the order of parameters and switches for any commands with such limitations.

It already does -- /I is a range, and the help for SELECT says "Ranges must appear immediately after the SELECT keyword."
Ok, my OP has apparently caused more controversy than necessary considering the intent is to offer suggestions that improve TCMD/TCC.

We have already typed more lines of text than would have been required to clarify the help. I totally missed the fact that /I is a description range documented in : TCC > File Selection > Ranges > Description Ranges.

Enough said, it is your product, so do what you think best. :cool:
 
Similar threads
Thread starter Title Forum Replies Date
WavSlave Fixed Escaping out of SELECT sometimes still executes the command Support 2
B Select and run lines from Command Input panel? Support 1
Phileosophos SELECT command opens additional tab Support 9
R @select inside alias gives different (insanely small) window Support 7
Joe Caverly Windows Terminal and @SELECT Support 13
WinLanEm @SELECT problem Support 6
T @select and @selectarray issues Support 2
C How to? Select 100 random pictures from 30,000 Support 8
MikeBaas How to? SELECT: exclude files / display prompt Support 2
mikea How to? @select[] window size, redux. Support 3
vefatica IDE double-click select? Support 29
gschizas How to? How can I use select with a folder that already contains parentheses? Support 7
T How to? Select and Delete text Support 6
mikea How to? Understanding @select[] Support 2
vhodro How to? Select text Support 10
nikbackm Fixed v15: Issue with @select Support 3
G Fixed v15.00.27: @SELECT Support 10
D ini directives and @select example in Help Support 0
ehab aboudaya How to? Copy to clipboard on select Support 5
S SELECT DEL (*D.DLL) - output curious Support 8
vefatica Positioning @SELECT[] popup? Support 3
WadeHatler Any way to restore the Text Based "Select File" Windows in TCC Support 2
Stefano Piccardi how to @SELECT redirected input? Support 4
Joe Caverly Error when sorting list alphabetically for @select Support 2
S SELECT - does it support ranges? Support 2
nikbackm @select function and TAB characters Support 1
Joe Caverly @select like 4DOS Support 1
D Can you feed a file list to SELECT? Support 1
A @select versio 10.31 Support 1
nikbackm @select window problem Support 12
D Can alias pass parameters to for command? Support 3
samintz How to? Search for %(command) in Help? Support 1
T VIEW only works from command line Support 14
rconn News Take Command / TCC / CMDebug / TCC-RT v28 Released Support 0
T Take Command 28: Lua reports version 5.4.0 (5.4.3 expected) Support 0
Jay Sage WAD Possible Bug With OPTION Command With @FILE Support 5
rconn News Take Command / TCC / CMDebug / TCC-RT 27.01.24 uploaded Support 0
J Take command does not start on Windows 10 Support 3
vefatica `Back quotes` - command line vs. batch file Support 5
Jay Sage WAD Failure of Alias Command with /Z Option Support 14
Phileosophos Is there any way to open the Take Command options dialog from the command line? Support 8
Phileosophos Command-line Editing Shortkeys That Fail Support 6
fpefpe How to? free (internal) command Support 0
rconn News Take Command / TCC / CMDebug / TCC-RT 27.01.23 uploaded Support 0
T How to? retain command history across reboot? Support 6
rconn News Take Command / TCC / CMDebug / TCC-RT v27.01 Build 22 Uploaded Support 0
Jay Sage Bug With Flow Control and/or Command Grouping Support 2
GermanDirk How to? EVENTLOG Command with simple User Rights not functional Support 4
Jay Sage Take Command Is Too Fast! Support 4
Jay Sage Comparison of IF with Command Group and IFF Support 6

Similar threads