From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Xue Fuqiao Newsgroups: gmane.emacs.bugs Subject: bug#13740: About a coding convention Date: Mon, 18 Feb 2013 08:25:15 +0800 Organization: The Church of Emacs Message-ID: <20130218082515.6ed5dfd2988fa1090af99a10@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 1361147175 13310 80.91.229.3 (18 Feb 2013 00:26:15 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 18 Feb 2013 00:26:15 +0000 (UTC) To: 13740@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Feb 18 01:26:37 2013 Return-path: Envelope-to: geb-bug-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 1U7EZ0-0003pT-2r for geb-bug-gnu-emacs@m.gmane.org; Mon, 18 Feb 2013 01:26:34 +0100 Original-Received: from localhost ([::1]:56788 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U7EYe-0003w7-MH for geb-bug-gnu-emacs@m.gmane.org; Sun, 17 Feb 2013 19:26:12 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:41307) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U7EYa-0003vw-7l for bug-gnu-emacs@gnu.org; Sun, 17 Feb 2013 19:26:11 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1U7EYY-0000NW-Tb for bug-gnu-emacs@gnu.org; Sun, 17 Feb 2013 19:26:08 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:56234) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U7EYY-0000NL-MI for bug-gnu-emacs@gnu.org; Sun, 17 Feb 2013 19:26:06 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1U7EZS-0005aR-E0 for bug-gnu-emacs@gnu.org; Sun, 17 Feb 2013 19:27:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Xue Fuqiao Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 18 Feb 2013 00:27:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 13740 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.136114718521429 (code B ref -1); Mon, 18 Feb 2013 00:27:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 18 Feb 2013 00:26:25 +0000 Original-Received: from localhost ([127.0.0.1]:33465 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1U7EYq-0005ZZ-W2 for submit@debbugs.gnu.org; Sun, 17 Feb 2013 19:26:25 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:58074) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1U7EYo-0005ZS-89 for submit@debbugs.gnu.org; Sun, 17 Feb 2013 19:26:23 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1U7EXs-0000Fo-ND for submit@debbugs.gnu.org; Sun, 17 Feb 2013 19:25:25 -0500 Original-Received: from lists.gnu.org ([208.118.235.17]:38129) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U7EXs-0000Fk-KR for submit@debbugs.gnu.org; Sun, 17 Feb 2013 19:25:24 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:41195) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U7EXr-0003tN-I7 for bug-gnu-emacs@gnu.org; Sun, 17 Feb 2013 19:25:24 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1U7EXq-0000FG-KR for bug-gnu-emacs@gnu.org; Sun, 17 Feb 2013 19:25:23 -0500 Original-Received: from mail-pb0-f42.google.com ([209.85.160.42]:56679) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U7EXq-0000FA-Cm for bug-gnu-emacs@gnu.org; Sun, 17 Feb 2013 19:25:22 -0500 Original-Received: by mail-pb0-f42.google.com with SMTP id xb4so1371881pbc.1 for ; Sun, 17 Feb 2013 16:25:21 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=x-received:date:from:to:subject:message-id:organization:x-mailer :mime-version:content-type:content-transfer-encoding; bh=QSk8b6rFBe8kYDQuiPLK9/cLP+aIse0GgKPuIx6Cq4U=; b=sjIPND4a2mf7tL1ILs2VeRu3aTR+1+Um2L0kkkfLRKsainBRsiTcbTyOhahGpjiBOz 3K2BzBXN6uEFH/FHyLrek9UWa8Rd01iWoAcMB+NG1WeO1fZH3d6/u5HnelRod1r9yGMC iBBXqf8ivSHabFa3q6MJR7xEg0nSZ9z4/jDqDMItNcAHyHgk4lBOnNprVM4wDVporvOQ R6y0IaUPdxn1Kp+LK007nhWk6pp8j3pkJcuWrtjSxmWl8p0f9Xq+Uk4ZUvq2Ystd1JS9 79Z8+lpEZnio84APwj98wPNkpAMAo/oqzjaiVIUbVlPvzRkMUUt1xjoxFomNhVLaTAL7 CNJw== X-Received: by 10.66.76.41 with SMTP id h9mr31515895paw.1.1361147121411; Sun, 17 Feb 2013 16:25:21 -0800 (PST) Original-Received: from Emacs ([124.117.94.252]) by mx.google.com with ESMTPS id iu10sm12450977pbc.13.2013.02.17.16.25.18 (version=TLSv1.1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Sun, 17 Feb 2013 16:25:20 -0800 (PST) X-Mailer: Sylpheed 3.2.0 (GTK+ 2.24.13; x86_64-pc-linux-gnu) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:71454 Archived-At: In (info "(elisp) Coding Conventions"): * Constructs that define a function or variable should be macros, not functions, and their names should start with `define-'. The macro should receive the name to be defined as the first argument. That will help various tools find the definition automatically. Avoid constructing the names in the macro itself, since that would confuse these tools. I think macros like `cl-defsubst', `cl-defun' should be mentioned here. -- Best regards, Xue Fuqiao. http://www.emacswiki.org/emacs/XueFuqiao