Improve help text about Multi-Rename Tool placeholders [A] and [I]

Here you can propose new features, make suggestions etc.

Moderators: Hacker, petermad, Stefan2, white

Post Reply
User avatar
white
Power Member
Power Member
Posts: 5895
Joined: 2003-11-19, 08:16 UTC
Location: Netherlands

Improve help text about Multi-Rename Tool placeholders [A] and [I]

Post by *white »

I think the placeholders [A] and [I] of the Multi-Rename Tool deserve a better explanation in the help, and that [I] is better placed directly below [A]. And I think it becomes much more helpful when mentioning what it can be used for and how. Below is my suggested update.

Current text:
Here is a description of all available placeholders. IMPORTANT: Upper/lowercase is relevant!
[N] Old file name, WITHOUT extension
[N1] The first character of the original name
[N2-5] Characters 2 to 5 from the old name (totals to 4 characters). Double byte characters (e.g. Chinese, Japanese) are counted as 1 character! The first letter is accessed with '1'.
[N2,5] 5 characters starting at character 2
[N2-] All characters starting at character 2
[N02-9] Characters 2-9, fill from left with zeroes if name shorter than requested (8 in this example): "abc" -> "000000bc"
[N 2-9] Characters 2-9, fill from left with spaces if name shorter than requested (8 in this example): "abc" -> " bc"
[N-8,5] 5 characters starting at the 8-last character (counted from the end of the name)
[N-8-5] Characters from the 8th-last to the 5th-last character
[N2--5] Characters from the 2nd to the 5th-last character
[N-5-] Characters from the 5th-last character to the end of the name
[A] Old file name, WITH extension (All characters of the name), without the path
[2-5] Characters 2-5 from the name INCLUDING path and extension (other numbers as in [N] definition)
[P] Paste name of the parent directory, e.g. when renaming c:\directory\file.txt -> pastes "directory".
Also working: [P2-5], [P2,5], [P-8,5], [P-8-5] and [P2-], see description of [N] above.
[G] Grandparent directory (usage: see [P]).
[B0]..[B9] Paste a directory from the path: [B0]=[P],[B1]=[G],[B2]=great grandparent directory etc.
For partial ranges, the following syntax may be used: [B2_2-5] characters 2 to 5 from the great grandparent directory
[B+0]..[B+9]
Paste a directory from the path, starting from the left: [B+0]=drive letter, [B+1]=first directory etc.
For partial ranges, the following syntax may be used: [B+1_2-5] characters 2 to 5 from the first directory
[E] Extension
[E1-2] Characters 1-2 from the extension (same ranges as in [N] definition)
[I] Ignore dots in folder names from this point forward, so [N] contains the entire folder name, and [E] is empty (no influence on files).
If inserted again, don't ignore dots in folder names any more from that point forward.
Suggestion:
Here is a description of all available placeholders. IMPORTANT: Upper/lowercase is relevant!
[N] Old file name, WITHOUT extension
[N1] The first character of the original name
[N2-5] Characters 2 to 5 from the old name (totals to 4 characters). Double byte characters (e.g. Chinese, Japanese) are counted as 1 character! The first letter is accessed with '1'.
[N2,5] 5 characters starting at character 2
[N2-] All characters starting at character 2
[N02-9] Characters 2-9, fill from left with zeroes if name shorter than requested (8 in this example): "abc" -> "000000bc"
[N 2-9] Characters 2-9, fill from left with spaces if name shorter than requested (8 in this example): "abc" -> " bc"
[N-8,5] 5 characters starting at the 8-last character (counted from the end of the name)
[N-8-5] Characters from the 8th-last to the 5th-last character
[N2--5] Characters from the 2nd to the 5th-last character
[N-5-] Characters from the 5th-last character to the end of the name
[A] File or folder name including extension. Mostly useful when renaming folders (e.g. file name mask: [A2-5], extension mask: <empty>). ←
→ [I] Alters placeholders [N] and [E] to stop treating folders as if they have extensions, ensuring that for folders, [N] represents the full name and [E] is empty. Its placement determines when the feature is enabled. Using it repeatedly turns the feature on and off. Useful for renaming operations intended for both files and folders (e.g. file name mask: [I][N2-5], extension mask: [E]). ←
[2-5] Characters 2-5 from the name INCLUDING path and extension (other numbers as in [N] definition)
[P] Paste name of the parent directory, e.g. when renaming c:\directory\file.txt -> pastes "directory".
Also working: [P2-5], [P2,5], [P-8,5], [P-8-5] and [P2-], see description of [N] above.
[G] Grandparent directory (usage: see [P]).
[B0]..[B9] Paste a directory from the path: [B0]=[P],[B1]=[G],[B2]=great grandparent directory etc.
For partial ranges, the following syntax may be used: [B2_2-5] characters 2 to 5 from the great grandparent directory
[B+0]..[B+9]
Paste a directory from the path, starting from the left: [B+0]=drive letter, [B+1]=first directory etc.
For partial ranges, the following syntax may be used: [B+1_2-5] characters 2 to 5 from the first directory
[E] Extension
[E1-2] Characters 1-2 from the extension (same ranges as in [N] definition)
User avatar
ghisler(Author)
Site Admin
Site Admin
Posts: 50703
Joined: 2003-02-04, 09:46 UTC
Location: Switzerland
Contact:

Re: Improve help text about Multi-Rename Tool placeholders [A] and [I]

Post by *ghisler(Author) »

Thanks for your suggestion, that explains these placeholders better.
Author of Total Commander
https://www.ghisler.com
Post Reply