emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Docstring of make-symbolic-link


From: Juanma Barranquero
Subject: Docstring of make-symbolic-link
Date: Mon, 10 Jun 2019 21:44:46 +0200

make-symbolic link uses NEWNAME in its docstring, but LINKNAME as the
argument name:

  (make-symbolic-link TARGET LINKNAME &optional OK-IF-ALREADY-EXISTS)

  Make a symbolic link to TARGET, named NEWNAME.
  If NEWNAME is a directory name, make a like-named symbolic link under
  NEWNAME.

  [etc...]

The easiest way to fix it is to change NEWNAME to LINKNAME in the
docstring, but I think NEWNAME is the preferred name, and it is also
used in the info files.

The alternative is to change linkname to newname in the code, and
encoded_linkname to encoded_newname (not required, but for
consistency).

It is a trivial change, but as it touches code in 26.2.50, better safe
than sorry. So, newname everywhere, or linkname everywhere (including
the info files)?



reply via email to

[Prev in Thread] Current Thread [Next in Thread]