[Top][All Lists]

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

Re: master b342815: Improve define-function omitted-arg documentation

From: Paul Eggert
Subject: Re: master b342815: Improve define-function omitted-arg documentation
Date: Fri, 27 May 2016 10:52:00 -0700
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.1.0

On 05/27/2016 10:02 AM, Glenn Morris wrote:

IMO all the stuff about t is an internal implementation detail that has
no place in the documentation.
Ach, blast, I see it was mentioned briefly before.

Yes, and I'm afraid the topic needs to be covered in the documentation. I was confused by the old, terser doc, and Eli was I think right in suggesting that define-function's atypical design be covered more clearly.

Alternatively, I suppose we could improve define-function's design....

> Prejudiced against Fortran, are we?

Guilty as charged. :-) Though there were other reasons for that part of the change: the old Fortrannish documentation mentioned gud-find-c-expr, a function that is no longer in GNU Emacs. Plus, the old doc had a complicated song-and-dance about hooks, whereas the new simple.el example is, well, simpler.

> We previously decided against doing this: http://debbugs.gnu.org/8646

Sorry, I wasn't aware of that old decision. I made the change because of a more-recent statement by the current maintainer that we should strive to eliminate warnings rather than continue to live with the current chatter, which too often leads developers to ignore warnings. See:


reply via email to

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