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
--
Karel Zak <kzak@xxxxxxxxxx>
http://karelzak.blogspot.com
