From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Monnier via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#65027: 30.0.50; [PATCH] Document .elpaignore behavior in the Emacs Lisp manual Date: Thu, 03 Aug 2023 18:41:55 -0400 Message-ID: References: <761581a0-fa77-e89c-01e8-d0baeae838f5@gmail.com> <83cz04xzvk.fsf@gnu.org> <4cf2941f-299c-fdb6-e2f5-375e8fc4e8e0@gmail.com> Reply-To: Stefan Monnier Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="4813"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: Eli Zaretskii , philipk@posteo.net, 65027@debbugs.gnu.org To: Jim Porter Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Fri Aug 04 00:43:27 2023 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1qRh2U-00012n-Ty for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 04 Aug 2023 00:43:27 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qRh28-0005gq-0q; Thu, 03 Aug 2023 18:43:04 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qRh26-0005gO-TT for bug-gnu-emacs@gnu.org; Thu, 03 Aug 2023 18:43:03 -0400 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qRh26-0007Y3-LM for bug-gnu-emacs@gnu.org; Thu, 03 Aug 2023 18:43:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1qRh25-0003rq-Qj for bug-gnu-emacs@gnu.org; Thu, 03 Aug 2023 18:43:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Monnier Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 03 Aug 2023 22:43:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 65027 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 65027-submit@debbugs.gnu.org id=B65027.169110252714795 (code B ref 65027); Thu, 03 Aug 2023 22:43:01 +0000 Original-Received: (at 65027) by debbugs.gnu.org; 3 Aug 2023 22:42:07 +0000 Original-Received: from localhost ([127.0.0.1]:53101 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qRh1D-0003qZ-0K for submit@debbugs.gnu.org; Thu, 03 Aug 2023 18:42:07 -0400 Original-Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:34178) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qRh1B-0003q5-Mg for 65027@debbugs.gnu.org; Thu, 03 Aug 2023 18:42:06 -0400 Original-Received: from pmg3.iro.umontreal.ca (localhost [127.0.0.1]) by pmg3.iro.umontreal.ca (Proxmox) with ESMTP id 444444447A6; Thu, 3 Aug 2023 18:42:00 -0400 (EDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=iro.umontreal.ca; s=mail; t=1691102518; bh=wouqdjyB/erC57yzdqoXV2TtZXnZsH0pfzw+bDcF/lA=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=pP0KxcMn33xjCoTR/6f6orJEdeklWVDRQWeXet1ddjnJe1khxqpXseGZMVNwosTL+ Anr1fxI2hhUYf4gMogcocLAyOSkokdmwEj5VnZLXaXnE6LUwCImrh8JZzwkBUnP0we KPBVOaxD1hzECpGQ3jlnJ5TM1tDXBbGGUcXzqAFSF5b88imaePrC9g2hqmvJF0prxx bUZeocrFrw0PgtLZPeN7uG94XWUa90MaP3FY6wti49rOsjy9xsPp2OXk+6EZhTouGp 18EI1VoYCO8aORBRHlLGbEdIBJjWEGnajNjuIbHb5/f3RO8zlyCcZbUVUheAhKPHOo xf5ZaOHmFHy2A== Original-Received: from mail01.iro.umontreal.ca (unknown [172.31.2.1]) by pmg3.iro.umontreal.ca (Proxmox) with ESMTP id AEB484447A3; Thu, 3 Aug 2023 18:41:58 -0400 (EDT) Original-Received: from alfajor (unknown [181.44.118.150]) by mail01.iro.umontreal.ca (Postfix) with ESMTPSA id 7660E1202BB; Thu, 3 Aug 2023 18:41:57 -0400 (EDT) In-Reply-To: <4cf2941f-299c-fdb6-e2f5-375e8fc4e8e0@gmail.com> (Jim Porter's message of "Thu, 3 Aug 2023 15:02:12 -0700") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:266631 Archived-At: >>> Maybe it would make sense to put all the documentation in the Emacs Lisp >>> manual, and then the GNU ELPA README can be the home for documentation about >>> how to work with the GNU ELPA repository specifically (mainly as an >>> administrator). >> FWIW, that's how it started. It's just that some of the conventions >> originally used only in (Non)GNU ELPA have now made their way into >> `package.el`. > > As a general guideline for documentation, I'm thinking that anything > a package author puts in their own repository would get documented in the > Emacs Lisp manual, whereas anything that goes in the (Non)GNU ELPA > repository (e.g. in the elpa-packages file) goes in the ELPA README. That > makes intuitive sense to me as a package author at least: then the Emacs > Lisp manual would have everything I need to *prepare* my package for > eventual inclusion in ELPA. Historically, the difference was between the format of the repository (which only affected things like Melpa and (Non)GNU ELPA) and the format of ELPA tarballs (which is what `package.el` dealt with). `package-vc` makes the repository format relevant to `package.el`. But there might still be differences between what `package-vc` requires and what (Non)GNU ELPA requires, beside the data actually maintained in the (Non)GNU ELPA `elpa-packages`. Stefan