GNU bug report logs - #31191
26.1; [PATCH] Improve docstring of start-process-shell-command

Previous Next

Package: emacs;

Reported by: Damien Cassou <damien <at> cassou.me>

Date: Tue, 17 Apr 2018 11:40:02 UTC

Severity: minor

Tags: patch

Found in version 26.1

Done: Noam Postavsky <npostavs <at> gmail.com>

Bug is archived. No further changes may be made.

Forwarded to https://github.com/Wilfred/helpful/issues/104

Full log

View this message in rfc822 format

From: Damien Cassou <damien <at> cassou.me>
To: Noam Postavsky <npostavs <at> gmail.com>
Cc: 31191 <at> debbugs.gnu.org
Subject: bug#31191: 26.1; [PATCH] Improve docstring of start-process-shell-command
Date: Tue, 17 Apr 2018 15:45:16 +0200


On April 17, 2018 3:06:23 PM GMT+02:00, Noam Postavsky <npostavs <at> gmail.com> wrote:
>Damien Cassou <damien <at> cassou.me> writes:
>> 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.

Thank you. Can you please close this issue? I will send a patch within another report.
-- 
Damien Cassou
http://damiencassou.seasidehosting.st

"Success is the ability to go from one failure to another without
losing enthusiasm." --Winston Churchill
This bug report was last modified 7 years and 94 days ago.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.