[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Emacs-diffs] emacs-25 c2ba4a2: ; Added documentation for undo-auto
|
From: |
John Wiegley |
|
Subject: |
Re: [Emacs-diffs] emacs-25 c2ba4a2: ; Added documentation for undo-auto functionality. |
|
Date: |
Thu, 03 Dec 2015 10:54:17 -0500 |
|
User-agent: |
Gnus/5.130014 (Ma Gnus v0.14) Emacs/24.5 (darwin) |
<#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.
--
John Wiegley GPG fingerprint = 4710 CF98 AF9B 327B B80F
http://newartisans.com 60E1 46C4 BD1A 7AC1 4BA2