Received: (at 65027) by debbugs.gnu.org; 6 Sep 2023 01:56:47 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Tue Sep 05 21:56:47 2023 Received: from localhost ([127.0.0.1]:60244 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1qdhmh-00061O-27 for submit <at> debbugs.gnu.org; Tue, 05 Sep 2023 21:56:47 -0400 Received: from mail-pf1-x429.google.com ([2607:f8b0:4864:20::429]:55652) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <jporterbugs@HIDDEN>) id 1qdhmf-00061B-2q for 65027 <at> debbugs.gnu.org; Tue, 05 Sep 2023 21:56:45 -0400 Received: by mail-pf1-x429.google.com with SMTP id d2e1a72fcca58-68a3b66f350so2756087b3a.3 for <65027 <at> debbugs.gnu.org>; Tue, 05 Sep 2023 18:56:44 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1693965398; x=1694570198; darn=debbugs.gnu.org; h=content-transfer-encoding:in-reply-to:from:references:cc:to :content-language:subject:mime-version:date:message-id:from:to:cc :subject:date:message-id:reply-to; bh=wBGN5GBehMBONcZ2of8C24/2uIes/POD73xk+nKq+bY=; b=c6vDZ77fNzUGRrWRLoIJVwTN1Z63lT7DEGCgAsXlsaOWvTcQxI3PqLuqw0+pyPwsKH Lmpb7Vf8f92KxhTsI/7FKqbHxJn407LtZEEGxHghtGFSznZtYDabEPr2KNszdv1+3eYf LV4rUFN8sPaA0h2SPIwbHP2+mfGPO+7AgWdkwtX0LaSC5iRglozimGCDdRT/2vU63nJx 81ejChoZs4gveRgFqyHsq5M5HppnODjTeycZVAQDAX29FHqyqF0z0CQyoTJ+CGz1qcJ2 eMIN3lw2WKdobZO+/LjdExSoAtbGVRXuv2XwL4g2xUFwP/HqPhOIUkQuWTulK9wcnA+e PCow== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1693965398; x=1694570198; h=content-transfer-encoding:in-reply-to:from:references:cc:to :content-language:subject:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=wBGN5GBehMBONcZ2of8C24/2uIes/POD73xk+nKq+bY=; b=BE4Nwx3JEhV9+Aq9siAv7PUCstRuaS+Zg4IiW0CB0j5nUdqGnUS5OHNGMSaBixXYXK plbAWZFqNpXptlcfJPlyKARz1exPxwtu2xgE/jZ1uY5NDHWRLJNvYyesuLlcuNErcblV Hs2RMmCWFXoLMsK7f4VXpJQeFL7BDLb5QlYUzn1Y3lCnJaODr/iB2Oinl/WdEY2tzOFi hxpgYLDEPc0Tv+ocxK7lk9v1BP/0HiuGHL9ZEanEaLLUsWFGWSsXYymPOWtaTVJRMax3 AruPjGIOA11YNJFbWM+ixkwMF/QeFWmRSkvNtEdpW4OCj5xSlB7bJ00OODIOaUMSk5Xo hrrA== X-Gm-Message-State: AOJu0YwMlLvdddji258mYHsvdooGA6a8VCbGQH2w+x2r3cXebsmEPDHA ozmmXp6Y3ZwB1IRgxdJLvN4= X-Google-Smtp-Source: AGHT+IEuCi9/to2U04s2J6nPuKbwPAwAZyNv4w0NVXAFBxY4Jnl7OBzJ5VAN9AuhbSILDlTbXVN5UA== X-Received: by 2002:a05:6a21:71cb:b0:13e:e053:1050 with SMTP id ay11-20020a056a2171cb00b0013ee0531050mr16196943pzc.56.1693965398437; Tue, 05 Sep 2023 18:56:38 -0700 (PDT) Received: from [192.168.1.2] (cpe-76-168-148-233.socal.res.rr.com. [76.168.148.233]) by smtp.googlemail.com with ESMTPSA id cg11-20020a056a00290b00b0068c9fc82bfbsm8626271pfb.197.2023.09.05.18.56.37 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Tue, 05 Sep 2023 18:56:37 -0700 (PDT) Message-ID: <992e75c0-32f1-c5bc-e7bd-00c4af5d875d@HIDDEN> Date: Tue, 5 Sep 2023 18:56:36 -0700 MIME-Version: 1.0 Subject: Re: bug#65027: 30.0.50; [PATCH] Document .elpaignore behavior in the Emacs Lisp manual Content-Language: en-US To: Stefan Kangas <stefankangas@HIDDEN> References: <761581a0-fa77-e89c-01e8-d0baeae838f5@HIDDEN> <83cz04xzvk.fsf@HIDDEN> <jwvsf908d87.fsf-monnier+emacs@HIDDEN> <e1299ef1-9313-9ad0-1909-2b63c46e4d92@HIDDEN> <jwvmsz74ye5.fsf-monnier+emacs@HIDDEN> <4cf2941f-299c-fdb6-e2f5-375e8fc4e8e0@HIDDEN> <jwvtttf3g4w.fsf-monnier+emacs@HIDDEN> <b8cc991e-f4b7-23fe-ec34-424e63f6a9df@HIDDEN> <CADwFkmmq0oR93bbWpOUZ1uCgH7A-6pDn3NmV7LqLUNFdGbXqgQ@HIDDEN> From: Jim Porter <jporterbugs@HIDDEN> In-Reply-To: <CADwFkmmq0oR93bbWpOUZ1uCgH7A-6pDn3NmV7LqLUNFdGbXqgQ@HIDDEN> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 65027 Cc: philipk@HIDDEN, 65027 <at> debbugs.gnu.org, info@HIDDEN, corwin@HIDDEN, Stefan Monnier <monnier@HIDDEN>, Eli Zaretskii <eliz@HIDDEN> X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -1.0 (-) On 9/3/2023 4:18 AM, Stefan Kangas wrote: > Jim Porter <jporterbugs@HIDDEN> writes: > >> In any case, if there are no objections in the next day or two, I'll merge my >> patch, and then look into whether there are any other things worth >> documenting. (For example, I'll try to turn my suggested documentation on >> package naming[1] into a patch.) >> >> [1] https://lists.gnu.org/archive/html/emacs-devel/2023-05/msg00452.html > > Was this installed? Otherwise, please go ahead. > > Your patch LGTM. In another subthread for this bug, we'd discussed making a *new* manual that discusses ELPA and/or creating packages for Emacs in general. If we want to create such a manual, I think that's the place my patch should go. However, I'm not sure what the status is on that; I have time to help out with it, but not enough time to write a whole manual myself. I CCed some of the people discussing this into this subthread too.
bug-gnu-emacs@HIDDEN:bug#65027; Package emacs.
Full text available.Received: (at 65027) by debbugs.gnu.org; 3 Sep 2023 11:18:22 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Sun Sep 03 07:18:21 2023 Received: from localhost ([127.0.0.1]:39810 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1qcl7V-0001DJ-Kp for submit <at> debbugs.gnu.org; Sun, 03 Sep 2023 07:18:21 -0400 Received: from mail-lj1-x235.google.com ([2a00:1450:4864:20::235]:50499) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <stefankangas@HIDDEN>) id 1qcl7R-0001D3-Eb for 65027 <at> debbugs.gnu.org; Sun, 03 Sep 2023 07:18:20 -0400 Received: by mail-lj1-x235.google.com with SMTP id 38308e7fff4ca-2bcbfb3705dso7321251fa.1 for <65027 <at> debbugs.gnu.org>; Sun, 03 Sep 2023 04:18:06 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1693739881; x=1694344681; darn=debbugs.gnu.org; h=cc:to:subject:message-id:date:mime-version:references:in-reply-to :from:from:to:cc:subject:date:message-id:reply-to; bh=J5fgH0btpxqeN7IIIKUoy+mckH3Nas4dHDZMeSaO4o0=; b=jDV3c/AYsQQaxnPq2Wdx1h6jQ1Q82KFQ19wjtshaIiT1k4jJNSH0LJXPk5+RH5tOJS o0OShrM+kJhuR6dvgDIDK+TdG5knkLb0j6P+EpK8ZRB5Zplf984yEqXb+YSqYuE9929Y pS1ypajxH/ZC0F/5n7Y+L9U8znHZIZ3dqlsyU7KShCrCE8Mz5vu10J4/C5xYGplnPZ7L xcw11UW2+IWjq2Pt+gXbfXXZ3PhRiGxMCzQFbnwPKmbLNFZNwwAYTEL1Dt+mlOBmMmBD D9yvTW+Hwn8B6AYcC4uXFiUFfPdZ+AqOCSaK3U+9ENTgNI7R4TjBwhRQMetJYpMwonas AV3A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1693739881; x=1694344681; h=cc:to:subject:message-id:date:mime-version:references:in-reply-to :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=J5fgH0btpxqeN7IIIKUoy+mckH3Nas4dHDZMeSaO4o0=; b=Ju+Jl2yu8of2KUlX4X8YEkFaxQVQYLvXeCqO8fI5vSc6xMwfprda6mqM4GxzFnI07z WkJqdLBun5xliPu8zqhxUAzAyq+RRr5udZt4jPbH6pT57/AA9XWDvc3BEsHWwsJWswNW k29UscHFmp0TkwnqWpkXRQQJGjqmZOr+xybzEU7uBm7+syu1roShIyBo4QgLa0AiXZtj nZcB+71c1FrlL9v7m7skEnOHLOywZp8JHHmxt6Uktl5IaOhVVGzuwWNiMwkLKw7YcwYH GzCcWO/HhRtIOyS2LX5Dxq/YvVdedgzNH3v1jtQftm6UbZYlIuN/fuH877COKDjt22y6 pa0g== X-Gm-Message-State: AOJu0YzvCINi1tgX7V2eBlDXHdcwSKV7X9cOKztTyKT4DnfRtFjJdG0b G9kLvkFi63qyQ+YZKHuuGs4+bHQhYkT15Tu5Sig= X-Google-Smtp-Source: AGHT+IGj31MSIpFeHIGt/0oj/PAzbUmruZ67WBc2kPDsTTeOPt1Z0CIW1Yh7exUqbAh6fDDhzPkdyBR34hI/2qgo9pI= X-Received: by 2002:a2e:9c4a:0:b0:2bd:1d02:5026 with SMTP id t10-20020a2e9c4a000000b002bd1d025026mr4532022ljj.15.1693739880992; Sun, 03 Sep 2023 04:18:00 -0700 (PDT) Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sun, 3 Sep 2023 04:18:00 -0700 From: Stefan Kangas <stefankangas@HIDDEN> In-Reply-To: <b8cc991e-f4b7-23fe-ec34-424e63f6a9df@HIDDEN> (Jim Porter's message of "Thu, 3 Aug 2023 20:11:30 -0700") References: <761581a0-fa77-e89c-01e8-d0baeae838f5@HIDDEN> <83cz04xzvk.fsf@HIDDEN> <jwvsf908d87.fsf-monnier+emacs@HIDDEN> <e1299ef1-9313-9ad0-1909-2b63c46e4d92@HIDDEN> <jwvmsz74ye5.fsf-monnier+emacs@HIDDEN> <4cf2941f-299c-fdb6-e2f5-375e8fc4e8e0@HIDDEN> <jwvtttf3g4w.fsf-monnier+emacs@HIDDEN> <b8cc991e-f4b7-23fe-ec34-424e63f6a9df@HIDDEN> MIME-Version: 1.0 Date: Sun, 3 Sep 2023 04:18:00 -0700 Message-ID: <CADwFkmmq0oR93bbWpOUZ1uCgH7A-6pDn3NmV7LqLUNFdGbXqgQ@HIDDEN> Subject: Re: bug#65027: 30.0.50; [PATCH] Document .elpaignore behavior in the Emacs Lisp manual To: Jim Porter <jporterbugs@HIDDEN> Content-Type: text/plain; charset="UTF-8" X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 65027 Cc: philipk@HIDDEN, Eli Zaretskii <eliz@HIDDEN>, Stefan Monnier <monnier@HIDDEN>, 65027 <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -1.0 (-) Jim Porter <jporterbugs@HIDDEN> writes: > In any case, if there are no objections in the next day or two, I'll merge my > patch, and then look into whether there are any other things worth > documenting. (For example, I'll try to turn my suggested documentation on > package naming[1] into a patch.) > > [1] https://lists.gnu.org/archive/html/emacs-devel/2023-05/msg00452.html Was this installed? Otherwise, please go ahead. Your patch LGTM.
bug-gnu-emacs@HIDDEN:bug#65027; Package emacs.
Full text available.
Received: (at 65027) by debbugs.gnu.org; 5 Aug 2023 13:18:11 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sat Aug 05 09:18:10 2023
Received: from localhost ([127.0.0.1]:56114 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1qSHAY-000604-LV
for submit <at> debbugs.gnu.org; Sat, 05 Aug 2023 09:18:10 -0400
Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:36227)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <monnier@HIDDEN>) id 1qSHAW-0005zo-Ba
for 65027 <at> debbugs.gnu.org; Sat, 05 Aug 2023 09:18:09 -0400
Received: from pmg3.iro.umontreal.ca (localhost [127.0.0.1])
by pmg3.iro.umontreal.ca (Proxmox) with ESMTP id 8B2EC440C25;
Sat, 5 Aug 2023 09:18:02 -0400 (EDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=iro.umontreal.ca;
s=mail; t=1691241476;
bh=Qps/wUANXtBP4Hsgx9191ZUrkh3sL1j6mcxny5LPDNc=;
h=From:To:Cc:Subject:In-Reply-To:References:Date:From;
b=hczPIGTWhNAX7mNSAztvy1c1L4A+MVa6qBNUxhY82AoZTefEZcixzbViDIRkZhE0h
v36Mb+IQaVCtf4j9K+X3E7ADutwh7gsxVztqeKKs/jC77sJoSqsj3Zh1EP257xFSCE
Fe+AFM4yVmHLDBFM5Hje4Abuxc7j0ecN+SiAgH24oskgIBASfqzgUUEq5Gy/qnAfu6
0gwmg22KqbX3P/1Ay7rhyD1PtxNVu74Q27zMA/WIYu6oepz5qAgVt3YaeP6BW09rFV
oJIZUUfBS7s79gcNI87oe/HnOspDf0n4YeAba/Dt99+j66X1uC9Nvgxo6xTLrl2oVh
bhjerRCl+e2Vw==
Received: from mail01.iro.umontreal.ca (unknown [172.31.2.1])
by pmg3.iro.umontreal.ca (Proxmox) with ESMTP id C559A440FB1;
Sat, 5 Aug 2023 09:17:56 -0400 (EDT)
Received: from alfajor (unknown [190.16.213.142])
by mail01.iro.umontreal.ca (Postfix) with ESMTPSA id F02301202BC;
Sat, 5 Aug 2023 09:17:54 -0400 (EDT)
From: Stefan Monnier <monnier@HIDDEN>
To: Corwin Brust <corwin@HIDDEN>
Subject: Re: bug#65027: 30.0.50; [PATCH] Document .elpaignore behavior in
the Emacs Lisp manual
In-Reply-To: <CAJf-WoQUqeTAOO9buZSypSO5_0sVyx8CeY+hXA9E2BKAXqiHyw@HIDDEN>
(Corwin Brust's message of "Fri, 4 Aug 2023 21:36:45 -0500")
Message-ID: <jwvil9t1vlw.fsf-monnier+emacs@HIDDEN>
References: <761581a0-fa77-e89c-01e8-d0baeae838f5@HIDDEN>
<83cz04xzvk.fsf@HIDDEN> <jwvsf908d87.fsf-monnier+emacs@HIDDEN>
<e1299ef1-9313-9ad0-1909-2b63c46e4d92@HIDDEN>
<E1qS6Z1-00042J-Qk@HIDDEN>
<CAJf-WoQUqeTAOO9buZSypSO5_0sVyx8CeY+hXA9E2BKAXqiHyw@HIDDEN>
Date: Sat, 05 Aug 2023 09:17:42 -0400
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain
X-SPAM-INFO: Spam detection results: 0
ALL_TRUSTED -1 Passed through trusted hosts only via SMTP
BAYES_00 -1.9 Bayes spam probability is 0 to 1%
DKIM_SIGNED 0.1 Message has a DKIM or DK signature,
not necessarily valid
DKIM_VALID -0.1 Message has at least one valid DKIM or DK signature
DKIM_VALID_AU -0.1 Message has a valid DKIM or DK signature from author's
domain
DKIM_VALID_EF -0.1 Message has a valid DKIM or DK signature from envelope-from
domain
X-SPAM-LEVEL:
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 65027
Cc: Jim Porter <jporterbugs@HIDDEN>, philipk@HIDDEN, rms@HIDDEN,
65027 <at> debbugs.gnu.org, info@HIDDEN, eliz@HIDDEN
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)
> My/our suggestion is to create a new manual ("ELPA: the missing
> manual") that should be provided with Emacs releases, with the current
> version available online via gnu.org.
I tend to agree, and it shouldn't be about "ELPA" but about "Emacs
packages". It could have a "generic" part and then specific subsections
discussing details of specific cases such as ELPA tarballs, (Non)GNU
ELPA, Melpa, straight, etc...
Stefan
bug-gnu-emacs@HIDDEN:bug#65027; Package emacs.
Full text available.
Received: (at 65027) by debbugs.gnu.org; 5 Aug 2023 06:45:37 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sat Aug 05 02:45:37 2023
Received: from localhost ([127.0.0.1]:55273 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1qSB2f-0001PQ-Cu
for submit <at> debbugs.gnu.org; Sat, 05 Aug 2023 02:45:37 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10]:35948)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <eliz@HIDDEN>) id 1qSB2d-0001PE-OA
for 65027 <at> debbugs.gnu.org; Sat, 05 Aug 2023 02:45:36 -0400
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 <eliz@HIDDEN>)
id 1qSB2X-0001zg-Fi; Sat, 05 Aug 2023 02:45:29 -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=IfoyK8PucY7iewaENUtJ898//hJ0VuEwijpWbbh4V50=; b=WtDfV8fjhDor
kHphKSzq5RqoDxkFOAPITmDqtUlKirr1V3YY95OM7O5vUvGu7x5He4XnMItdX4qnFRCVO7O08xOL0
M9+GtD+NIUjUjTKO53OHMHICyJTf8BjuNUdNtvjXcPlfCM03tuduPnvyrQcYLnEPKJLpTXwvCOxnY
OlAibSNaJSfrvXc+YeFuUXNCw3Lpckb/AslWdPuGD+qXZUxMLcxraCd7e8x1abJz+QOd1/3UWXT4G
lMLsnVMSl9TPOzR53Vw3p6mr4k1jX/0yiPVr6CMxZ98SdNVXIMHAgo6ffqeKxD1IadZ2vwnmEvpXA
TuPeWuvs0Vv5zGBmAsoDZw==;
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 <eliz@HIDDEN>)
id 1qSB2Q-00053P-4k; Sat, 05 Aug 2023 02:45:23 -0400
Date: Sat, 05 Aug 2023 09:45:36 +0300
Message-Id: <83pm42t2b3.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
To: Corwin Brust <corwin@HIDDEN>
In-Reply-To: <CAJf-WoQUqeTAOO9buZSypSO5_0sVyx8CeY+hXA9E2BKAXqiHyw@HIDDEN>
(message from Corwin Brust on Fri, 4 Aug 2023 21:36:45 -0500)
Subject: Re: bug#65027: 30.0.50; [PATCH] Document .elpaignore behavior in the
Emacs Lisp manual
References: <761581a0-fa77-e89c-01e8-d0baeae838f5@HIDDEN>
<83cz04xzvk.fsf@HIDDEN> <jwvsf908d87.fsf-monnier+emacs@HIDDEN>
<e1299ef1-9313-9ad0-1909-2b63c46e4d92@HIDDEN>
<E1qS6Z1-00042J-Qk@HIDDEN>
<CAJf-WoQUqeTAOO9buZSypSO5_0sVyx8CeY+hXA9E2BKAXqiHyw@HIDDEN>
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 65027
Cc: jporterbugs@HIDDEN, philipk@HIDDEN, rms@HIDDEN,
65027 <at> debbugs.gnu.org, info@HIDDEN, monnier@HIDDEN
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)
> From: Corwin Brust <corwin@HIDDEN>
> Date: Fri, 4 Aug 2023 21:36:45 -0500
> Cc: Jim Porter <jporterbugs@HIDDEN>, philipk@HIDDEN, eliz@HIDDEN,
> monnier@HIDDEN, 65027 <at> debbugs.gnu.org
>
> My/our suggestion is to create a new manual ("ELPA: the missing
> manual") that should be provided with Emacs releases, with the current
> version available online via gnu.org.
If this is a replacement for the ELPA README, that'd be fine. But if
you intend to remove stuff from the ELisp manual into this new manual,
please be sure to coordinate with me first.
bug-gnu-emacs@HIDDEN:bug#65027; Package emacs.
Full text available.Received: (at 65027) by debbugs.gnu.org; 5 Aug 2023 06:43:59 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Sat Aug 05 02:43:59 2023 Received: from localhost ([127.0.0.1]:55266 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1qSB14-0001M0-TC for submit <at> debbugs.gnu.org; Sat, 05 Aug 2023 02:43:59 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:55942) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1qSB12-0001Ln-F5 for 65027 <at> debbugs.gnu.org; Sat, 05 Aug 2023 02:43:57 -0400 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 <eliz@HIDDEN>) id 1qSB0w-0001fv-1d; Sat, 05 Aug 2023 02:43:50 -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=wqIDsjHhoOgDg8VIu7sIPmJhpsgJTA1CacY6VkTYHAo=; b=A+B4oFRev1R7 c5Ycm7jYFSooBurQBYFmqLEMpqmhtt8xa5J82UfZivWtg9GYlEhTG0ochhkb3W6LbiYMSEiMIbRzD dt1FNduG7spD/uELA+Q8JPrQZga2+2mFllTxjrqBmfZX0lf5kriUCj1Rl8ujGqfF8Z9sYqgAqxP6g B88/kdUZbgUPGsiVJKkV5FjjFq6yfc1cI7puKtIUo1kAox8PJyn8JQJXYd6vPBMkSUpWBwAT27eOH iQgRrMC+f86WkLUlG2PPqwqIUDIWRFrQVs45VuPzFWwbS2jt7b5crD2fVajeFeQpu+ZqacTezp8Rx Wq7Fen7q3eWzfbkP0Gh8Ng==; 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 <eliz@HIDDEN>) id 1qSB0n-0004t4-JB; Sat, 05 Aug 2023 02:43:41 -0400 Date: Sat, 05 Aug 2023 09:43:56 +0300 Message-Id: <83r0oit2dv.fsf@HIDDEN> From: Eli Zaretskii <eliz@HIDDEN> To: rms@HIDDEN In-Reply-To: <E1qS6Z1-00042J-Qk@HIDDEN> (message from Richard Stallman on Fri, 04 Aug 2023 21:58:43 -0400) Subject: Re: bug#65027: 30.0.50; [PATCH] Document .elpaignore behavior in the Emacs Lisp manual References: <761581a0-fa77-e89c-01e8-d0baeae838f5@HIDDEN> <83cz04xzvk.fsf@HIDDEN> <jwvsf908d87.fsf-monnier+emacs@HIDDEN> <e1299ef1-9313-9ad0-1909-2b63c46e4d92@HIDDEN> <E1qS6Z1-00042J-Qk@HIDDEN> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 65027 Cc: jporterbugs@HIDDEN, philipk@HIDDEN, monnier@HIDDEN, 65027 <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -3.3 (---) > From: Richard Stallman <rms@HIDDEN> > Cc: monnier@HIDDEN, eliz@HIDDEN, philipk@HIDDEN, > 65027 <at> debbugs.gnu.org > Date: Fri, 04 Aug 2023 21:58:43 -0400 > > > Maybe it would make sense to put all the documentation in the Emacs Lisp > > manual, > > That has a drawback: it would make the Emacs Lisp Reference Manual > substantially bigger. Copies would be less convenient and more > expensive. I don't think there's a real danger here. The necessary additions to what is already in the ELisp manual are small. The reason the ELisp manual touches on these issues is because it describes package.el, which is a much more general facility, not limited to ELPA. The ELPA-specific stuff should not be described there, only mentioned with a reference to the ELPA README.
bug-gnu-emacs@HIDDEN:bug#65027; Package emacs.
Full text available.
Received: (at 65027) by debbugs.gnu.org; 5 Aug 2023 06:03:47 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sat Aug 05 02:03:47 2023
Received: from localhost ([127.0.0.1]:55241 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1qSAOA-0000QU-Ms
for submit <at> debbugs.gnu.org; Sat, 05 Aug 2023 02:03:46 -0400
Received: from mail-ot1-x330.google.com ([2607:f8b0:4864:20::330]:47339)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <jporterbugs@HIDDEN>) id 1qSAO9-0000QI-4W
for 65027 <at> debbugs.gnu.org; Sat, 05 Aug 2023 02:03:45 -0400
Received: by mail-ot1-x330.google.com with SMTP id
46e09a7af769-6bcac140aaaso2386952a34.2
for <65027 <at> debbugs.gnu.org>; Fri, 04 Aug 2023 23:03:45 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=gmail.com; s=20221208; t=1691215419; x=1691820219;
h=content-transfer-encoding:in-reply-to:from:references:cc:to
:content-language:subject:mime-version:date:message-id:from:to:cc
:subject:date:message-id:reply-to;
bh=x1/ceHll0jTOtusyBUyzDs7AnTVe3U2LvmMV7fI7aIE=;
b=Nzjc15uW5zD4lzlaWRTJVFDgM3GquJQgic7GRk2uOABttQAnsVTX10IkenKIm9SrYY
UliTpliIPJ84YpaovmRTG2ecH65fgn0zewr8n0KXXQzcuD7XiVBNZLUDR6cVCu/bc6X3
mLjR28OoxMM4s3uDVzAv6WyoDBgWd7GbD91IonhNtf9iGA4JOJFceTaFVRqXhDmEMNTa
PcgTYtdeD70/vWJ3ca2cRCy6ScyvfeInuqv944TpasAO0zNhUjYkTHa2JIrQUpNKLrU8
hF8VjUpQj1b6DefMd6kTsXkgRDrlO8dcb3Zc4u82vOfMmSPY1bMYPg+nor9unQPDrZOs
zuSA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=1e100.net; s=20221208; t=1691215419; x=1691820219;
h=content-transfer-encoding:in-reply-to:from:references:cc:to
:content-language:subject:mime-version:date:message-id
:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to;
bh=x1/ceHll0jTOtusyBUyzDs7AnTVe3U2LvmMV7fI7aIE=;
b=TViZ9oGtvZqUp8+06cB7DpKd914uNE1eKjozBt/5t14Cw5eBseisqeHDcqNOg1ym0E
SmlzHb0I/x64CllYVtPOedXKLUEuMILEYT2r6YKoX9IwhXaE8Il4nBeJSJYbsRgXW7XI
shbuxwiXOdzefoaqy0Ze0p7k/XlBtn2NWiT55qHd34YpraXqNhohxeroJ5wk1Fttj1Ph
/aHyEJ2KHAWWufG9a7hryxiBMiHt2FR2iGWX209F3BbU3MJxwkLKQcevzqImcD99bwQ8
XNQCW0ax9QlYaysNE+OVOEd1NzpvObD9V/tRXCNaPt/i+mBiV048rZ3QAVjo6tKPDD7U
6oPA==
X-Gm-Message-State: AOJu0Yx9a7ES9rG3K5LIGgORAWGNdF8Y1N6mY0yBbEW9g36OuS5j2tbD
hEDINgLPbTM75bxUZxZrGWw=
X-Google-Smtp-Source: AGHT+IGT7IwIq+gwki7o12e93Rl8SNlgfsTdOwoidgRLEpTjo25FvVGT+6W4FWcB1V+nlbMTD8SUng==
X-Received: by 2002:a05:6870:65a0:b0:1ba:caf2:acc3 with SMTP id
fp32-20020a05687065a000b001bacaf2acc3mr5297238oab.5.1691215419407;
Fri, 04 Aug 2023 23:03:39 -0700 (PDT)
Received: from [192.168.1.2] (cpe-76-168-148-233.socal.res.rr.com.
[76.168.148.233]) by smtp.googlemail.com with ESMTPSA id
ca7-20020a17090af30700b0025bdc3454c6sm5003175pjb.8.2023.08.04.23.03.38
(version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128);
Fri, 04 Aug 2023 23:03:39 -0700 (PDT)
Message-ID: <6591aa9d-17ab-188f-6f62-108c66558ae9@HIDDEN>
Date: Fri, 4 Aug 2023 23:03:39 -0700
MIME-Version: 1.0
Subject: Re: bug#65027: 30.0.50; [PATCH] Document .elpaignore behavior in the
Emacs Lisp manual
Content-Language: en-US
To: Corwin Brust <corwin@HIDDEN>, rms@HIDDEN, info@HIDDEN
References: <761581a0-fa77-e89c-01e8-d0baeae838f5@HIDDEN>
<83cz04xzvk.fsf@HIDDEN> <jwvsf908d87.fsf-monnier+emacs@HIDDEN>
<e1299ef1-9313-9ad0-1909-2b63c46e4d92@HIDDEN>
<E1qS6Z1-00042J-Qk@HIDDEN>
<CAJf-WoQUqeTAOO9buZSypSO5_0sVyx8CeY+hXA9E2BKAXqiHyw@HIDDEN>
From: Jim Porter <jporterbugs@HIDDEN>
In-Reply-To: <CAJf-WoQUqeTAOO9buZSypSO5_0sVyx8CeY+hXA9E2BKAXqiHyw@HIDDEN>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit
X-Spam-Score: -0.0 (/)
X-Debbugs-Envelope-To: 65027
Cc: philipk@HIDDEN, eliz@HIDDEN, monnier@HIDDEN,
65027 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)
On 8/4/2023 7:36 PM, Corwin Brust wrote:
> On Fri, Aug 4, 2023 at 8:58 PM Richard Stallman <rms@HIDDEN> wrote:
>>
>> I think there is no need for this material to be in the Emacs Lisp
>> Reference Manual. So I suggest making a separate short manual about
>> adding a package to GNU ELPA. The Emacs Lisp Reference Manual can
>> direct people to it.
>
> My/our suggestion is to create a new manual ("ELPA: the missing
> manual") that should be provided with Emacs releases, with the current
> version available online via gnu.org.
That makes sense to me. I'd be happy to help contribute to this new
manual if others have interest in helping to share the load.
bug-gnu-emacs@HIDDEN:bug#65027; Package emacs.
Full text available.
Received: (at 65027) by debbugs.gnu.org; 5 Aug 2023 02:37:04 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Fri Aug 04 22:37:04 2023
Received: from localhost ([127.0.0.1]:55124 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1qS7A7-0000dD-K5
for submit <at> debbugs.gnu.org; Fri, 04 Aug 2023 22:37:03 -0400
Received: from mail-oi1-f172.google.com ([209.85.167.172]:45484)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <mplscorwin@HIDDEN>) id 1qS7A6-0000cg-8F
for 65027 <at> debbugs.gnu.org; Fri, 04 Aug 2023 22:37:02 -0400
Received: by mail-oi1-f172.google.com with SMTP id
5614622812f47-3a6f87b2993so2092159b6e.3
for <65027 <at> debbugs.gnu.org>; Fri, 04 Aug 2023 19:37:02 -0700 (PDT)
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=1e100.net; s=20221208; t=1691203016; x=1691807816;
h=content-transfer-encoding:cc:to:subject:message-id:date:from
:in-reply-to:references:mime-version:x-gm-message-state:from:to:cc
:subject:date:message-id:reply-to;
bh=oPFF7Ksw83+X3m7a5+jwTmtcofe2xTKBvMAXpzAvPBI=;
b=PsZ8VN+U0OjLg4U0b/eoIrtGZdOPMK8RiaD7FM+aMLRfvvlmAr9IkJwGrUmGEc7+e+
6WLOg3N5K5LDwm0gLSUVX69vu4gjXntIjhFrkW30hu3A48+RTNSjtOxocP6Lc/Ksed7J
iGazBPaFPoaM5hB80qOPklfHlPHg3HYVRGyf0jlms5Yep00y9nBcjhGTP2EtkMqzfddu
8iIxKLptwOpDZfq0YtzKCQ1f7Tkwm0ABQjSQJTIE2D9tt0ASWiLgfanvBXOXb0eR3rV/
ts4QVKbqkxGNhv7xRhJOm9VIika520NX4l2+EdxUeX+FqXrgWF9SAJIrbYEiONsIyB2C
Z+UA==
X-Gm-Message-State: AOJu0Yy41dn4tHAT0SDOfDcqf7b6lv4HviX3gt0eUqpNfn/TRJk+cNfW
IeUn7+nn9acmXzDMn6wMoCDXign8qRZEW8cn8Lg=
X-Google-Smtp-Source: AGHT+IGKq7ZCJ6+3IsZmomWA4v3wiDXSeOfqAaWVdCejChY1qkjocRTeLQ6A3gHjG/Ff50FVW79aohJ8s4p6a4GZh4c=
X-Received: by 2002:a54:4886:0:b0:3a7:238a:143e with SMTP id
r6-20020a544886000000b003a7238a143emr3868074oic.2.1691203016390; Fri, 04 Aug
2023 19:36:56 -0700 (PDT)
MIME-Version: 1.0
References: <761581a0-fa77-e89c-01e8-d0baeae838f5@HIDDEN>
<83cz04xzvk.fsf@HIDDEN> <jwvsf908d87.fsf-monnier+emacs@HIDDEN>
<e1299ef1-9313-9ad0-1909-2b63c46e4d92@HIDDEN>
<E1qS6Z1-00042J-Qk@HIDDEN>
In-Reply-To: <E1qS6Z1-00042J-Qk@HIDDEN>
From: Corwin Brust <corwin@HIDDEN>
Date: Fri, 4 Aug 2023 21:36:45 -0500
Message-ID: <CAJf-WoQUqeTAOO9buZSypSO5_0sVyx8CeY+hXA9E2BKAXqiHyw@HIDDEN>
Subject: Re: bug#65027: 30.0.50; [PATCH] Document .elpaignore behavior in the
Emacs Lisp manual
To: rms@HIDDEN, info@HIDDEN
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: 0.5 (/)
X-Debbugs-Envelope-To: 65027
Cc: Jim Porter <jporterbugs@HIDDEN>, philipk@HIDDEN,
65027 <at> debbugs.gnu.org, eliz@HIDDEN, monnier@HIDDEN
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -0.5 (/)
On Fri, Aug 4, 2023 at 8:58=E2=80=AFPM Richard Stallman <rms@HIDDEN> wrote=
:
>
> [[[ 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. ]]]
>
> > Yeah, something more general that I've noticed is that as a package
> > author, the documentation for how to make a package for GNU ELPA is
> > split between the GNU ELPA README and the Emacs Lisp manual.
>
> It could be an improvement to merge all that documentation into one
> text and rewrite it for coherence and clarity.
I have been discussing a similar ideal with some others off list, of
whom I'm tagging in (potentially sharing blame with ;) only prot.
> That has a drawback: it would make the Emacs Lisp Reference Manual
> substantially bigger. Copies would be less convenient and more
> expensive.
>
> I think there is no need for this material to be in the Emacs Lisp
> Reference Manual. So I suggest making a separate short manual about
> adding a package to GNU ELPA. The Emacs Lisp Reference Manual can
> direct people to it.
My/our suggestion is to create a new manual ("ELPA: the missing
manual") that should be provided with Emacs releases, with the current
version available online via gnu.org.
This new manual can start with some new (and/or moved, consolidated,
expanded, ...) sections aimed at Emacs users wanting a deeper
understanding of Emacs packaging. Following that, it can include some
specifics ("best practices"?) especially for package authors, with the
remainder being collected manuals for ELPA packages.
A slight twist on this idea could be to frame more generally, for
example "Emacs Features and Packaging" (instead of anything about
ELPA). This might allow
In any event, if this seems worth discussing further, I think work
could begin with agreeing on the specific (and probably rather narrow)
scope. I think we need, for example, to describe the criteria used to
decide what goes into the proposed addition manual. We might also
want to create a "rubric" (simple rule, or very simple flow chart)
that helps us understand when a feature's documentation will be in the
Emacs manual, the elisp manual, or this new manual, and so on, until
the task beings to look ominously do-able or all volunteers are scared
off >:)
Prot, am I right that you (still, also) have energy for something like
this? Other thoughts as you consider in the context of this thread?
bug-gnu-emacs@HIDDEN:bug#65027; Package emacs.
Full text available.Received: (at 65027) by debbugs.gnu.org; 5 Aug 2023 01:58:54 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Fri Aug 04 21:58:54 2023 Received: from localhost ([127.0.0.1]:55070 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1qS6ZB-00086T-Oz for submit <at> debbugs.gnu.org; Fri, 04 Aug 2023 21:58:54 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:37636) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <rms@HIDDEN>) id 1qS6Z9-00086D-Jm for 65027 <at> debbugs.gnu.org; Fri, 04 Aug 2023 21:58:52 -0400 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 <rms@HIDDEN>) id 1qS6Z3-0000BG-Ng; Fri, 04 Aug 2023 21:58:45 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=Date:References:Subject:In-Reply-To:To:From: mime-version; bh=FTZ90M5Ovi93nFYgU7COQSgbW0KdnVWIA45letNMJkA=; b=pNcda1l3SZUr I7L/lWettVzotkAHV7Y+PNrOCI7aca446cZTjCaVoBq0chlLcBSpRh9d+8rH/JWMSzMa95+LGi7Xu 3N3FockaL6rKf64OfQ1UYpjK+WkiDYUTssp3+ePnH2VoNVsiFi9FSXTpqNTlhVCdRZQ4wy/HN8CR/ C+KMvpVUD2LfGMuNwoQ2fBtyyhDnvYHr6005FXt9RO/cVrA5xH+yWg6pZPDzvLzrjIJX7c82ETA4d eLCiLq/hhCB0mXJJJMFqpnq5R6XBTJOmz5T/ZsjrqavRf+a9C86jStnYU0CFUitQ4lNSYol/DOQWx PmDjfR8GwRrJ31JIWXkzbQ==; Received: from rms by fencepost.gnu.org with local (Exim 4.90_1) (envelope-from <rms@HIDDEN>) id 1qS6Z1-00042J-Qk; Fri, 04 Aug 2023 21:58:44 -0400 Content-Type: text/plain; charset=Utf-8 From: Richard Stallman <rms@HIDDEN> To: Jim Porter <jporterbugs@HIDDEN> In-Reply-To: <e1299ef1-9313-9ad0-1909-2b63c46e4d92@HIDDEN> (message from Jim Porter on Thu, 3 Aug 2023 10:24:58 -0700) Subject: Re: bug#65027: 30.0.50; [PATCH] Document .elpaignore behavior in the Emacs Lisp manual References: <761581a0-fa77-e89c-01e8-d0baeae838f5@HIDDEN> <83cz04xzvk.fsf@HIDDEN> <jwvsf908d87.fsf-monnier+emacs@HIDDEN> <e1299ef1-9313-9ad0-1909-2b63c46e4d92@HIDDEN> Message-Id: <E1qS6Z1-00042J-Qk@HIDDEN> Date: Fri, 04 Aug 2023 21:58:43 -0400 X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 65027 Cc: philipk@HIDDEN, eliz@HIDDEN, monnier@HIDDEN, 65027 <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Reply-To: rms@HIDDEN Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -3.3 (---) [[[ 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. ]]] > Yeah, something more general that I've noticed is that as a package > author, the documentation for how to make a package for GNU ELPA is > split between the GNU ELPA README and the Emacs Lisp manual. It could be an improvement to merge all that documentation into one text and rewrite it for coherence and clarity. > Maybe it would make sense to put all the documentation in the Emacs Lisp > manual, That has a drawback: it would make the Emacs Lisp Reference Manual substantially bigger. Copies would be less convenient and more expensive. I think there is no need for this material to be in the Emacs Lisp Reference Manual. So I suggest making a separate short manual about adding a package to GNU ELPA. The Emacs Lisp Reference Manual can direct people to it. -- Dr Richard Stallman (https://stallman.org) Chief GNUisance of the GNU Project (https://gnu.org) Founder, Free Software Foundation (https://fsf.org) Internet Hall-of-Famer (https://internethalloffame.org)
bug-gnu-emacs@HIDDEN:bug#65027; Package emacs.
Full text available.Received: (at 65027) by debbugs.gnu.org; 4 Aug 2023 05:42:50 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Fri Aug 04 01:42:50 2023 Received: from localhost ([127.0.0.1]:53257 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1qRnaM-0006MB-GY for submit <at> debbugs.gnu.org; Fri, 04 Aug 2023 01:42:50 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:53788) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1qRnaK-0006Ly-GZ for 65027 <at> debbugs.gnu.org; Fri, 04 Aug 2023 01:42:49 -0400 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 <eliz@HIDDEN>) 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==; 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 <eliz@HIDDEN>) id 1qRnaE-0001ah-4P; Fri, 04 Aug 2023 01:42:42 -0400 Date: Fri, 04 Aug 2023 08:42:53 +0300 Message-Id: <83il9vweg2.fsf@HIDDEN> From: Eli Zaretskii <eliz@HIDDEN> To: Jim Porter <jporterbugs@HIDDEN> In-Reply-To: <4cf2941f-299c-fdb6-e2f5-375e8fc4e8e0@HIDDEN> (message from Jim Porter on Thu, 3 Aug 2023 15:02:12 -0700) Subject: Re: bug#65027: 30.0.50; [PATCH] Document .elpaignore behavior in the Emacs Lisp manual References: <761581a0-fa77-e89c-01e8-d0baeae838f5@HIDDEN> <83cz04xzvk.fsf@HIDDEN> <jwvsf908d87.fsf-monnier+emacs@HIDDEN> <e1299ef1-9313-9ad0-1909-2b63c46e4d92@HIDDEN> <jwvmsz74ye5.fsf-monnier+emacs@HIDDEN> <4cf2941f-299c-fdb6-e2f5-375e8fc4e8e0@HIDDEN> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 65027 Cc: philipk@HIDDEN, monnier@HIDDEN, 65027 <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -3.3 (---) > Date: Thu, 3 Aug 2023 15:02:12 -0700 > Cc: Eli Zaretskii <eliz@HIDDEN>, philipk@HIDDEN, 65027 <at> debbugs.gnu.org > From: Jim Porter <jporterbugs@HIDDEN> > > 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.
bug-gnu-emacs@HIDDEN:bug#65027; Package emacs.
Full text available.Received: (at 65027) by debbugs.gnu.org; 4 Aug 2023 03:11:39 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Thu Aug 03 23:11:39 2023 Received: from localhost ([127.0.0.1]:53177 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1qRlE2-0002Kc-NE for submit <at> debbugs.gnu.org; Thu, 03 Aug 2023 23:11:39 -0400 Received: from mail-vk1-xa33.google.com ([2607:f8b0:4864:20::a33]:47231) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <jporterbugs@HIDDEN>) id 1qRlE0-0002KO-Sk for 65027 <at> debbugs.gnu.org; Thu, 03 Aug 2023 23:11:37 -0400 Received: by mail-vk1-xa33.google.com with SMTP id 71dfb90a1353d-4871ccf89f7so52753e0c.2 for <65027 <at> debbugs.gnu.org>; Thu, 03 Aug 2023 20:11:36 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1691118691; x=1691723491; h=content-transfer-encoding:in-reply-to:from:references:cc:to :content-language:subject:mime-version:date:message-id:from:to:cc :subject:date:message-id:reply-to; bh=LNOASkkMzPIlUGBlB5CCJ9hFbmbR5CAPPdEQIZpX25o=; b=iD3dzm4mwUXm2VlSwBLd04HXAxOiMgjyCTRUIvMfBi3WKF2zJVnXGob4in/C16QQiL mkqXKTUHuKSLKCOurC8PWU3W2bbX/7nffzjI0eH0GaJ6MQ+2Vhxi8u1C/cqvKcVDgIYZ BB08ZVSqIqfUOMH9em62rbksoj73MXrKcca6aMUWXGOHBUdK072dcwA6I6JnKIQ4H+st PYBSghQQWG7o4vmScI/SllQZx0OsK8xfolVmHwxDcjXuTjz7rrOUc67IMXZNzuurdOxW xeqKB7uqc0wMZrBVp63KRmB1YlkpkAaHv1upmxfszHr8rrJwduQfi1lyCdoPyBfWywAv m4Xg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1691118691; x=1691723491; h=content-transfer-encoding:in-reply-to:from:references:cc:to :content-language:subject:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=LNOASkkMzPIlUGBlB5CCJ9hFbmbR5CAPPdEQIZpX25o=; b=gvWT03ny6tRRp7tlwQQcfiRGp6Onv4J1NXMHuJDKMGMkXsBstuqIW3FScnMUXwwvf9 hjKWPWgJjp2mxBIxbJ2Jo40IAowe6CnBOA+L3Epym7sabcXC4I89Vn1XN9WWiFYBJYzm E3xmkjL8aNsotLKoECzOjVwxtC+txeqPqXdIc36ULhDfBLuANN+dPaBzAuExvYLfZlF/ XYClqtRU+DzHvrLVlguwJdouo8esE2rqP7VizlYawgetCERXmm1FHZzSNI3aCsDEOAG3 rKMC6JZu1dRRxfXSo+qiVxavUdByXQ1UMPATDQ9vrbE8e+0zVAXLP3VR8P9PfzQOS1Cg bT7Q== X-Gm-Message-State: AOJu0Yxr9Z+5PGfmcNvevavCAbdIIAzykdYY8cT89s7KoC30PNoQ0kuB UaCq8D4miW8GQDAtledno6g= X-Google-Smtp-Source: AGHT+IFeW7k4emlnDI8CMsJ2wF2uT1P5qEpBJtFRtbTn89y2WXhQ1t0QQTp2xzk+daXxmmwK5POVqA== X-Received: by 2002:a1f:bf16:0:b0:46e:85b8:c019 with SMTP id p22-20020a1fbf16000000b0046e85b8c019mr313582vkf.1.1691118691177; Thu, 03 Aug 2023 20:11:31 -0700 (PDT) Received: from [192.168.1.2] (cpe-76-168-148-233.socal.res.rr.com. [76.168.148.233]) by smtp.googlemail.com with ESMTPSA id 9-20020a17090a0cc900b002676e961261sm4714381pjt.1.2023.08.03.20.11.30 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Thu, 03 Aug 2023 20:11:30 -0700 (PDT) Message-ID: <b8cc991e-f4b7-23fe-ec34-424e63f6a9df@HIDDEN> Date: Thu, 3 Aug 2023 20:11:30 -0700 MIME-Version: 1.0 Subject: Re: bug#65027: 30.0.50; [PATCH] Document .elpaignore behavior in the Emacs Lisp manual Content-Language: en-US To: Stefan Monnier <monnier@HIDDEN> References: <761581a0-fa77-e89c-01e8-d0baeae838f5@HIDDEN> <83cz04xzvk.fsf@HIDDEN> <jwvsf908d87.fsf-monnier+emacs@HIDDEN> <e1299ef1-9313-9ad0-1909-2b63c46e4d92@HIDDEN> <jwvmsz74ye5.fsf-monnier+emacs@HIDDEN> <4cf2941f-299c-fdb6-e2f5-375e8fc4e8e0@HIDDEN> <jwvtttf3g4w.fsf-monnier+emacs@HIDDEN> From: Jim Porter <jporterbugs@HIDDEN> In-Reply-To: <jwvtttf3g4w.fsf-monnier+emacs@HIDDEN> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 65027 Cc: Eli Zaretskii <eliz@HIDDEN>, philipk@HIDDEN, 65027 <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -1.0 (-) On 8/3/2023 3:41 PM, Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors wrote: > 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`. Yeah. I do think as a package author who once wasn't sure about exactly what I should do to make my Emacs package follow best-practices, the first place I'd look is in the Package section of the Emacs Lisp manual (regardless of where the implementations for package management live). But, like you say, now that 'package-vc' exists, Emacs itself now knows (some) about the repo format, too. In any case, if there are no objections in the next day or two, I'll merge my patch, and then look into whether there are any other things worth documenting. (For example, I'll try to turn my suggested documentation on package naming[1] into a patch.) [1] https://lists.gnu.org/archive/html/emacs-devel/2023-05/msg00452.html
bug-gnu-emacs@HIDDEN:bug#65027; Package emacs.
Full text available.
Received: (at 65027) by debbugs.gnu.org; 3 Aug 2023 22:42:07 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Thu Aug 03 18:42:07 2023
Received: from localhost ([127.0.0.1]:53101 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1qRh1D-0003qZ-0K
for submit <at> debbugs.gnu.org; Thu, 03 Aug 2023 18:42:07 -0400
Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:34178)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <monnier@HIDDEN>) id 1qRh1B-0003q5-Mg
for 65027 <at> debbugs.gnu.org; Thu, 03 Aug 2023 18:42:06 -0400
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==
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)
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)
From: Stefan Monnier <monnier@HIDDEN>
To: Jim Porter <jporterbugs@HIDDEN>
Subject: Re: bug#65027: 30.0.50; [PATCH] Document .elpaignore behavior in
the Emacs Lisp manual
In-Reply-To: <4cf2941f-299c-fdb6-e2f5-375e8fc4e8e0@HIDDEN> (Jim Porter's
message of "Thu, 3 Aug 2023 15:02:12 -0700")
Message-ID: <jwvtttf3g4w.fsf-monnier+emacs@HIDDEN>
References: <761581a0-fa77-e89c-01e8-d0baeae838f5@HIDDEN>
<83cz04xzvk.fsf@HIDDEN> <jwvsf908d87.fsf-monnier+emacs@HIDDEN>
<e1299ef1-9313-9ad0-1909-2b63c46e4d92@HIDDEN>
<jwvmsz74ye5.fsf-monnier+emacs@HIDDEN>
<4cf2941f-299c-fdb6-e2f5-375e8fc4e8e0@HIDDEN>
Date: Thu, 03 Aug 2023 18:41:55 -0400
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain
X-SPAM-INFO: Spam detection results: 0
ALL_TRUSTED -1 Passed through trusted hosts only via SMTP
AWL 0.011 Adjusted score from AWL reputation of From: address
BAYES_00 -1.9 Bayes spam probability is 0 to 1%
DKIM_SIGNED 0.1 Message has a DKIM or DK signature,
not necessarily valid
DKIM_VALID -0.1 Message has at least one valid DKIM or DK signature
DKIM_VALID_AU -0.1 Message has a valid DKIM or DK signature from author's
domain
DKIM_VALID_EF -0.1 Message has a valid DKIM or DK signature from envelope-from
domain T_SCC_BODY_TEXT_LINE -0.01 -
X-SPAM-LEVEL:
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 65027
Cc: Eli Zaretskii <eliz@HIDDEN>, philipk@HIDDEN, 65027 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)
>>> 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
bug-gnu-emacs@HIDDEN:bug#65027; Package emacs.
Full text available.Received: (at 65027) by debbugs.gnu.org; 3 Aug 2023 22:02:21 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Thu Aug 03 18:02:21 2023 Received: from localhost ([127.0.0.1]:53080 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1qRgOj-0002gM-Di for submit <at> debbugs.gnu.org; Thu, 03 Aug 2023 18:02:21 -0400 Received: from mail-pj1-x1030.google.com ([2607:f8b0:4864:20::1030]:51665) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <jporterbugs@HIDDEN>) id 1qRgOh-0002g0-Tt for 65027 <at> debbugs.gnu.org; Thu, 03 Aug 2023 18:02:20 -0400 Received: by mail-pj1-x1030.google.com with SMTP id 98e67ed59e1d1-268030e1be7so808419a91.3 for <65027 <at> debbugs.gnu.org>; Thu, 03 Aug 2023 15:02:19 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1691100134; x=1691704934; h=content-transfer-encoding:in-reply-to:from:references:cc:to :content-language:subject:mime-version:date:message-id:from:to:cc :subject:date:message-id:reply-to; bh=5F13etjEKj7wlpiZ+tQEv/yYRBkCGRXNxVEx0Arxuck=; b=bCQm74gQ5HV+VO3hxcn7pNRZ1a6n7VR1X0QKn8RnYXEv/URORM+EeZdmoXYRnVu/EH Kdx8UxNwL2mJH/VwlppAa23K9kkj6AHJUJ93CAl3+EKVZimyL4+6aNlobMgcF9/pgkom JIx1Z6M4r/T1zqbw2ZPx5RXdT2sa2fG+h4h/6sfpcVczPdJH9bCZLvAxaJ0yZIRxQY7C 8E0un+Dxqyi4xF7HJfESN0lQKKL/gp2Sp2H6/ybW56A5yZ+FKlWPSnpzvl/jOnsLTlph qq8ZILmYp3ZvfH20+vK/Mp1qUi3b+wD5VBUzOMm+1F6MzYLh6g8vsVnJxLYjwPrDgImq dLCA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1691100134; x=1691704934; h=content-transfer-encoding:in-reply-to:from:references:cc:to :content-language:subject:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=5F13etjEKj7wlpiZ+tQEv/yYRBkCGRXNxVEx0Arxuck=; b=X68/WzupvmzZq3PbL/d7FY5sqdSzhVGxA9fxe2wZf6z4mOyCBYCiYeVahZfXzBHNvC D2B6mqLfk7bTOZ6zsnI+G8fo2Sd8r5PDwtN92IPvYnWcqbJyCtyjH5h31OfWYFJseTge C4v66CG0Q7/nGI/yTlbmwJ8J90r3Kkwe6XMMnt48f4HKD+II3MBbKPPpg5nIB0q/8/0h ufhm9dUUrbA4rYNGuu3C5vLFZaOuOoTDM44oc1DX1webSJC7T7lNTx28YrEgfZPgRgS9 Fm2teTIr3tR2U/7OnM3cB8hu4Kj7Ttcfp7ow/rGee45RQuPghDOLLe52+mRlIxQ//lSq uzGg== X-Gm-Message-State: AOJu0YyFUhzUkZJ2mFppXecN2XBNjGfPBbugjhuY3Zp1trHI8k/89eEy Rbld/EsU8DC5I8fd+ltMMXo= X-Google-Smtp-Source: AGHT+IFepHxSfUKZvFiJcjH8YtTXUFDuZS/MBakhZu2vllw78+TdmsYQDNJiOQ0PZ2dZ4OshGQd5OA== X-Received: by 2002:a17:90a:a04:b0:267:faba:705 with SMTP id o4-20020a17090a0a0400b00267faba0705mr15663pjo.10.1691100133858; Thu, 03 Aug 2023 15:02:13 -0700 (PDT) Received: from [192.168.1.2] (cpe-76-168-148-233.socal.res.rr.com. [76.168.148.233]) by smtp.googlemail.com with ESMTPSA id 8-20020a17090a19c800b002690aa4c292sm351239pjj.39.2023.08.03.15.02.13 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Thu, 03 Aug 2023 15:02:13 -0700 (PDT) Message-ID: <4cf2941f-299c-fdb6-e2f5-375e8fc4e8e0@HIDDEN> Date: Thu, 3 Aug 2023 15:02:12 -0700 MIME-Version: 1.0 Subject: Re: bug#65027: 30.0.50; [PATCH] Document .elpaignore behavior in the Emacs Lisp manual Content-Language: en-US To: Stefan Monnier <monnier@HIDDEN> References: <761581a0-fa77-e89c-01e8-d0baeae838f5@HIDDEN> <83cz04xzvk.fsf@HIDDEN> <jwvsf908d87.fsf-monnier+emacs@HIDDEN> <e1299ef1-9313-9ad0-1909-2b63c46e4d92@HIDDEN> <jwvmsz74ye5.fsf-monnier+emacs@HIDDEN> From: Jim Porter <jporterbugs@HIDDEN> In-Reply-To: <jwvmsz74ye5.fsf-monnier+emacs@HIDDEN> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 65027 Cc: Eli Zaretskii <eliz@HIDDEN>, philipk@HIDDEN, 65027 <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -1.0 (-) On 8/3/2023 2:21 PM, Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors wrote: >> 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.
bug-gnu-emacs@HIDDEN:bug#65027; Package emacs.
Full text available.
Received: (at 65027) by debbugs.gnu.org; 3 Aug 2023 21:21:56 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Thu Aug 03 17:21:56 2023
Received: from localhost ([127.0.0.1]:53043 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1qRflc-0001Ud-A2
for submit <at> debbugs.gnu.org; Thu, 03 Aug 2023 17:21:56 -0400
Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:35656)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <monnier@HIDDEN>) id 1qRfla-0001UR-98
for 65027 <at> debbugs.gnu.org; Thu, 03 Aug 2023 17:21:54 -0400
Received: from pmg3.iro.umontreal.ca (localhost [127.0.0.1])
by pmg3.iro.umontreal.ca (Proxmox) with ESMTP id D515B44477A;
Thu, 3 Aug 2023 17:21:48 -0400 (EDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=iro.umontreal.ca;
s=mail; t=1691097707;
bh=OEuUzAPapBwsbYPPoVbRTIMfbjZN5aMfhsfFni85ToU=;
h=From:To:Cc:Subject:In-Reply-To:References:Date:From;
b=fFHjh/VJH/Dy3OVeJ248URxngiaeBIJnfd2XDOR1BmGtkDSauhK0mPN00A3vbp2M7
SnKxFj2scZJk3Fnq9YnEetziDzIAaFhGAeMqmwq9iWyefOv0faNy7eN5e9n5VlKLpw
9A3ksikAV2fmmcjyI9bzLWfO4CC0n7eX0O0suOsK4M6YZVcCUd2y7eGVIQU8jU3IQ8
uJU44OcaC5b7+SaeKvV2S+XeIth/XQQBGXYMW6PSKp7L7EgszsmQIpobdp5gKD6Tb4
CRW1cPZMzgc3r5YduIHfc6bew2eqzrNsexTUvMi5XeHc3pM+XNzXZcmhqFmNR4i4zB
o0fgfrn0UvvXw==
Received: from mail01.iro.umontreal.ca (unknown [172.31.2.1])
by pmg3.iro.umontreal.ca (Proxmox) with ESMTP id 5C47A444777;
Thu, 3 Aug 2023 17:21:47 -0400 (EDT)
Received: from alfajor (unknown [181.44.118.150])
by mail01.iro.umontreal.ca (Postfix) with ESMTPSA id 2A1141201B6;
Thu, 3 Aug 2023 17:21:46 -0400 (EDT)
From: Stefan Monnier <monnier@HIDDEN>
To: Jim Porter <jporterbugs@HIDDEN>
Subject: Re: bug#65027: 30.0.50; [PATCH] Document .elpaignore behavior in
the Emacs Lisp manual
In-Reply-To: <e1299ef1-9313-9ad0-1909-2b63c46e4d92@HIDDEN> (Jim Porter's
message of "Thu, 3 Aug 2023 10:24:58 -0700")
Message-ID: <jwvmsz74ye5.fsf-monnier+emacs@HIDDEN>
References: <761581a0-fa77-e89c-01e8-d0baeae838f5@HIDDEN>
<83cz04xzvk.fsf@HIDDEN> <jwvsf908d87.fsf-monnier+emacs@HIDDEN>
<e1299ef1-9313-9ad0-1909-2b63c46e4d92@HIDDEN>
Date: Thu, 03 Aug 2023 17:21:44 -0400
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain
X-SPAM-INFO: Spam detection results: 0
ALL_TRUSTED -1 Passed through trusted hosts only via SMTP
AWL 0.012 Adjusted score from AWL reputation of From: address
BAYES_00 -1.9 Bayes spam probability is 0 to 1%
DKIM_SIGNED 0.1 Message has a DKIM or DK signature,
not necessarily valid
DKIM_VALID -0.1 Message has at least one valid DKIM or DK signature
DKIM_VALID_AU -0.1 Message has a valid DKIM or DK signature from author's
domain
DKIM_VALID_EF -0.1 Message has a valid DKIM or DK signature from envelope-from
domain T_SCC_BODY_TEXT_LINE -0.01 -
X-SPAM-LEVEL:
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 65027
Cc: Eli Zaretskii <eliz@HIDDEN>, philipk@HIDDEN, 65027 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)
> 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`.
> What do you think?
Any help cleaning this up is welcome.
Stefan
bug-gnu-emacs@HIDDEN:bug#65027; Package emacs.
Full text available.Received: (at 65027) by debbugs.gnu.org; 3 Aug 2023 19:09:51 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Thu Aug 03 15:09:51 2023 Received: from localhost ([127.0.0.1]:52954 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1qRdhm-0006af-Q8 for submit <at> debbugs.gnu.org; Thu, 03 Aug 2023 15:09:51 -0400 Received: from mout02.posteo.de ([185.67.36.66]:52677) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <philipk@HIDDEN>) id 1qRdhl-0006aS-9L for 65027 <at> debbugs.gnu.org; Thu, 03 Aug 2023 15:09:49 -0400 Received: from submission (posteo.de [185.67.36.169]) by mout02.posteo.de (Postfix) with ESMTPS id B919F240104 for <65027 <at> debbugs.gnu.org>; Thu, 3 Aug 2023 21:09:43 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1691089783; bh=JDuujOziQsxxGnwVLuGcOraeEepAJhPI19i3arv6K98=; h=From:To:Cc:Subject:Autocrypt:Date:Message-ID:MIME-Version:From; b=fV2ul0e2pMVL0Evxg+Ru2tlUFNizOXQNzxtacI6+YDjN2uep7Tj+0WRt1iDo0XIfA fkGsVumWGArbsN4Fj2OqPhu4GJ5AVNnTe0f3L33U+NeE1daR5OKFLu1j3I60P5TcL7 1qYxvGigX5IqjneJAkL12i2jYTIm3F+jDEZdqEvMUPBuufwXoPvmhqKICDcIADCcYa Ln4XWccV36zZqeVYahK2GfpD/HjjLTl9p1QArZt59SOkGkfyOvhnpq05qfijSfKLBX uRsZvxxMnT1Kx+Z+aHIFde/aq/Kehp0Ac4eGAXt94wPx7AIuw40WHy7tk4IIJ26qzH OChf3sqycYdWA== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4RGz1L5qYjz6txy; Thu, 3 Aug 2023 21:09:42 +0200 (CEST) From: Philip Kaludercic <philipk@HIDDEN> To: Jim Porter <jporterbugs@HIDDEN> Subject: Re: bug#65027: 30.0.50; [PATCH] Document .elpaignore behavior in the Emacs Lisp manual In-Reply-To: <e1299ef1-9313-9ad0-1909-2b63c46e4d92@HIDDEN> (Jim Porter's message of "Thu, 3 Aug 2023 10:24:58 -0700") References: <761581a0-fa77-e89c-01e8-d0baeae838f5@HIDDEN> <83cz04xzvk.fsf@HIDDEN> <jwvsf908d87.fsf-monnier+emacs@HIDDEN> <e1299ef1-9313-9ad0-1909-2b63c46e4d92@HIDDEN> Autocrypt: addr=philipk@HIDDEN; keydata= mDMEZBBQQhYJKwYBBAHaRw8BAQdAHJuofBrfqFh12uQu0Yi7mrl525F28eTmwUDflFNmdui0QlBo aWxpcCBLYWx1ZGVyY2ljIChnZW5lcmF0ZWQgYnkgYXV0b2NyeXB0LmVsKSA8cGhpbGlwa0Bwb3N0 ZW8ubmV0PoiWBBMWCAA+FiEEDg7HY17ghYlni8XN8xYDWXahwukFAmQQUEICGwMFCQHhM4AFCwkI BwIGFQoJCAsCBBYCAwECHgECF4AACgkQ8xYDWXahwulikAEA77hloUiSrXgFkUVJhlKBpLCHUjA0 mWZ9j9w5d08+jVwBAK6c4iGP7j+/PhbkxaEKa4V3MzIl7zJkcNNjHCXmvFcEuDgEZBBQQhIKKwYB BAGXVQEFAQEHQI5NLiLRjZy3OfSt1dhCmFyn+fN/QKELUYQetiaoe+MMAwEIB4h+BBgWCAAmFiEE Dg7HY17ghYlni8XN8xYDWXahwukFAmQQUEICGwwFCQHhM4AACgkQ8xYDWXahwukm+wEA8cml4JpK NeAu65rg+auKrPOP6TP/4YWRCTIvuYDm0joBALw98AMz7/qMHvSCeU/hw9PL6u6R2EScxtpKnWof z4oM Date: Thu, 03 Aug 2023 19:09:41 +0000 Message-ID: <87r0okq6x6.fsf@HIDDEN> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -3.3 (---) X-Debbugs-Envelope-To: 65027 Cc: Eli Zaretskii <eliz@HIDDEN>, Stefan Monnier <monnier@HIDDEN>, 65027 <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -4.3 (----) Jim Porter <jporterbugs@HIDDEN> writes: > On 8/3/2023 6:36 AM, Stefan Monnier via Bug reports for GNU Emacs, the > Swiss army knife of text editors wrote: >>>> From the discussion in bug#64985, Eli mentioned that .elpaignore wasn't >>>> documented. (It turns out it's mentioned briefly in the GNU ELPA README, >>>> but that's the only place I could find.) >> That's because it was the only place where `.elpaignore` was >> used/obeyed >> (until the introduction of `package-vc`). > > Yeah, something more general that I've noticed is that as a package > author, the documentation for how to make a package for GNU ELPA is > split between the GNU ELPA README and the Emacs Lisp manual. I found > this a bit confusing when I prepared my first package for submission > to GNU ELPA, so (for example) I didn't learn about ".elpaignore" until > after I sent my package submission to emacs-devel. > > 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). What do you think? When I find some time, I plan to write and add a package to ELPA that could help automatise some of the necessary steps for contributing to ELPA (explaining the difference between GNU and NonGNU, signing the CA, testing for common mistakes, clean byte-compiling, etc.). It would be possible to also suggest creating a .elpaignore file as well. Of course, this does not mean there shouldn't be any guidelines written down in the manual.
bug-gnu-emacs@HIDDEN:bug#65027; Package emacs.
Full text available.Received: (at 65027) by debbugs.gnu.org; 3 Aug 2023 17:25:05 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Thu Aug 03 13:25:05 2023 Received: from localhost ([127.0.0.1]:52849 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1qRc4O-0003nJ-R2 for submit <at> debbugs.gnu.org; Thu, 03 Aug 2023 13:25:05 -0400 Received: from mail-pf1-x42e.google.com ([2607:f8b0:4864:20::42e]:61467) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <jporterbugs@HIDDEN>) id 1qRc4N-0003mh-9R for 65027 <at> debbugs.gnu.org; Thu, 03 Aug 2023 13:25:03 -0400 Received: by mail-pf1-x42e.google.com with SMTP id d2e1a72fcca58-68706b39c4cso845605b3a.2 for <65027 <at> debbugs.gnu.org>; Thu, 03 Aug 2023 10:25:03 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1691083497; x=1691688297; h=content-transfer-encoding:in-reply-to:from:references:cc:to :content-language:subject:mime-version:date:message-id:from:to:cc :subject:date:message-id:reply-to; bh=0hhXcD2xyy1elil0Rno6rYdPSZp8F0mjI4p33M8bKWI=; b=H1HKXZZ3y47sNZX/Gb4/pH8r7xy0FqqDZoOuxqT5F6NroknUzFnI6/kJPg6m1eaWj2 V1Qr7hsuv/m0oULfkSGxgmk/R+sFwcfiv/6qJDXa8rVnLrHY3UBuB/kU4HLEHfMrZ0vo AKtf5UQ+eErI5zkbIRLti8BagINPj/OBNM/cz4egZqliXn83Xq2Prd9Iics+2CajFIaj +08rfkl0oyfg0PgosPCZkCm6l9o2RGQ7fXjzS6S15IiFdUlaJpc30ZVGWFegwxxzFeCV v2RW8hQ/lJ+INvDJgsp4sLvrkohLSiP1lcOqUFAcOYUc391+6iTQZ2X1lCLfXm9MZpkn G46Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1691083497; x=1691688297; h=content-transfer-encoding:in-reply-to:from:references:cc:to :content-language:subject:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=0hhXcD2xyy1elil0Rno6rYdPSZp8F0mjI4p33M8bKWI=; b=Tkc41RcVfbg3UUvephAcI5n3OVblMPxUAfABoWSUV8DFbMuvggBDZAi571UR8o0SGR MgBwzGRJnvpVGC3YIjNY67Yx1Oc9hYnm1ftP8KGw4Zfx2M+LwKs0nnHt+T4CZFYpW5VZ cYwWpiw9YpEJ5uUZSVCS6otfNH2WRHFJl0kPTop1RP6LyRctgli2p5lnnAXd3VLd4S8f 5aP2kEhvIwZ+a3rNIYCivM5A8OsToCTTES6nAjdSgFoUwLay/+Cyne8jnjEI/oW0uKpq nmEBR4+8LR9we1WzAObGnl6sRSr5T9zRGlQ65J04kVUxXaxc+UiQRw+wJt0XhAbNqsGw 9Z+Q== X-Gm-Message-State: ABy/qLYuq0EbmkLdyU5RVVb1bDG5/KEwJtXrWxyKBp5qExhTvuMu8uqi V0kD5g5h11mUu2VtgJaRV2Q= X-Google-Smtp-Source: APBJJlHWNzQKLhTGf1zW9651ghVJXPz06F9ZINjvTNtJ0qIwrxDMhR/k55B22G8CzMA74B9Y9B/f5Q== X-Received: by 2002:a05:6a00:2352:b0:687:1a86:7a78 with SMTP id j18-20020a056a00235200b006871a867a78mr18260135pfj.9.1691083497447; Thu, 03 Aug 2023 10:24:57 -0700 (PDT) Received: from [192.168.1.2] (cpe-76-168-148-233.socal.res.rr.com. [76.168.148.233]) by smtp.googlemail.com with ESMTPSA id q24-20020a62e118000000b006826df9e286sm115288pfh.143.2023.08.03.10.24.56 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Thu, 03 Aug 2023 10:24:57 -0700 (PDT) Message-ID: <e1299ef1-9313-9ad0-1909-2b63c46e4d92@HIDDEN> Date: Thu, 3 Aug 2023 10:24:58 -0700 MIME-Version: 1.0 Subject: Re: bug#65027: 30.0.50; [PATCH] Document .elpaignore behavior in the Emacs Lisp manual Content-Language: en-US To: Stefan Monnier <monnier@HIDDEN>, Eli Zaretskii <eliz@HIDDEN> References: <761581a0-fa77-e89c-01e8-d0baeae838f5@HIDDEN> <83cz04xzvk.fsf@HIDDEN> <jwvsf908d87.fsf-monnier+emacs@HIDDEN> From: Jim Porter <jporterbugs@HIDDEN> In-Reply-To: <jwvsf908d87.fsf-monnier+emacs@HIDDEN> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 65027 Cc: philipk@HIDDEN, 65027 <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -1.0 (-) On 8/3/2023 6:36 AM, Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors wrote: >>> From the discussion in bug#64985, Eli mentioned that .elpaignore wasn't >>> documented. (It turns out it's mentioned briefly in the GNU ELPA README, >>> but that's the only place I could find.) > > That's because it was the only place where `.elpaignore` was used/obeyed > (until the introduction of `package-vc`). Yeah, something more general that I've noticed is that as a package author, the documentation for how to make a package for GNU ELPA is split between the GNU ELPA README and the Emacs Lisp manual. I found this a bit confusing when I prepared my first package for submission to GNU ELPA, so (for example) I didn't learn about ".elpaignore" until after I sent my package submission to emacs-devel. 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). What do you think?
bug-gnu-emacs@HIDDEN:bug#65027; Package emacs.
Full text available.
Received: (at 65027) by debbugs.gnu.org; 3 Aug 2023 13:36:26 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Thu Aug 03 09:36:26 2023
Received: from localhost ([127.0.0.1]:51083 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1qRYV8-0005Km-4M
for submit <at> debbugs.gnu.org; Thu, 03 Aug 2023 09:36:26 -0400
Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:42284)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <monnier@HIDDEN>) id 1qRYV6-0005Ka-Sy
for 65027 <at> debbugs.gnu.org; Thu, 03 Aug 2023 09:36:25 -0400
Received: from pmg2.iro.umontreal.ca (localhost.localdomain [127.0.0.1])
by pmg2.iro.umontreal.ca (Proxmox) with ESMTP id 8C25E80625;
Thu, 3 Aug 2023 09:36:19 -0400 (EDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=iro.umontreal.ca;
s=mail; t=1691069774;
bh=2BJzexdrl5I9cS+P5NygTLkHwMiVkDE0zXsz2OuqHY8=;
h=From:To:Cc:Subject:In-Reply-To:References:Date:From;
b=US5+GasbqbkxkWRIh7p2/6/dy1yvEFXWObcb0psGSdhee8CvJvkGgDhqupNTrKmxK
7aSM+lIfAy41i+aXi9OF1JUKcdRoSbyiPVM4ZV3R2Ul4txn/TT1i7orsSuUKQ8bqjI
s0q891C0g/KyzWFHrrK73cbEGOahCCFAY3wBpi5ZTQ7WD1EFOJJR7pvUSafbAjHOE3
qArWbE/ueBESdGEg++WVYuei4NJZ9on/yvXLFsgZBYSmEbXVdBeCpBk/9jbRdW/sHD
03evfTWCWLvJnNz9vxRAcohYxxd8nW9W7KCToqmfYKQnAAqOAzVlnNG6G+s4JTHmdB
E0nQRAcvjaExQ==
Received: from mail01.iro.umontreal.ca (unknown [172.31.2.1])
by pmg2.iro.umontreal.ca (Proxmox) with ESMTP id 1B3A080189;
Thu, 3 Aug 2023 09:36:14 -0400 (EDT)
Received: from alfajor (unknown [181.44.118.150])
by mail01.iro.umontreal.ca (Postfix) with ESMTPSA id D3E041201C1;
Thu, 3 Aug 2023 09:36:12 -0400 (EDT)
From: Stefan Monnier <monnier@HIDDEN>
To: Eli Zaretskii <eliz@HIDDEN>
Subject: Re: bug#65027: 30.0.50; [PATCH] Document .elpaignore behavior in
the Emacs Lisp manual
In-Reply-To: <83cz04xzvk.fsf@HIDDEN> (Eli Zaretskii's message of "Thu, 03 Aug
2023 12:02:23 +0300")
Message-ID: <jwvsf908d87.fsf-monnier+emacs@HIDDEN>
References: <761581a0-fa77-e89c-01e8-d0baeae838f5@HIDDEN>
<83cz04xzvk.fsf@HIDDEN>
Date: Thu, 03 Aug 2023 09:36:10 -0400
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain
X-SPAM-INFO: Spam detection results: 0
ALL_TRUSTED -1 Passed through trusted hosts only via SMTP
AWL 0.068 Adjusted score from AWL reputation of From: address
BAYES_00 -1.9 Bayes spam probability is 0 to 1%
DKIM_SIGNED 0.1 Message has a DKIM or DK signature,
not necessarily valid
DKIM_VALID -0.1 Message has at least one valid DKIM or DK signature
DKIM_VALID_AU -0.1 Message has a valid DKIM or DK signature from author's
domain
DKIM_VALID_EF -0.1 Message has a valid DKIM or DK signature from envelope-from
domain T_SCC_BODY_TEXT_LINE -0.01 -
X-SPAM-LEVEL:
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 65027
Cc: Jim Porter <jporterbugs@HIDDEN>, philipk@HIDDEN,
65027 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)
>> From the discussion in bug#64985, Eli mentioned that .elpaignore wasn't
>> documented. (It turns out it's mentioned briefly in the GNU ELPA README,
>> but that's the only place I could find.)
That's because it was the only place where `.elpaignore` was used/obeyed
(until the introduction of `package-vc`).
Stefan
bug-gnu-emacs@HIDDEN:bug#65027; Package emacs.
Full text available.Received: (at 65027) by debbugs.gnu.org; 3 Aug 2023 09:02:22 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Thu Aug 03 05:02:22 2023 Received: from localhost ([127.0.0.1]:50866 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1qRUDu-0003Vk-4Q for submit <at> debbugs.gnu.org; Thu, 03 Aug 2023 05:02:22 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:56146) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1qRUDs-0003VX-BH for 65027 <at> debbugs.gnu.org; Thu, 03 Aug 2023 05:02:20 -0400 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 <eliz@HIDDEN>) id 1qRUDm-0006sF-DK; Thu, 03 Aug 2023 05:02:14 -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=fII+90sMk7bh8GhqQqSP3OHgt09ab7d8ASJDmYMVDN4=; b=ClnAGczaOOGE gSKMuuoJ9mOAZtajiuDP3rNwLNkgAgadRSg5AbXBEhKfgaRoy3Cawqn9ePitowO0n6AH2qih0aVfo UQD7bC5byA1zHlyIqwy82c/QYG6dcXVETPiKiA1xrvR2WihXcAyO3EUatm7A+Dcf0AY4XI1IrY5Xf pKqTap/7QPI1ftdL60Rt4Vft6dqoV41lQy3TsniLtWED6nRasntQ74UXBvn5kF56obw7gWbTdtIo2 TXtjwIuffpsQXKwiW+HusSBHyLzo1bmJn5UpvIxKwilryGmNWWqpBzNYozvmJaIjO/H/2DwkyN7Kn liKxOnw/W4kff6WaoTXlhQ==; 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 <eliz@HIDDEN>) id 1qRUDl-00037i-T9; Thu, 03 Aug 2023 05:02:14 -0400 Date: Thu, 03 Aug 2023 12:02:23 +0300 Message-Id: <83cz04xzvk.fsf@HIDDEN> From: Eli Zaretskii <eliz@HIDDEN> To: Jim Porter <jporterbugs@HIDDEN>, Stefan Monnier <monnier@HIDDEN> In-Reply-To: <761581a0-fa77-e89c-01e8-d0baeae838f5@HIDDEN> (message from Jim Porter on Wed, 2 Aug 2023 21:56:38 -0700) Subject: Re: bug#65027: 30.0.50; [PATCH] Document .elpaignore behavior in the Emacs Lisp manual References: <761581a0-fa77-e89c-01e8-d0baeae838f5@HIDDEN> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 65027 Cc: philipk@HIDDEN, 65027 <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -3.3 (---) > Cc: philipk@HIDDEN > Date: Wed, 2 Aug 2023 21:56:38 -0700 > From: Jim Porter <jporterbugs@HIDDEN> > > From the discussion in bug#64985, Eli mentioned that .elpaignore wasn't > documented. (It turns out it's mentioned briefly in the GNU ELPA README, > but that's the only place I could find.) Here's a small patch to > document this in the Package section of the Emacs Lisp manual. > > This is just a first pass at documenting this feature, so I'm happy to > add further details if anyone thinks it's warranted. Thanks. Adding Stefan to the discussion.
bug-gnu-emacs@HIDDEN:bug#65027; Package emacs.
Full text available.Received: (at submit) by debbugs.gnu.org; 3 Aug 2023 04:56:50 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Thu Aug 03 00:56:50 2023 Received: from localhost ([127.0.0.1]:50365 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1qRQOH-0007WO-Oa for submit <at> debbugs.gnu.org; Thu, 03 Aug 2023 00:56:50 -0400 Received: from lists.gnu.org ([2001:470:142::17]:47484) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <jporterbugs@HIDDEN>) id 1qRQOG-0007WA-2G for submit <at> debbugs.gnu.org; Thu, 03 Aug 2023 00:56:48 -0400 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 <jporterbugs@HIDDEN>) id 1qRQOA-0002bY-Co for bug-gnu-emacs@HIDDEN; Thu, 03 Aug 2023 00:56:42 -0400 Received: from mail-oi1-x22d.google.com ([2607:f8b0:4864:20::22d]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from <jporterbugs@HIDDEN>) id 1qRQO8-0001Et-R0 for bug-gnu-emacs@HIDDEN; Thu, 03 Aug 2023 00:56:42 -0400 Received: by mail-oi1-x22d.google.com with SMTP id 5614622812f47-3a5ac84718dso429718b6e.0 for <bug-gnu-emacs@HIDDEN>; Wed, 02 Aug 2023 21:56:40 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1691038599; x=1691643399; h=subject:from:to:content-language:mime-version:date:message-id:from :to:cc:subject:date:message-id:reply-to; bh=CN1N33PCFLn+LBLzZOz7w9F7K97eCP9E5aME+IfO/Bo=; b=SefuNUMAv9XKUj7C2r3co1IO1gM+fsHVNoDglJ1Xgs/3J33N8qzSPYKWEXKNcumr1j 2V8ja4pRuEA+EUEEL7VALALCosLfrjnXIP6FHZiz1Y4gseCK18j2jhYYvKlGycU6v0uU ZR3T9tR5zVENVBXbJkJO2ETkIcL8Lr0opnQ95KaAXRR0ld8okwF1V2u8ILOj/3d/jn6u oC8kXBnYLMUSHRrYP7c/TahVpdFyvPlxRrw8aWNBdxiN+Fy3Q2VLTzL35Sz6d0Po1889 Bb23Bbgwo2fsSoWLRn+q64TnxysSVMH2z5JRJpiZxPM5kfhzxa2IRmb24FHJmP6qCjp3 MQsw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1691038599; x=1691643399; h=subject:from:to:content-language:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=CN1N33PCFLn+LBLzZOz7w9F7K97eCP9E5aME+IfO/Bo=; b=OUvaVFk7h6OlvysHrsEQEyneU0jFKeS+MnZYGBiX8ySrV9HWlyeiHvYh2H4pHrmhpR G0Ye0TOgLQd85eLZsMZA/FpE3kv8nVv6tCNYT5Tm27kBmsKwxlw+jsd2je0qUfyYnSD8 697OTF3AfTqHyepi9fO3vCqCNOkuTDPIfg0fgKuJu2d6WzwH9+t3T5mhvwPAYyaSaGGw RhQc9zqVFd9jFz1SRj1otBaqJgDnx2tAqTo79uTdbzFyUx9QZZisDn+AsJAT01RHqy7I N3Tco5x7WWlrx4GtqWLw/DWcW2M4Hsdnv/BB3Q53r6om0FCZb3sGaQg0X2/mPadsqQp0 IfBw== X-Gm-Message-State: ABy/qLZfEYS19Usm1u5pnrgrggjcLOBAAeufKABuAV0gfK1rX7dbAU5E +xNDYfI4g+Aj14xamMhyaUaDprjp+Zs= X-Google-Smtp-Source: APBJJlEwHN7v6XmeVwmne16fnZ/qtFbWkGB9fm225B/v64Urp2MtQbtDK1M326EeBuoLXmnKCK5nQQ== X-Received: by 2002:a05:6808:4044:b0:3a4:3170:cc0e with SMTP id cz4-20020a056808404400b003a43170cc0emr15996465oib.38.1691038599408; Wed, 02 Aug 2023 21:56:39 -0700 (PDT) Received: from [192.168.1.2] (cpe-76-168-148-233.socal.res.rr.com. [76.168.148.233]) by smtp.googlemail.com with ESMTPSA id s1-20020a62e701000000b00687087d8bc3sm10720387pfh.141.2023.08.02.21.56.38 for <bug-gnu-emacs@HIDDEN> (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Wed, 02 Aug 2023 21:56:38 -0700 (PDT) Content-Type: multipart/mixed; boundary="------------07jTt0QLnxQ7UME5phg7gQvP" Message-ID: <761581a0-fa77-e89c-01e8-d0baeae838f5@HIDDEN> Date: Wed, 2 Aug 2023 21:56:38 -0700 MIME-Version: 1.0 X-Mozilla-News-Host: news://news.gmane.io:119 Content-Language: en-US To: bug-gnu-emacs@HIDDEN From: Jim Porter <jporterbugs@HIDDEN> Subject: 30.0.50; [PATCH] Document .elpaignore behavior in the Emacs Lisp manual Received-SPF: pass client-ip=2607:f8b0:4864:20::22d; envelope-from=jporterbugs@HIDDEN; helo=mail-oi1-x22d.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 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, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: 1.0 (+) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -0.0 (/) This is a multi-part message in MIME format. --------------07jTt0QLnxQ7UME5phg7gQvP Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Debbugs-Cc: philipk@HIDDEN From the discussion in bug#64985, Eli mentioned that .elpaignore wasn't documented. (It turns out it's mentioned briefly in the GNU ELPA README, but that's the only place I could find.) Here's a small patch to document this in the Package section of the Emacs Lisp manual. This is just a first pass at documenting this feature, so I'm happy to add further details if anyone thinks it's warranted. --------------07jTt0QLnxQ7UME5phg7gQvP Content-Type: text/plain; charset=UTF-8; name="0001-doc-lispref-package.texi-Multi-file-Packages-Documen.patch" Content-Disposition: attachment; filename*0="0001-doc-lispref-package.texi-Multi-file-Packages-Documen.pa"; filename*1="tch" Content-Transfer-Encoding: base64 RnJvbSBhNWRjNWY2MzAwM2FlYTRiZGE0ZjM4MmVjNDZjMDU1NmVkYjE0ZjFhIE1vbiBTZXAg MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBKaW0gUG9ydGVyIDxqcG9ydGVyYnVnc0BnbWFpbC5j b20+CkRhdGU6IFdlZCwgMiBBdWcgMjAyMyAyMTo1MToxOCAtMDcwMApTdWJqZWN0OiBbUEFU Q0hdICogZG9jL2xpc3ByZWYvcGFja2FnZS50ZXhpIChNdWx0aS1maWxlIFBhY2thZ2VzKTog RG9jdW1lbnQKICIuZWxwYWlnbm9yZSIuCgotLS0KIGRvYy9saXNwcmVmL3BhY2thZ2UudGV4 aSB8IDcgKysrKysrKwogMSBmaWxlIGNoYW5nZWQsIDcgaW5zZXJ0aW9ucygrKQoKZGlmZiAt LWdpdCBhL2RvYy9saXNwcmVmL3BhY2thZ2UudGV4aSBiL2RvYy9saXNwcmVmL3BhY2thZ2Uu dGV4aQppbmRleCAyOTUyZTdkZmNmYy4uY2UyOWI0YmU3MmEgMTAwNjQ0Ci0tLSBhL2RvYy9s aXNwcmVmL3BhY2thZ2UudGV4aQorKysgYi9kb2MvbGlzcHJlZi9wYWNrYWdlLnRleGkKQEAg LTI4NCw2ICsyODQsMTMgQEAgTXVsdGktZmlsZSBQYWNrYWdlcwogICAoZXhwYW5kLWZpbGUt bmFtZSBmaWxlIHN1cGVyZnJvYm5pY2F0b3ItYmFzZSkpCiBAZW5kIHNtYWxsZXhhbXBsZQog CisgIElmIHlvdXIgcHJvamVjdCBjb250YWlucyBmaWxlcyB0aGF0IHlvdSBkb24ndCB3aXNo IHRvIGRpc3RyaWJ1dGUgdG8KK3VzZXJzIChlLmcuQDogcmVncmVzc2lvbiB0ZXN0cyksIHlv dSBjYW4gYWRkIHRoZW0gdG8gYW4KK0BmaWxley5lbHBhaWdub3JlfSBmaWxlLiAgSW4gdGhp cyBmaWxlLCBlYWNoIGxpbmUgbGlzdHMgYSBmaWxlIG9yCit3aWxkY2FyZCBtYXRjaGluZyBm aWxlcyB0byBpZ25vcmUgd2hlbiBwcm9kdWNpbmcgeW91ciBwYWNrYWdlJ3MgdGFyCitmaWxl IG9uIEVMUEEuICAoRUxQQSB3aWxsIHBhc3MgdGhpcyBmaWxlIHRvIEBjb21tYW5ke3Rhcn0g d2l0aCB0aGUKK0Bjb2Rley1YfSBvcHRpb24uKQorCiBAbm9kZSBQYWNrYWdlIEFyY2hpdmVz CiBAc2VjdGlvbiBDcmVhdGluZyBhbmQgTWFpbnRhaW5pbmcgUGFja2FnZSBBcmNoaXZlcwog QGNpbmRleCBwYWNrYWdlIGFyY2hpdmUKLS0gCjIuMjUuMQoK --------------07jTt0QLnxQ7UME5phg7gQvP--
Jim Porter <jporterbugs@HIDDEN>:philipk@HIDDEN, bug-gnu-emacs@HIDDEN.
Full text available.philipk@HIDDEN, bug-gnu-emacs@HIDDEN:bug#65027; Package emacs.
Full text available.
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997 nCipher Corporation Ltd,
1994-97 Ian Jackson.