Subject: bug#64328: 28.2; describe-function shows wrong arguments

From: Eli Zaretskii <[email-masked]>
Date: Wed, 28 Jun 2023 19:34:55 +0300

tags 64328 notabug
thanks

> From: [email-masked]
> Date: Wed, 28 Jun 2023 18:25:15 +0200
> 
> I have noticed that describe-function sometimes shows wrong arguments.
> Example:
> 
> (describe-function 'call-process-shell-command)
> 
> shows
> 
> (call-process-shell-command COMMAND &optional INFILE BUFFER DISPLAY)
> 
> but the function is defined as follows:
> 
> (defun call-process-shell-command (command &optional infile buffer display
> 					   &rest args)

That's on purpose: we want the function to be called as
describe-function says, not as the source code says.  This is called
"advertised calling convention".

This is not a bug.