From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#65027: 30.0.50; [PATCH] Document .elpaignore behavior in the Emacs Lisp manual Date: Fri, 04 Aug 2023 08:42:53 +0300 Message-ID: <83il9vweg2.fsf@gnu.org> References: <761581a0-fa77-e89c-01e8-d0baeae838f5@gmail.com> <83cz04xzvk.fsf@gnu.org> <4cf2941f-299c-fdb6-e2f5-375e8fc4e8e0@gmail.com> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="25495"; mail-complaints-to="usenet@ciao.gmane.io" Cc: philipk@posteo.net, monnier@iro.umontreal.ca, 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 07:43:17 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 1qRnan-0006SQ-Fi for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 04 Aug 2023 07:43:17 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qRnaa-0002fy-K8; Fri, 04 Aug 2023 01: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 1qRnaZ-0002fq-0E for bug-gnu-emacs@gnu.org; Fri, 04 Aug 2023 01: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 1qRnaX-0007NG-V7 for bug-gnu-emacs@gnu.org; Fri, 04 Aug 2023 01:43:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1qRnaX-0006Ma-RC for bug-gnu-emacs@gnu.org; Fri, 04 Aug 2023 01:43:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 04 Aug 2023 05: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.169112777024443 (code B ref 65027); Fri, 04 Aug 2023 05:43:01 +0000 Original-Received: (at 65027) by debbugs.gnu.org; 4 Aug 2023 05:42:50 +0000 Original-Received: from localhost ([127.0.0.1]:53257 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qRnaM-0006MB-GY for submit@debbugs.gnu.org; Fri, 04 Aug 2023 01:42:50 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:53788) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qRnaK-0006Ly-GZ for 65027@debbugs.gnu.org; Fri, 04 Aug 2023 01:42:49 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qRnaE-0007JP-NO; Fri, 04 Aug 2023 01:42:42 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=7NcNu1Ad9QGqtMl4NCRC9sYOc+rPt1K7ZEQ55kS9sX0=; b=ZendQTJc3PYg PfrTrW0eUnj+HZzeFAmLVKSmB/Ozxy/j9DY+A2uMKwrOXZZiw5IuT7g+FXvwzXNJ95LQZl5AcJWKQ TqZvKZ6CYn7wJMKKGOAzwRf9wLEFMP5qeBrZHdT0LZ1ycfmhzvVbWKJwOXdlJM2lVDK2AXRKnhaZ4 WEwPYPevA/3OaurMxV3pgmujCQ5d+LNWJbF5AgwrqJzTBonXuOo7xq5RzUWjboqFi46faTfbAfEPo YwX0JjQo7MOhz7VfzUZ//AUeqEtyJ2Hn3NgPIGwzoGrT6fq5jQHJT8p9ZXdd/R+b8nczN6HBPYVIk NN+q5h7unmVIk1Wn5g0u8w==; Original-Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qRnaE-0001ah-4P; Fri, 04 Aug 2023 01:42:42 -0400 In-Reply-To: <4cf2941f-299c-fdb6-e2f5-375e8fc4e8e0@gmail.com> (message from Jim Porter on 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:266643 Archived-At: > Date: Thu, 3 Aug 2023 15:02:12 -0700 > Cc: Eli Zaretskii , philipk@posteo.net, 65027@debbugs.gnu.org > From: Jim Porter > > 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. To have the best of both worlds, please have the ELisp manual mention the ELPA README file, and ELPA README file to mention specific nodes of the ELisp manual where this stuff is described.