From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: John Wiegley Newsgroups: gmane.emacs.devel Subject: Re: [Emacs-diffs] emacs-25 c2ba4a2: ; Added documentation for undo-auto functionality. Date: Thu, 03 Dec 2015 10:54:17 -0500 Message-ID: References: <83oaeaj5la.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1449158111 2751 80.91.229.3 (3 Dec 2015 15:55:11 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 3 Dec 2015 15:55:11 +0000 (UTC) Cc: Phillip Lord , emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Dec 03 16:55:04 2015 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1a4WDh-00058n-MA for ged-emacs-devel@m.gmane.org; Thu, 03 Dec 2015 16:54:58 +0100 Original-Received: from localhost ([::1]:36147 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a4WDb-0004Xb-Rc for ged-emacs-devel@m.gmane.org; Thu, 03 Dec 2015 10:54:51 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:53822) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a4WDK-0004Wd-In for emacs-devel@gnu.org; Thu, 03 Dec 2015 10:54:37 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1a4WDG-0007hJ-Hw for emacs-devel@gnu.org; Thu, 03 Dec 2015 10:54:34 -0500 Original-Received: from mail-qk0-x235.google.com ([2607:f8b0:400d:c09::235]:33607) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a4WDB-0007fX-HU; Thu, 03 Dec 2015 10:54:25 -0500 Original-Received: by qkas77 with SMTP id s77so31857825qka.0; Thu, 03 Dec 2015 07:54:25 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:in-reply-to:date:message-id:references :user-agent:mail-followup-to:mime-version:content-type; bh=2bnqDjmuF55TayfcdFYnv18H7ndJa5K/XQ2kOOXd69I=; b=Bx+OJAG/S9Bo83MmnURoNZXOgDPf5PuFxIy8KjYWRKc9zpkYgZxGYVwRLcNFhe/767 kwnRtUnmMXx8eGf6iWREni2qmBbMjFJPuclCm7gcAWsQYFCZT//yZ79ctPQafonlPp0t oznKtSt1FqTxVyz0sRQ9y0fiCJ6MsM3848fTLWssz9kBtBK/IuAApOrbYhvI4fgRlt8I MYmuT6Iian7rvOw59VF2drmlDxDBzUdqiJ9bE25hPFJtFaMp4RXhBZiI6zCx55EQExAW 18s++LA6qLMDgNSbFDnf9RyCGDWRUjjXXHgpd4gO5W8tsSowMvdMbpJRgqElQZnSYMbb 27Rg== X-Received: by 10.55.198.204 with SMTP id s73mr6593179qkl.75.1449158065139; Thu, 03 Dec 2015 07:54:25 -0800 (PST) Original-Received: from Hermes-2.local (mail.johnwiegley.com. [208.82.103.192]) by smtp.gmail.com with ESMTPSA id s21sm3533693qkl.36.2015.12.03.07.54.23 (version=TLS1 cipher=AES128-SHA bits=128/128); Thu, 03 Dec 2015 07:54:23 -0800 (PST) X-Google-Original-From: "John Wiegley" Original-Received: by Hermes-2.local (Postfix, from userid 501) id 67EB14AE3B65; Thu, 3 Dec 2015 10:54:22 -0500 (EST) In-Reply-To: <83oaeaj5la.fsf@gnu.org> (Eli Zaretskii's message of "Tue, 01 Dec 2015 22:07:13 +0200") User-Agent: Gnus/5.130014 (Ma Gnus v0.14) Emacs/24.5 (darwin) Mail-Followup-To: Eli Zaretskii , Phillip Lord , emacs-devel@gnu.org X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2607:f8b0:400d:c09::235 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:195817 Archived-At: <#secure method=pgpmime mode=sign> >>>>> Eli Zaretskii 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