From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Philipp Stephani Newsgroups: gmane.emacs.help Subject: Naming conventions for defining macros Date: Tue, 24 Feb 2015 06:45:28 +0000 Message-ID: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 X-Trace: ger.gmane.org 1424760357 24120 80.91.229.3 (24 Feb 2015 06:45:57 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 24 Feb 2015 06:45:57 +0000 (UTC) To: "help-gnu-emacs@gnu.org" Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Tue Feb 24 07:45:56 2015 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 1YQ9Fk-0004Kd-Ib for geh-help-gnu-emacs@m.gmane.org; Tue, 24 Feb 2015 07:45:56 +0100 Original-Received: from localhost ([::1]:47013 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YQ9Fj-0005hA-Rj for geh-help-gnu-emacs@m.gmane.org; Tue, 24 Feb 2015 01:45:55 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:46077) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YQ9FK-0005da-Uk for help-gnu-emacs@gnu.org; Tue, 24 Feb 2015 01:45:31 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YQ9FK-0005TZ-4w for help-gnu-emacs@gnu.org; Tue, 24 Feb 2015 01:45:30 -0500 Original-Received: from mail-lb0-x230.google.com ([2a00:1450:4010:c04::230]:35789) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YQ9FJ-0005TV-Sm for help-gnu-emacs@gnu.org; Tue, 24 Feb 2015 01:45:30 -0500 Original-Received: by lbjb6 with SMTP id b6so23016533lbj.2 for ; Mon, 23 Feb 2015 22:45:29 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:from:date:message-id:subject:to:content-type; bh=8ZuILdArYzQFtsKd9k2KclMWfxqzSrpRVaLAb80aWd0=; b=x23E3R0AImI8NosVtveiswDm4OgwSZ98EeCaVUpnYOBnh+ey4Zrf9J6CJKZbKtuqjX kXGKB6eaZeZBGd5aJlflY3zi83Avi9ORokWN9J0TtE4rS/g7pOUGYlqpgoq2xG5zM5L/ Cb5sbMNFy7gZH6URyvw3RdCutfggcOGWpHLano3S4hjPBR4rXyMorqDwrQ7FyoeqInZT msYR62q1bV5+8shx/+5p0QaFnCmSfaeb3G8G2gUmuIlMBjOgWB7cID7x8TT3/fVOcb/J Losd85n+W+l7pZxDAIivNpfoeyeQy6GeHE6mQMMsVJ32T2Jjl/OIL+eNLbpGxWrptIZq riIg== X-Received: by 10.152.87.84 with SMTP id v20mr4551832laz.81.1424760329127; Mon, 23 Feb 2015 22:45:29 -0800 (PST) X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2a00:1450:4010:c04::230 X-Content-Filtered-By: Mailman/MimeDel 2.1.14 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:102865 Archived-At: Hi, the manual page about coding conventions says: "Constructs that define a function or variable should be macros, not functions, and their names should start with `define-'." This recommendation is at odds with the usual recommendation to prefix all non-local names with the package name and doesn't seem to be widely followed by either Emacs (e.g. ert-deftest, cl-defstruct) or popular third-party packages (e.g. magit-define-command). Should we get rid of this recommendation? It amounts to special-casing a certain class of names without much benefit. Thanks, Philipp