pet peeve: the help text for `ln` (for making symlinks and such) describes the two file path parameters as `source_file` and `target_file`, rather than `link_path` and `existing_file`.
@gsuberland yep it took me about 20 years to internalise the order, and I still get it wrong sometimes.
@jpm @gsuberland But also a special place in hell for the person who made mklink on Windows who thought "the order of arguments for ln is annoying, I'm going to fix that", because if you use both Windows and POSIX (as I think Graham does) it's extra fucked up.
every single time I go to use it, I have to expend cognitive effort trying to figure out which way around it's supposed to be.
after posting this and thinking carefully about the order for a solid 5 minutes while writing a script, I still got it wrong.
@gsuberland I had to write up a wiki page with some examples.
I think I still got it wrong the first time, but I'm pretty sure this version is correct. (Pardon the dilapidated state of the site; my life is overcomplicated, pls send help.)