Tiny changes in HELP file

[AntonyD]

IMHO

%S insert the names of all selected files into the command line. Names containing spaces will be surrounded by double quotes. Please note the maximum command line length of 32767 characters.
%S10
insert the names of the first 10 selected files (max.) into the command line. Allows you to limit the number of file names passed to the program. You can use any other number.

Should be modified into this:

%S insert the names of all selected files into the command line. Names containing spaces will be surrounded by double quotes. Please note the maximum command line length of 32767 characters.
%S1..%S10
like %S, but only insert the first 1..10(max) names of selected files into the command line. Allows you to limit the number of file names passed to the program.

[ghisler(Author)]

I think that the sentence

You can use any other number.

explains that you can use any other number. It's not limited to 10, so %S1..%S10 is actually wrong. The (max) doesn't mean that 10 is the maximum supported number. It means that a maximum of 10 selected file names will be added. When for example only 5 files are selected and you use %S10, then only those 5 file names will be added.

[AntonyD]

I still did not understand anything from this additional explanation.
And this is despite the fact that you used a whole paragraph of text.
And how did you think that it would be clear from a sentence of 6 words?

Let's try from the other side - 10 is a real limitation, isn't it?
This means that the options for parsing the parameter string using this option
are LITERALLY limited to the following cases:
%S1..%S10
Your code wouldn't parse and use %S23 for example. Isn't it?
So why then should it suddenly be wrong, if this is the case?

[ghisler(Author)]

Your code wouldn't parse and use %S23 for example. Isn't it?

It does parse %S23. If there are 23 or less files selected, TC would insert the names of all files. If there more than 23 files selected, it would insert the names of the first 23.

That's what "insert the names of the first 10 selected files (max.) into the command line." means.

[petermad]

I can see how the" max" can be misunderstod in the curent help.

Maybe something like this would be better:

%S insert the names of all selected files into the command line. Names containing spaces will be surrounded by double quotes. Please note the maximum command line length of 32767 characters.
%Smax insert the names of the first to the "max" selected files (for example %S10 for the first 10 files) into the command line. Allows you to limit the number of file names passed to the program. You can use any other number.

[white]

Maybe something like this would be better:

%Smax insert the names of the first to the "max" selected files (for example %S10 for the first 10 files) into the command line. Allows you to limit the number of file names passed to the program. You can use any other number.

Or:

%S<n> insert the names of the first n selected files into the command line, where n can be any number (for example %S10 for the first 10 files).

[AntonyD]

OK, I vote for %S<n>

[petermad]

%S<n> insert the names of the first n selected files into the command line, where n can be any number (for example %S10 for the first 10 files).

Even better

[AntonyD]

I would just take a number that is not so even and beautiful as an example:
for example %S13 for the first 13 files

P.S.
But while we are in this topic - and there is no AFAIK dialog in Total =
(I am focusing here on the convenience of using the tool!) = displaying
all available env.variables (system, user and internal[from Total's code])
with their already expanded values.
The main question is - why?

And just please don't refer to plugins, scripts, etc. things...

[ghisler(Author)]

2petermad
Your suggestion is good, I will use that with one little change:

(for example %S10 for the first 10 selected files)

It's important that this is for selected files only, not for all files.

[AntonyD]

2ghisler(Author)
please - don't use such a "pretty" number like 10!
Such a number is very simply and unconditionally associated with a certain limit of choice.
Let it be a completely strange number! Like 13, 21 etc...

ALSO it looks like that the HELP section "Keyboard layout" does not cover hotkey
<SHIFT+left/right>
which puts the input focus and cursor in the Command Line.

Section "Command line: keys" contains:

CTRL+CURSORDOWN
or ALT+F8

hotkey explanation. But in all other parts of the HELP we saw the cursors keys
description in a little bit different spelling. SO I suggest to use this one var.:

CTRL+down
or ALT+F8

P.S.
And <ALT+SHIFT+F9 Test archives for integrity> does exist in explanations
but the same and working!!! hotkey <ALT+SHIFT+F6> - does NOT((( WHY?

[petermad]

2ghisler(Author)

It's important that this is for selected files only, not for all files.

I actually think whites's suggestion is better - so maybe change it to:

%S<n> insert the names of the first n selected files into the command line, where n can be any number (for example %S10 for the first 10 selected files).

[white]

I actually think white's suggestion is better..

It's probably what he meant, but probably misread your post to mean that it was your suggestion.

[ghisler(Author)]

Yes, I meant white's suggestion, sorry. I was referring to the mail where petermad commented "Even better".

[AntonyD]

Super! It's really cool that we have understand now correctly each other.
But what about my post/questions/suggestions?
viewtopic.php?p=469080#p469080
and P.S. section in
viewtopic.php?p=469062#p469062