Re: [PATCH] doc: missing parameter expansion operators in bash(1)
From:
Connor Wilkins
Subject:
Re: [PATCH] doc: missing parameter expansion operators in bash(1)
Date:
Fri, 29 Aug 2025 16:32:28 +0000
On Friday, August 29, 2025 10:02 AM, Martin D Kealy wrote:
> On Thu, 28 Aug 2025, 03:40 Chet Ramey,
> <chet.ramey@case.edu<mailto:chet.ramey@case.edu>> wrote:
>> This has never been documented.
> If that's true, how are there scripts using it, and people asking about it?
> It's not just documentation that you've written that needs to be considered,
> because clearly this feature must be mentioned SOMEWHERE.
I found this feature on accident by experimenting, then I looked into
it and found the feature was introduced in bash-4.3 (iirc).
Interestingly enough I cannot find the reference now.
>> In theory, since it's never been documented, I could flip the define in
>> config-top.h and disable it by default.
> This assumption is the root of the problem.
> If it's not documented, then as far as some ordinary users are concerned, it
> is NOT deprecated. "The user is wrong" is not an acceptable response to an
> inadequacy of documentation.
I tend to agree with this... If you're not communicating the fact that
a feature is deprecated then how is a typical user to know that?
---
Flipping to something Stan Marsh wrote about deprecation:
On 8/27/25 12:30 PM, Stan Marsh wrote:
>> Connor wrote:
>> I'm of the opinion that if there is a supported feature with no plans for
>> deprecation
>> or removal, it should be documented. Even if it's not widely used, it's still
>> supported with (as you said) no plans for removal. reply via email to
> I'm of the opinion that the feature in question *is* deprecated and is *not*
> supported, and could be removed at some future date. It is just that there
> are no
> plans to do - at the moment.
>This is how deprecation works. You take as long as it takes to get people to
>stop
> using it (*), and then at some point you pull the trigger.
Following this logic, it seems what Stan is saying is that this feature has
been deprecated _since its release_ simply because it was never documented.
It seems Chet is saying something similar here:
>> In theory, since it's never been documented, I could flip the define in
>> config-top.h and disable it by default.
I personally think that's an absurd notion. Features deprecated on release?