From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Robert Weiner Newsgroups: gmane.emacs.devel Subject: Suggestion for improved clarity in xref.el symbol names Date: Tue, 19 Apr 2016 16:27:57 -0400 Message-ID: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/alternative; boundary=001a113db4861334ee0530dc5058 X-Trace: ger.gmane.org 1461097704 14206 80.91.229.3 (19 Apr 2016 20:28:24 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 19 Apr 2016 20:28:24 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Apr 19 22:28:23 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 1ascFz-0000LA-2b for ged-emacs-devel@m.gmane.org; Tue, 19 Apr 2016 22:28:23 +0200 Original-Received: from localhost ([::1]:36075 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ascFy-0003U6-CT for ged-emacs-devel@m.gmane.org; Tue, 19 Apr 2016 16:28:22 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:48666) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ascFb-0003MR-CD for emacs-devel@gnu.org; Tue, 19 Apr 2016 16:28:00 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ascFa-0008MN-H3 for emacs-devel@gnu.org; Tue, 19 Apr 2016 16:27:59 -0400 Original-Received: from mail-oi0-x242.google.com ([2607:f8b0:4003:c06::242]:36218) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ascFa-0008MJ-CF for emacs-devel@gnu.org; Tue, 19 Apr 2016 16:27:58 -0400 Original-Received: by mail-oi0-x242.google.com with SMTP id i2so2770006oib.3 for ; Tue, 19 Apr 2016 13:27:58 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:date:message-id:subject:from:to; bh=aaNFriKLTBLq1VqLRbAQd9gT1o0KtZtzqg21zeQsgog=; b=d8CgK0ZfbuARGqvoHxG/tDuWn01eynQZfFyzac35QMuAzOoUdBsGnaTDs51mg37xJN n7aog5vp6YDs1EVeHFSzEmN6S6S4zJ8r2lcVpaBRG7kDFkLcl8+Irj7YpRG0yICqRmh0 din/7+p/l4X4C4e+MITnEvmJ/2noAcboRRrxIN+Vg2ZduaN8EKJWQwzuLJocsKRGIcSB fTo/k35iOji/K/MqzWpvH7FFA1mfq7qANUS/50hyR4mkRiG3FRCiOnNoyWzMHwGynJew MQVHFpjnUUUeb7go7Q8ZyUQG47hy20evQOswjgAztjlAVPpCMKNDh19YkOVJh29QRsKW Bd9A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:date:message-id:subject:from:to; bh=aaNFriKLTBLq1VqLRbAQd9gT1o0KtZtzqg21zeQsgog=; b=lqryNi67Afzz32b3/TyuJbkMdYY3vJoGHzGuO9JyqTgWjNesvleY66SWRdR/YgBugo ZaLK1LXiElsreC+eBu9fUM+4fzXZU4YwP2SGnpRpOvd21+z28lp4421Wc5YGFZh2FWaz HWkEcYENZsAcxzeBOfYEk5HaMV+Tf6x0e1YlBnEAgusSDkG/xgTpDUnBVEz60zhAR4X4 UdD07wKG/k5ROdayu0qDnNSbiBLMbsxhfvjhWLN2Hqrv9cIc7fVrXAyTWbkNdvVMbJeg O0zypc9p9mYs+D6gkIbQ772Qu01KCwWTfX6ekaZsh57AhHIohPJL3V4FQAnM6GCM5j+Z PoRQ== X-Gm-Message-State: AOPr4FVj7UhqSlPUodbQ5p2D+GBU38NC3heAFOrosKrpdzUqSccFt3b+iBFFOmZxKW+oxmaWhFEN+Svyd2Koyw== X-Received: by 10.157.44.196 with SMTP id e4mr1261617otd.80.1461097677925; Tue, 19 Apr 2016 13:27:57 -0700 (PDT) Original-Received: by 10.157.44.202 with HTTP; Tue, 19 Apr 2016 13:27:57 -0700 (PDT) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2607:f8b0:4003:c06::242 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 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" Xref: news.gmane.org gmane.emacs.devel:203101 Archived-At: --001a113db4861334ee0530dc5058 Content-Type: text/plain; charset=UTF-8 The xref.el library has many variables and functions with `backend' in them, indicating that they represent language-dependent entities. Before the xref API is set in stone, I would consider replacing this term with 'language' as it reads better in the names, it refers to a concept intrinsic to the cross-references themselves which are language-specific, whereas backend is just an implementation detail, and it will make more sense to users of the library who may not be familiar with the concept of a `backend'. Just a thought but I know these names will live for a long time. --001a113db4861334ee0530dc5058 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable
The xref.el library has many variables and functions with = `backend' in them, indicating that they represent language-dependent en= tities.=C2=A0 Before the xref API is set in stone, I would consider replaci= ng this term with 'language' as it reads better in the names, it re= fers to a concept intrinsic to the cross-references themselves which are la= nguage-specific, whereas backend is just an implementation detail, and it w= ill make more sense to users of the library who may not be familiar with th= e concept of a `backend'.

Just a thought but I know = these names will live for a long time.

--001a113db4861334ee0530dc5058--