[issue44837] os.symlink arg names are bad

2021-08-05 Thread krey
krey added the comment: @eric.smith Fair enough, though the impact would probably be quite low in reality. Nobody seems to pass these args by keyword: https://github.com/search?q=%22os.symlink(src%3D%22=Code @steven.daprano My suggestion was changing the names of the args, not the order

[issue44837] os.symlink arg names are bad

2021-08-05 Thread krey
krey added the comment: OK, let's ignore the analogy. Everywhere else I've seen, arrows (or directed edges in a graph) point as SOURCE -> TARGET SOURCE -> DESTINATION (TARGET and DESTINATION are synonymous in this context) An example from math: https://en.wikipedia.org/wiki/Cat

[issue44837] os.symlink arg names are bad

2021-08-05 Thread krey
krey added the comment: @eric.smith Sorry for tagging this as docs, wasn't sure what to pick. I guess it should be under Library Does CPython have a process for changing arg names via deprecation warnings? -- ___ Python tracker <ht

[issue44837] os.symlink arg names are bad

2021-08-05 Thread krey
New submission from krey : From: https://docs.python.org/3/library/os.html os.symlink(src, dst, target_is_directory=False, *, dir_fd=None) Create a symbolic link pointing to `src` named `dst`. It's a bit like saying find(needle, haystack) Finds `haystack` in `needle` If you look