From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Kenichi Handa Newsgroups: gmane.emacs.devel Subject: public APIs and private ones (Re: `C-h v' may offer too many symbols) Date: Fri, 11 Mar 2011 13:31:30 +0900 Message-ID: References: <87y64mkdu3.fsf@lifelogs.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1299819014 14833 80.91.229.12 (11 Mar 2011 04:50:14 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 11 Mar 2011 04:50:14 +0000 (UTC) Cc: lekktu@gmail.com, tzz@lifelogs.com, emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Mar 11 05:50:10 2011 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1PxuIj-00026R-3d for ged-emacs-devel@m.gmane.org; Fri, 11 Mar 2011 05:50:09 +0100 Original-Received: from localhost ([127.0.0.1]:40509 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PxuIi-0007kI-Dz for ged-emacs-devel@m.gmane.org; Thu, 10 Mar 2011 23:50:08 -0500 Original-Received: from [140.186.70.92] (port=58328 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PxuIe-0007k3-8c for emacs-devel@gnu.org; Thu, 10 Mar 2011 23:50:05 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Pxu0p-0006Fg-Ol for emacs-devel@gnu.org; Thu, 10 Mar 2011 23:32:37 -0500 Original-Received: from mx1.aist.go.jp ([150.29.246.133]:48830) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Pxu0p-0006Ck-6y for emacs-devel@gnu.org; Thu, 10 Mar 2011 23:31:39 -0500 Original-Received: from rqsmtp2.aist.go.jp (rqsmtp2.aist.go.jp [150.29.254.123]) by mx1.aist.go.jp with ESMTP id p2B4VVAY024074; Fri, 11 Mar 2011 13:31:31 +0900 (JST) env-from (handa@m17n.org) Original-Received: from smtp4.aist.go.jp by rqsmtp2.aist.go.jp with ESMTP id p2B4VVpR021969; Fri, 11 Mar 2011 13:31:31 +0900 (JST) env-from (handa@m17n.org) Original-Received: by smtp4.aist.go.jp with ESMTP id p2B4VVJE016013; Fri, 11 Mar 2011 13:31:31 +0900 (JST) env-from (handa@m17n.org) Original-Received: from handa by etlken with local (Exim 4.71) (envelope-from ) id 1Pxu0g-0002zI-Vv; Fri, 11 Mar 2011 13:31:31 +0900 In-Reply-To: (message from Stefan Monnier on Thu, 10 Mar 2011 21:10:35 -0500) X-detected-operating-system: by eggs.gnu.org: Solaris 9 X-Received-From: 150.29.246.133 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:137082 Archived-At: In article , Stefan Monnier writes: > > Yes, it is a bit silly complete keywords, which are not variables by > > definition. I'm going to install this trivial fix. > Sounds good. FWIW, here's a patch I have pending for the lexbind branch > (where special-variable-p is t only for vars that have been defvar'd > or defconst'd). This is a little bit different topic, but shouldn't we have a way to distinguish functions/macros/variables for public API from those for internal (i.e. only within a specific package) use only. For instance, as basic-save-buffer-1 is just a helper function of basic-save-buffer, there's no need to list it by C-h f TAB. In addition, and this is more important, such a distinguishment makes it easier to maintain a package. For instance, when I improve the MIME handling of rmailmm.el, the most difficult thing was to keep backward compatibility of existing functions. It seems that most of them are intended for internal use only. If that is clear, I could have renamed or changed the behaviour of some of them. --- Kenichi Handa handa@m17n.org