bug-gnu-emacs
[Top][All Lists]
Advanced

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

bug#31191: 26.1; [PATCH] Improve docstring of start-process-shell-comman


From: Noam Postavsky
Subject: bug#31191: 26.1; [PATCH] Improve docstring of start-process-shell-command
Date: Tue, 17 Apr 2018 09:06:23 -0400
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/26.1 (gnu/linux)

Damien Cassou <address@hidden> writes:

> Noam Postavsky <address@hidden> writes:
>>> +\(fn NAME BUFFER COMMAND)"
>>>    (declare (advertised-calling-convention (name buffer command) "23.1"))
>>
>> I think this is redundant since advertised-calling-convention already
>> does the same.
>
> you are right, thank you. I didn't know about that and helpful does not
> take it into account (I've just reported the issue).
>
> What is the preferred way to advertise a signature, the declare form or
> a last line in the docstring? If you answer the question, I can fix the
> manual to add links between (info "(elisp) Declare Form") and (info
> "(elisp) Function Documentation").

The advertised-calling-convention declaration should be used when you
want the old way of calling to trigger a warning during byte
compilation.  Otherwise, the docstring method should be used.






reply via email to

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