Context: Emacs version 29.0.60 ; function goto-char
An example of misleading symbol/function naming making it necessary to consult the documentation in order to use it the right way is the Emacs function goto-char
.
The function name suggests that there is movement involved (go to), so the expected outcome can be intuitively deducted as moving the point to a position in a buffer. This turns out to be actually the case and what the function does. OK.
The misleading part of the symbol/function naming is the term char
, because the spoken language meaning of 'go to a character' suggests movement to a single given character, where the function actually takes an integer value specifying a position in a buffer to which the point is to move.
A more meaningful naming for example goto-position
or goto-pos
instead of goto-char
would make it possible to use the function the proper way without the necessity of consulting its documentation first.
In this context, my question is:
Do contributors to Emacs code intend to implement more meaningful symbol naming in future Emacs versions?
goto-char
's name can be confusing to newcomers. BUT that's not the question to ask here, you should ask Emacs developers. Most community volunteers cannot answer such questions.