From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Artur Malabarba Newsgroups: gmane.emacs.devel Subject: Re: [ELPA] New package: multishell Date: Sun, 03 Jan 2016 20:26:35 +0000 Message-ID: <87a8om1kas.fsf@gmail.com> References: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1451860027 11418 80.91.229.3 (3 Jan 2016 22:27:07 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 3 Jan 2016 22:27:07 +0000 (UTC) Cc: "emacs-devel@gnu.org" To: Ken Manheimer Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Jan 03 23:27:00 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 1aFr76-00076D-9Y for ged-emacs-devel@m.gmane.org; Sun, 03 Jan 2016 23:27:00 +0100 Original-Received: from localhost ([::1]:43090 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aFr75-0003Fu-Hd for ged-emacs-devel@m.gmane.org; Sun, 03 Jan 2016 17:26:59 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:55458) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aFr6t-0003Fo-O5 for emacs-devel@gnu.org; Sun, 03 Jan 2016 17:26:48 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aFr6q-0004HY-DI for emacs-devel@gnu.org; Sun, 03 Jan 2016 17:26:47 -0500 Original-Received: from mail-qk0-x22e.google.com ([2607:f8b0:400d:c09::22e]:34026) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aFr6q-0004HT-99 for emacs-devel@gnu.org; Sun, 03 Jan 2016 17:26:44 -0500 Original-Received: by mail-qk0-x22e.google.com with SMTP id p187so243038083qkd.1 for ; Sun, 03 Jan 2016 14:26:43 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-type:content-transfer-encoding; bh=16scmyKv+ZVmUpNhK53/wrtS/MjNzOAE5r+TrXMh2B0=; b=iEuLFkstQP1QEOMtwlZyUYVTNYwtEq2CtjYLDPRWi81lkJ18SYDyRG9NtdJ4Dw/HAM AS7Nz2uR+dST5oHSYNIPID2OhoWdMc/mAv4tz9wHymEfdOOt9WfX8wLmeo4fTDbQ4S1O RjpGy9ScnBjps0AZGKNEwL4fJwbWukrQgbYAk1ZhzVm0NYiCK6gZt9t+Bl0ZZppObcDs EWSUH1kCmTUx16/i8ME2ywTw48/olz2H7lhgwiRMQbs5FoDiZwe4ZGhLxTw0CpLV7cyW Y1m8cPvhufYED3RD5Et3EoOVkSWBroImLDt/bXRgX36OdCidKvxuJy8yGMFyFy0zbSaX lbIQ== X-Received: by 10.55.77.2 with SMTP id a2mr110724962qkb.108.1451860003662; Sun, 03 Jan 2016 14:26:43 -0800 (PST) Original-Received: from Gandalf-Linux.gmail.com ([201.37.162.188]) by smtp.gmail.com with ESMTPSA id s188sm34241128qhc.41.2016.01.03.14.26.41 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sun, 03 Jan 2016 14:26:43 -0800 (PST) In-Reply-To: (Ken Manheimer's message of "Sat, 2 Jan 2016 17:19:02 -0500") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2607:f8b0:400d:c09::22e 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:197513 Archived-At: Ken Manheimer writes: > I'm about to push a multishell as a new packge in the=C2=A0git.sv.gnu.org: Thank you! > One coding wrinkle worth mentioning - I prefixed most of my package's > functions with "multishell:" Please change it to =E2=80=9Cmultishell-=E2=80=9D. It will work nicer with = the customize interface. > did not prefix the primary function, "pop-to-shell". I see that as > the package's exported api. I do not feel strongly bound to this > choice, and can be persuaded to also prefix it if someone feels there > is good reason to do so. The current convention is to use multishell-pop-to-shell. This includes user stuff (like commands and customization variables) as well as programatic stuff that you consider =E2=80=9Cofficial api=E2=80=9D (like fu= nctions that other packages can call, or vars that can be configured but aren't defcustoms). In order to differentiate the functions and vars that are NOT =E2=80=9Cexported=E2=80=9D, use a double-dash (e.g. `multishell--bracket-as= terisks'). (This is a relatively new convention, which is why a lot of places don't use it).