[2025-06-30 14:08:01+0200] Karel Zak:
On Sun, Jun 22, 2025 at 05:51:39PM +0200, Benno Schulenberg wrote:
Op 22-06-2025 om 01:26 schreef Haelwenn (lanodan) Monnier:
> == SYNOPSIS
> -*rename* [options] _expression replacement file_...
> +*rename* [options] _original replacement file_...
Yes, the current situation ("expression") is unreadable.
> == DESCRIPTION
> -*rename* will rename the specified files by replacing the first occurrence of _expression_ in their name by _replacement_.
> +*rename* will rename the specified files by replacing the first occurrence of the _original_ substring in their name by _replacement_.
Instead of using the word "original" (where I would first think: original
what?), why not use "substring"? It describes what the thing actually is,
and fits better in the rest of the existing wording.
It seems that in documentation for replace-like functions, it's common
to use "substring", sometimes the function itself uses "substring" in its name
(e.g., awk gsub()).
Haelwenn, do you want to update the patch?
Karel
Yeah, sent a V2, wanted to wait a bit in case there were additional feedback
Best regards
