Re: Docstring of make-symbolic-link

[Paul Eggert]

On 6/11/19 7:22 AM, Eli Zaretskii wrote:
> This appears to be some kind of copy-pasta from add-name-to-file,
> which creates a hard link.

Yes, and that's a good thing because hard links and symbolic links are 
similar here.

We should use "NEWNAME" here, not merely for consistency with 
add-name-to-file, but also because using "NEWNAME" makes it clearer that 
it's the thing being created instead of TARGET. It's all too easy to 
misread "(make-symbolic-link TARGET LINKNAME)" as meaning that TARGET 
gets created with the contents LINKNAME, which is the opposite of what 
the function actually does.