On Thu, Apr 21, 2022 at 5:38 PM Junio C Hamano <gitster@xxxxxxxxx> wrote: > Eric Sunshine <sunshine@xxxxxxxxxxxxxx> writes: > > Any of > > the following would likely be less confusing (in no particular order > > of preference): > > > > * sed -i .bak -e '...' "$path" > > * rename dance > > * perl -pi -e ... > > That order happens to match my preference, but if the first one > comes with a comment to dissuade readers to copy-and-paste the > construct to other places in our code, that would be even better. Bikeshedding: I think I would prefer the rename-dance over a lengthy comment meant to dissuade people from copying this non-portable usage, especially since people often fail to read comments. The rename-dance idiom, on the other hand, can be cargo-culted without harm.