From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.help Subject: RE: About definition finding Date: Wed, 6 Mar 2013 14:31:07 -0800 Message-ID: References: <5137446A.1060505@gmail.com> <5137C0BE.1060601@gmail.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1362609088 19245 80.91.229.3 (6 Mar 2013 22:31:28 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 6 Mar 2013 22:31:28 +0000 (UTC) Cc: help-gnu-emacs@gnu.org To: "'Xue Fuqiao'" Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Wed Mar 06 23:31:53 2013 Return-path: Envelope-to: geh-help-gnu-emacs@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 1UDMsJ-0001XF-7P for geh-help-gnu-emacs@m.gmane.org; Wed, 06 Mar 2013 23:31:51 +0100 Original-Received: from localhost ([::1]:58356 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UDMrx-0008Dy-DE for geh-help-gnu-emacs@m.gmane.org; Wed, 06 Mar 2013 17:31:29 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:60230) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UDMrj-0008Ds-EI for help-gnu-emacs@gnu.org; Wed, 06 Mar 2013 17:31:17 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UDMrh-000636-Ky for help-gnu-emacs@gnu.org; Wed, 06 Mar 2013 17:31:15 -0500 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:36966) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UDMrh-000631-EX for help-gnu-emacs@gnu.org; Wed, 06 Mar 2013 17:31:13 -0500 Original-Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by aserp1040.oracle.com (Sentrion-MTA-4.3.1/Sentrion-MTA-4.3.1) with ESMTP id r26MVBk7006721 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 6 Mar 2013 22:31:12 GMT Original-Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r26MVAJR000826 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 6 Mar 2013 22:31:11 GMT Original-Received: from abhmt104.oracle.com (abhmt104.oracle.com [141.146.116.56]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id r26MVAPE016614; Wed, 6 Mar 2013 16:31:10 -0600 Original-Received: from dradamslap1 (/10.159.178.227) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 06 Mar 2013 14:31:10 -0800 X-Mailer: Microsoft Office Outlook 11 In-reply-to: <5137C0BE.1060601@gmail.com> Thread-Index: Ac4auJBxw/l+f9rmS5aGux3Cf6sYAgAAGfzw X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-Received-From: 141.146.126.69 X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Original-Sender: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.help:89397 Archived-At: > > Note that this doc section's guideline conflicts a bit with > > that of adding a package/library prefix to such macros. E.g., > > `icicle-define-command' vs `define-icicle-command'. I put > > the library prefix first, but others might do otherwise. > > Does alias make sense? E.g., `package-list-packages' is an alias of > `list-packages'. First, note also that `list-packages' is a command, not a macro. The aliasing in that case is presumably for user convenience interactively. Beyond that, someone from Emacs Dev can perhaps speak to the relation between such a guideline and aliasing in general. I would guess that if you bother to follow the guideline for a macro then there is little sense in following that up by then defining an alias and using that instead. In principle, the guidelines are there to help you and those who use your code. But remember that they are just guidelines, not rules to be followed blindly without using your judgment. Do what makes the most sense to you, after reading the guidelines.