From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.devel Subject: RE: Consistent naming in woman.el Date: Thu, 4 Feb 2016 09:30:07 -0800 (PST) Message-ID: <62c391f3-a3f8-41a3-911e-547c70efe9cc@default> References: < > <<83oabwwgx4.fsf@gnu.org>> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1454607039 31939 80.91.229.3 (4 Feb 2016 17:30:39 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 4 Feb 2016 17:30:39 +0000 (UTC) Cc: emacs-devel@gnu.org To: Eli Zaretskii , Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Feb 04 18:30:25 2016 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 1aRNjX-0004N0-93 for ged-emacs-devel@m.gmane.org; Thu, 04 Feb 2016 18:30:19 +0100 Original-Received: from localhost ([::1]:43218 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aRNjW-0000dt-Kh for ged-emacs-devel@m.gmane.org; Thu, 04 Feb 2016 12:30:18 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:57907) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aRNjS-0000dd-Vz for emacs-devel@gnu.org; Thu, 04 Feb 2016 12:30:15 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aRNjS-0008IG-6J for emacs-devel@gnu.org; Thu, 04 Feb 2016 12:30:14 -0500 Original-Received: from userp1040.oracle.com ([156.151.31.81]:31498) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aRNjO-0008Gr-7Y; Thu, 04 Feb 2016 12:30:10 -0500 Original-Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u14HU98h031365 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 4 Feb 2016 17:30:09 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userv0021.oracle.com (8.13.8/8.13.8) with ESMTP id u14HU8dK028936 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Thu, 4 Feb 2016 17:30:08 GMT Original-Received: from abhmp0009.oracle.com (abhmp0009.oracle.com [141.146.116.15]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id u14HU826008752; Thu, 4 Feb 2016 17:30:08 GMT In-Reply-To: <<83oabwwgx4.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] X-Source-IP: userv0021.oracle.com [156.151.31.71] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-Received-From: 156.151.31.81 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:199314 Archived-At: > > Not sure about this case, but such capitalization has been used in some > > Elisp packages to indicate "internal" vs "exported" > functions/vars/commands. >=20 > Indeed. We have something similar in info.el, I think. And in Customize: `Custom-*' commands. But no, the convention (FWIW) is _not_ designed to distinguish "internal" from "exported" things. (The very notion of "internal" vs "exported" is somewhat alien to tradtional Emacs, IMO.) The convention is there to make it easier to match some command names when completing (including for `C-h f', but mainly for `M-x'). The idea is to not present you with too many, somewhat extraneous, commands when you use `M-x'. The names of more esoteric commands are capitalized, the idea being that you will more likely type lowercase, and so will not be bothered with those names. That is, commands that are more commonly expected to be used with `M-x' are not capitalized when this convention is followed. Commands that are expected to be invoked less often using `M-x' (e.g. invoked mainly by keys or menus) are capitalized. Thus: `info', but `Info-virtual-index' `customize-option', but `Custom-help' Whether this convention is really useful nowadays, since completion can include partial-complete, substring matching etc., is debatable. But that was the idea, anyway, AFAIK.