From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Protesilaos Stavrou Newsgroups: gmane.emacs.devel Subject: Re: [GNU ELPA] Denote version 1.0.0 Date: Sun, 02 Oct 2022 10:23:50 +0300 Message-ID: <87sfk66649.fsf@protesilaos.com> References: <85czbd44kc.fsf@elpa.gnu.org> <87mtah447f.fsf@protesilaos.com> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="22957"; mail-complaints-to="usenet@ciao.gmane.io" To: rms@gnu.org, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Oct 02 09:26:53 2022 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1oetNC-0005mM-K6 for ged-emacs-devel@m.gmane-mx.org; Sun, 02 Oct 2022 09:26:50 +0200 Original-Received: from localhost ([::1]:39838 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oetNB-0000vX-FD for ged-emacs-devel@m.gmane-mx.org; Sun, 02 Oct 2022 03:26:49 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:59082) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oetKU-0007Wx-5M for emacs-devel@gnu.org; Sun, 02 Oct 2022 03:24:02 -0400 Original-Received: from relay4-d.mail.gandi.net ([217.70.183.196]:54443) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oetKP-0004Je-Ts; Sun, 02 Oct 2022 03:24:00 -0400 Original-Received: (Authenticated sender: public@protesilaos.com) by mail.gandi.net (Postfix) with ESMTPSA id E6898E0005; Sun, 2 Oct 2022 07:23:51 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=protesilaos.com; s=gm1; t=1664695433; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=KmxqnKp/BjdEBcDqwl65oZgak3onMCecyfokNmxRIoY=; b=YJnen0vXfXi1yWhSpRhXmEAkXmncIL1UAPmTEslpYa0ggu84ZcLL2xk3dPu53qEcWTP+95 ImEcp4ZWNbDr0uWTT85qagaPRsCzsJx8BHGmrkw+U+YqhgCIRCuijT39fy3Rcag8IQ15Xu oVXSwzbakk2XAoomlP9fJ1+jP3CnF+phnRp7gwLsUheJrY5KfKfl756DYsvPSawvsGxUEl BvjrFsT9oi8jKVKUImA250u+Fr6vkJbhG7vMpTXJbSJUSLmLtZGCZqIafNX6eTZOJBtz7C gOkQDCQeea2dIno9iPrszU9ZXcPYSNevQtHHmuo6tNkpIAU9nv/4frWRINBRHg== In-Reply-To: Received-SPF: none client-ip=217.70.183.196; envelope-from=info@protesilaos.com; helo=relay4-d.mail.gandi.net X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_NONE=0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 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-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:296587 Archived-At: > From: Richard Stallman > Date: Sat, 1 Oct 2022 21:09:04 -0400 > > [[[ To any NSA and FBI agents reading my email: please consider ]]] > [[[ whether defending the US Constitution against all enemies, ]]] > [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > > > >> Version 1.0.0 of package Denote has just been released in GNU ELPA. > > >> You can now find it in M-x package-list RET. > > >> > > >> Denote describes itself as: > > >> Simple notes with an efficient file-naming scheme > > The name "Denote" is an example of a class of clever names that we can > call "half-helpful". > > Why half-helpful? Because once you know that "Denote" refers to > "taking notes", you will probably remember that. When you see the name > "Denote", you will recall what the package is good for. > > Why only half helpful? Because if you see only the name "Denote" > without the clue, you won't have the faintest idea what the package is > good for. This initial mystery is what makes the name amusingly > clever. > > Can we come up with documentation conventions, for use when mentioning > these half-helpful names, that will systematicall give the clue about > each? In principle, I am happy to conform with such conventions. Some notes: * The 'M-x list-packages' includes a one-line description. Those usually suffice to explain what the package tries to achieve. * Any convention of this sort should not nudge us towards favouring generic names like "emacs-notes", "notes-mode", "notes.el", etc. There are lots of packages out there that have similar functionality. If we all go for the generic name, we will keep clashing with each other. * Generic names can make it more difficult for core Emacs to introduce new features. For example, we recently got 'emoji.el'. If some package had already taken this name, it would complicate things for the respective maintainers. -- Protesilaos Stavrou https://protesilaos.com