[New-bugs-announce] [issue44837] os.symlink arg names are bad

[krey]

New submission from krey <python at mail.lordking.pro>:

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 at the manpage ln, it says
ln [OPTION]... [-T] TARGET LINK_NAME

So os.symlink isn't consistent with ln

----------
assignee: docs at python
components: Documentation
messages: 398977
nosy: docs at python, krey
priority: normal
severity: normal
status: open
title: os.symlink arg names are bad
type: enhancement
versions: Python 3.9

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue44837>
_______________________________________