[Top][All Lists]

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

Re: [Emacs-diffs] emacs-25 c2ba4a2: ; Added documentation for undo-auto

From: Phillip Lord
Subject: Re: [Emacs-diffs] emacs-25 c2ba4a2: ; Added documentation for undo-auto functionality.
Date: Thu, 03 Dec 2015 17:34:54 +0000
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/24.5 (gnu/linux)

John Wiegley <address@hidden> writes:

> <#secure method=pgpmime mode=sign>
>>>>>> Eli Zaretskii <address@hidden> writes:
>> This commit documents internal functions and variables. IMO, if we think
>> they deserve being documented (and I think I agree), they shouldn't be
>> internal in the first place.
> If they're truly internal, I don't think they should be documented in
> elisp.texi. Sufficient documentation is provided for such functions via the
> docstring.
> If one feels they do belong in elisp.texi, they shouldn't be internal, as Eli
> indicates.
> In a sense, elisp.texi defines our "Emacs Lisp API" to programmers, so
> anything we document there represent a certain level of commitment.

Yeah, think that's true. I made them internal but then when I was
writing the documentation thought perhaps they should be documented.
Deciding what is "end-user" functionality and what is "implementation"
gets a bit hard when you are talking about code of this form.

I'll patch them up and make these two non internal.


reply via email to

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