From unknown Wed Jun 18 23:04:19 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#77311 <77311@debbugs.gnu.org> To: bug#77311 <77311@debbugs.gnu.org> Subject: Status: Minor documentation fix (`use-package') Reply-To: bug#77311 <77311@debbugs.gnu.org> Date: Thu, 19 Jun 2025 06:04:19 +0000 retitle 77311 Minor documentation fix (`use-package') reassign 77311 emacs submitter 77311 Dominik Schrempf severity 77311 normal tag 77311 patch thanks From debbugs-submit-bounces@debbugs.gnu.org Thu Mar 27 11:01:52 2025 Received: (at submit) by debbugs.gnu.org; 27 Mar 2025 15:01:53 +0000 Received: from localhost ([127.0.0.1]:50806 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1txojw-0005L6-7F for submit@debbugs.gnu.org; Thu, 27 Mar 2025 11:01:52 -0400 Received: from lists.gnu.org ([2001:470:142::17]:32982) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1txojt-0005Jb-Bo for submit@debbugs.gnu.org; Thu, 27 Mar 2025 11:01:50 -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 ) id 1txojj-0001Hn-PL for bug-gnu-emacs@gnu.org; Thu, 27 Mar 2025 11:01:42 -0400 Received: from mail-ej1-x635.google.com ([2a00:1450:4864:20::635]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1txojh-0001Lg-W2 for bug-gnu-emacs@gnu.org; Thu, 27 Mar 2025 11:01:39 -0400 Received: by mail-ej1-x635.google.com with SMTP id a640c23a62f3a-aaee2c5ee6eso167270966b.1 for ; Thu, 27 Mar 2025 08:01:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1743087696; x=1743692496; darn=gnu.org; h=mime-version:message-id:date:user-agent:subject:to:from:from:to:cc :subject:date:message-id:reply-to; bh=waiAJiL0NvCVLgmzP1xaGc9hP6sX9dYGs7w4XLszdDo=; b=doh/5nauxABveCL1bX6nnkdkeg2BA1nwiCdD+3S7WeH0kIOSxsv6sn1EiXoL5rZ1hx Nl9UN1iAkjKxW6jxCPzq3SKySQ3AUV8EDNNiRydJnneExyyrhTr6MESVJBulR4+c1Zk0 UNhRUYe4l+YqmLCZSlcxN/8KhQu5jYTIrGf2ztV0J4nWo2g5Tt/nm6W88VlFcyROK0TV oYMClpkliks7Ynuo5VIbECi4lPa7mGVUGXsFftNm3cFVLlQLQYoB+sG3Cqs44uRgFBUq hPZsLqftIJh1iYv3hZEV7dkVix4nFsZPxl/gZp9vflptX97Twv6QQ4euFeBg9GPWcKT+ kNzw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1743087696; x=1743692496; h=mime-version:message-id:date:user-agent:subject:to:from :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=waiAJiL0NvCVLgmzP1xaGc9hP6sX9dYGs7w4XLszdDo=; b=dOZPJVmQRL9EhIxFirODX2oPWt/BcuRa00CgpUpX4vl60T8qwqAsHEsSOFJApkPjQm ovIF+uU1rNT4Jqx7TeQ4SEqqgJW603vHHBaV2K+5umxqqAYT1DbgfOvCrxDfFTByBBLh SrwQVq43AfmBgv5FiANYlelBOuQ+9NEngoPGHK6udBX3uJKIuO5B4TaZgxp3iqvYVMlB WVLQ7y3RV4Ww6gMzsPWcr3lkvL6lMJJDg0KnSnMm4ZI73BQR2SwFH2bsjxEWfTZBMeJv +bKi1n8YbgQa7b57o29RJEgn4W20p1iQjH/iDhx7YjH6LQ6F/UOdxCTHrVvIiXiePWBu ZiYw== X-Gm-Message-State: AOJu0YyUi5lHRQ82BarE3NUFMwnatozjdD9dvC1Px5UyjQKFOTgZ6fgz TQbKvyxUpwRwPiXPSP1jsRmK1b3EZMpNWYbXX5N2nzPrAWpI7IU708NiN0TF7Q== X-Gm-Gg: ASbGnct6xzySl+VNZCsdgNfq7Bwa7O2959wn5G1zhaxt8hfReypT0HW3O6Maisrp6h+ 08bPras/kqNNBWAXa8spDbRhVHZBiZEiL7P9ySqFDDASvZYz3IeO8RYeMuauL023t3xTx+Dj60t 3TWyPRLk/r/SQ1DS9RWfSFiSMVQkp5NYXFYtre1An+XvTiaMbQzMHoZqNvL928dvBW7cS9qIclT fTHez3FwfN+iX2OkszJzlWzpnduTN7A1epxXETl1Ez09TfB3JpYE/BCjK3Gi8efZaUVvqHpHbzW 8TuYXEYWGNXiggi190TXrZ+Y8mlvUspZ/dkRFl5pmoBBReimh7a2eb/qM/ip3p4= X-Google-Smtp-Source: AGHT+IGTMhTyRrYc5kfUrKXvyInSRWaoed8rOi0G+PPO2dwRlXYHUDFYDPNtxY9HYTTBBcGZ15b1Rg== X-Received: by 2002:a17:906:5948:b0:ac7:1605:e3b2 with SMTP id a640c23a62f3a-ac71605e4b0mr55046266b.19.1743087695852; Thu, 27 Mar 2025 08:01:35 -0700 (PDT) Received: from localhost ([2a02:1748:dd5e:5d70:69c7:764d:8589:548]) by smtp.gmail.com with ESMTPSA id a640c23a62f3a-ac71927b0b0sm5612066b.50.2025.03.27.08.01.35 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 27 Mar 2025 08:01:35 -0700 (PDT) From: Dominik Schrempf To: "Emacs Bug Tracker" Subject: Minor documentation fix (`use-package') User-Agent: mu4e 1.12.9; emacs 30.1 Date: Thu, 27 Mar 2025 16:01:33 +0100 Message-ID: <874izeikky.fsf@gmail.com> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Received-SPF: pass client-ip=2a00:1450:4864:20::635; envelope-from=dominik.schrempf@gmail.com; helo=mail-ej1-x635.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 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: 1.0 (+) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.0 (/) --=-=-= Content-Type: text/plain Hello, I attach a suggested minor patch of the documentation of `use-package'. --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0001-Fix-minor-issues-in-documentation-of-use-package.patch >From e54dbd45e0e4f41768dec5cd0ae88b59ef7f65f2 Mon Sep 17 00:00:00 2001 From: Dominik Schrempf Date: Thu, 27 Mar 2025 15:54:52 +0100 Subject: [PATCH] Fix minor issues in documentation of `use-package' --- lisp/use-package/use-package-core.el | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/lisp/use-package/use-package-core.el b/lisp/use-package/use-package-core.el index 84ff637435a..5bf3505a25e 100644 --- a/lisp/use-package/use-package-core.el +++ b/lisp/use-package/use-package-core.el @@ -1849,11 +1849,11 @@ Usage: :magic-fallback Form to be added to `magic-fallback-mode-alist'. :interpreter Form to be added to `interpreter-mode-alist'. -:commands Define autoloads for commands that will be defined by the +:commands Define autoloads for interactive commands defined by the package. This is useful if the package is being lazily - loaded, and you wish to conditionally call functions in your - `:init' block that are defined in the package. -:autoload Similar to :commands, but it for no-interactive one. + loaded, and you wish to conditionally call functions in + your `:init' block that are defined in the package. +:autoload Similar to `:commands', but used for non-interactive commands. :hook Specify hook(s) to attach this package to. :bind Bind keys, and define autoloads for the bound commands. -- 2.48.1 --=-=-=-- From debbugs-submit-bounces@debbugs.gnu.org Thu Mar 27 20:11:12 2025 Received: (at control) by debbugs.gnu.org; 28 Mar 2025 00:11:12 +0000 Received: from localhost ([127.0.0.1]:51897 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1txxJX-0000Rj-TY for submit@debbugs.gnu.org; Thu, 27 Mar 2025 20:11:12 -0400 Received: from mail-ed1-x535.google.com ([2a00:1450:4864:20::535]:59687) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.84_2) (envelope-from ) id 1txxJQ-0000R0-7m for control@debbugs.gnu.org; Thu, 27 Mar 2025 20:11:09 -0400 Received: by mail-ed1-x535.google.com with SMTP id 4fb4d7f45d1cf-5e5c7d6b96fso2987884a12.3 for ; Thu, 27 Mar 2025 17:11:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1743120658; x=1743725458; darn=debbugs.gnu.org; h=to:subject:message-id:date:mime-version:from:from:to:cc:subject :date:message-id:reply-to; bh=zNzif+p/CrCfHD3hFHIzLrDMq8Y8I+shvtEW+KUGmog=; b=nFZyeLtBDJC49fqF3iW6gO7ZlhvWlXafGIMQ+EjuCNPBT0KbIAv8HIRImOccOENGrD WLo0uX9DY493e2qHVzFBgEVospnfoxQNp37RaXdLE+1BtJ17UdyS61uVTwA4zbt5YUXn BmamhDCpB5XA6xe56nfI7mF5xFqT+pwPk3Fv4oclROby73maTo0GeOGJN+6X7Tl9Fhwp 774TebsM6R5iu3Qb6DmnwVL6zyLoUiQ1r85YZujYZ/UjquP2NC+e4reoZ3kwearUeY/x mxasUxwWfZNFpYdXvq9ByREQuccbv/NgN27z3r2usiqDfmSmswPEchRN58u5y1X8thVh sh3A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1743120658; x=1743725458; h=to:subject:message-id:date:mime-version:from:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=zNzif+p/CrCfHD3hFHIzLrDMq8Y8I+shvtEW+KUGmog=; b=rlZdJ5CKcwNwPrbOWrkmWN5jOjja1Baps+1ySviOYOrnnLufABIgULJwrXOgyclNU/ I2c8erucPS2HM5XzGuDGuP108D+HyNDHbH08ioK0L0/3adk652ASph1uctFZve778SnS vnrX9sI+2T0CNllb7KPwEll+EiKjKX6l2ZIrk2swTk+uwa+0rNYJ3Ac/KtTC9h9Au2DN 20jFWdkq/wKfvT++WR5QReleU1a4OZ6Q4TVvDNRv4TBbM4qoZ7iKEJmf0SSGEeoYTQCz 0ZjuwYktmufW1sg8LMpLJ+hfPGPiohXcNc/TH1YHL7CkC89QvduxA9oocJCnPUg/bR3k CuVg== X-Gm-Message-State: AOJu0YzflhgapZcbLzJ1itN6oqdiHOaqo9fWOU5n41UYJcUd2QXkX2PH AzG7zqPpAv+g8/2aYaov86yL1v3DuKqMU9N3d2k2wbu37GYJY9dONxcHWjuw/9Ukiamp9LaUo1X y7yAFB5Sem8prF8pykk7cnQHU/mSFh+cq X-Gm-Gg: ASbGncvd2xZanH9FORa5ngLEiyAupLQ30Xk6GxsuYru0MucrT7Kq9EpPl81pdgo/kSX LZr2BuaKMZOtR9bjY6HIGF0WfvlPN7vQgrppsIc+vFiAOQ3yIwFRtK1vJ/fphK6sVXEIJlT6W6I sxveiAeeuyKJ01g73RlUxCyjlfLmzyf8Se3SjY X-Google-Smtp-Source: AGHT+IFATeBDjVJiKknuS36iOG2FOYhxqEjUuKtYdhogi550Yue0Sp/wl/mdGPg8ZoG5ZNPjJ/c5oZ8qRfnR6AXaido= X-Received: by 2002:a05:6402:42c2:b0:5ec:c982:7efe with SMTP id 4fb4d7f45d1cf-5ed8e59ddbamr5708931a12.14.1743120657455; Thu, 27 Mar 2025 17:10:57 -0700 (PDT) Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Fri, 28 Mar 2025 00:10:57 +0000 From: Stefan Kangas MIME-Version: 1.0 Date: Fri, 28 Mar 2025 00:10:57 +0000 X-Gm-Features: AQ5f1Jpptzriu8Is9e_CFgc8Vl2vCij63Z3N5BLgGtHiexkQxyOockj34GPJEmk Message-ID: Subject: control message for bug #77311 To: control@debbugs.gnu.org Content-Type: text/plain; charset="UTF-8" X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) tags 77311 + patch quit From debbugs-submit-bounces@debbugs.gnu.org Sat Mar 29 06:04:54 2025 Received: (at 77311) by debbugs.gnu.org; 29 Mar 2025 10:04:54 +0000 Received: from localhost ([127.0.0.1]:56983 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1tyT3d-0006fi-TH for submit@debbugs.gnu.org; Sat, 29 Mar 2025 06:04:54 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:39384) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1tyT3c-0006fU-1P for 77311@debbugs.gnu.org; Sat, 29 Mar 2025 06:04: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 ) id 1tyT3W-0002eA-IU; Sat, 29 Mar 2025 06:04:46 -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=24JPqpk85LN2VlpLodeievhF0z3cv8vaSoj705x4Cec=; b=OTGZ6ZC9BvzK f5bghZnGCo9LwjKusuw8ee86TrV35XFP3psRY1Fr1LlX3KPzJxw5P/L4L3jDtduVA6mNZ4yZVl7hv LUQlhIcHHABbDwh+3upiBEVVNc0eipZ6moj/djzaq+igfQIyQLy0IJsW2lKVHT2ok8eHgQXG1Z/Gc GsZt9Rwv22dimfQWlb5qaZonA46wFFtPwWR1OaYbtaKig5XixeqK633eqLVHt8rB1WIIeBbsIEUwP 9NMWLLg6UsL3RiqsUAs5f5tRDnxTMN8+E9g7Pj1oym2ka6ZPov3NwO3DqWChG6qtKis1c5cJrVB8T WRRSlWODWs2OgW1EXg43Ew==; Date: Sat, 29 Mar 2025 13:04:43 +0300 Message-Id: <86pli0885g.fsf@gnu.org> From: Eli Zaretskii To: Dominik Schrempf In-Reply-To: <874izeikky.fsf@gmail.com> (message from Dominik Schrempf on Thu, 27 Mar 2025 16:01:33 +0100) Subject: Re: bug#77311: Minor documentation fix (`use-package') References: <874izeikky.fsf@gmail.com> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 77311 Cc: 77311@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Dominik Schrempf > Date: Thu, 27 Mar 2025 16:01:33 +0100 > > I attach a suggested minor patch of the documentation of `use-package'. Thanks, see some comments below. > --- a/lisp/use-package/use-package-core.el > +++ b/lisp/use-package/use-package-core.el > @@ -1849,11 +1849,11 @@ Usage: > :magic-fallback Form to be added to `magic-fallback-mode-alist'. > :interpreter Form to be added to `interpreter-mode-alist'. > > -:commands Define autoloads for commands that will be defined by the > +:commands Define autoloads for interactive commands defined by the > package. This is useful if the package is being lazily > - loaded, and you wish to conditionally call functions in your > - `:init' block that are defined in the package. > -:autoload Similar to :commands, but it for no-interactive one. > + loaded, and you wish to conditionally call functions in > + your `:init' block that are defined in the package. > +:autoload Similar to `:commands', but used for non-interactive commands. > :hook Specify hook(s) to attach this package to. > > :bind Bind keys, and define autoloads for the bound commands. A command is always interactive. So saying "interactive commands" is a kind-of tautology, and "non-interactive commands" is something that doesn't exist in Emacs. My suggestion is to leave the description of :commands unchanged, and modify :autoload to say that its for non-interactive functions. From debbugs-submit-bounces@debbugs.gnu.org Sat Mar 29 09:54:51 2025 Received: (at 77311) by debbugs.gnu.org; 29 Mar 2025 13:54:51 +0000 Received: from localhost ([127.0.0.1]:57569 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1tyWeB-0002Ca-4o for submit@debbugs.gnu.org; Sat, 29 Mar 2025 09:54:51 -0400 Received: from mail-wr1-x434.google.com ([2a00:1450:4864:20::434]:61878) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.84_2) (envelope-from ) id 1tyWe8-0002CJ-5i for 77311@debbugs.gnu.org; Sat, 29 Mar 2025 09:54:48 -0400 Received: by mail-wr1-x434.google.com with SMTP id ffacd0b85a97d-3913d45a148so2651935f8f.3 for <77311@debbugs.gnu.org>; Sat, 29 Mar 2025 06:54:48 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1743256481; x=1743861281; darn=debbugs.gnu.org; h=mime-version:message-id:date:user-agent:references:in-reply-to :subject:cc:to:from:from:to:cc:subject:date:message-id:reply-to; bh=CyTAO0eGTBkJiNcYmSTnrtA+UXb076yhZTm4rrY+ciU=; b=fw9yWpzdQbCDiN0rNmcV3Jms0FS8evTZLSWU1aVRJd6UZ6CVYGeGKkfkJgmYWMovQm LDEV7qrbNIqOV16agnlbug9teXZpZH7TYocEVXw6oKTlNAdwHwSUhuylDel1MhxOA/C7 fjx8gMjqlcKDWjCm/9BIBzL/1ylr8yiM4KpyQWGL/eOwQElnVV83Pj/9PS9lPvGIZlEp MlmrxF+e0/wuv9CwLOMOlvnKGStO1U/4m5wOEublM9fJ2z9C/+JFHlaCybrhvTVbePd5 tPPc57fBP2kqsx/BkDpfa7jHHzTXbtfSBteaEy5sl8/oZLTQiA0+ZxapQVSaiUPXDMTQ GfhA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1743256481; x=1743861281; h=mime-version:message-id:date:user-agent:references:in-reply-to :subject:cc:to:from:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=CyTAO0eGTBkJiNcYmSTnrtA+UXb076yhZTm4rrY+ciU=; b=PtH3QGY2UQCQr5q69PlEfUvBzUtB8F4uI/lthp3rgo2dZ/shglTzSI9Zv5APaMEUkK sulOrPN4EEKyisxQ4/zZjHLDdGIORadElYerATWX4XmyU+l6HHHxNvehqycHl/VeDg5d v+vXIlczRjA0/3Ns7xexhy/JZE8CGtLCe753XnQKBgLGi8zo5MDdWuGMJtRH1stLyYpL vygbw8egjyRM/g2wKzLu5AzAY3obo6TZnCPly0bhgaW/A2304oAutdj/T0ROqVYg173w BVgHmhVmJWvzUIlTn4OZyLUp6ZmINLwfSBOWUlBonlcqpU7hbsc+UJj3bm8/4YIkqu5L ARjg== X-Gm-Message-State: AOJu0YxVky4aBcBdMvjFn7lCTSavcLlOde6CpdWX2n9RlN88KMZSOS9i ynX19B6jhO5po2QM+J/6k/9C+VQF8Na8I5S2s/ThrNWXQL+ux1A= X-Gm-Gg: ASbGncv+Y6ksBzxW2+NwI4QR/fyPWziU/RZZByHA5BtGHJQEpX5Sp4chWJ6Z5gZ1gEO CR8Zagh2D51raGYPDko+PX2EF6g1X2QdtZV5Wo+aKDoLdEUHNitSMGWty2k4YrUJkGYG+UgEUuv g4ApSDUM+yr3cY+vBsYlMiiVmPhLZTKkRlrUWeWCklScQCrdOvrLCn7lAhJFng88BWduiY55ke2 PwuGS0X1R+D+toeyWkH8QjQTDqJQxHLxVwetU+gmvyzwfiwVKlKBAa1HK+PT1l4J5yYRAai0Zbd 53LTq8rxVfKaI60QoW1S5lEdajjQNITdg8667wKI9cbxVbcLDAHFLA9p7dpJK9Q= X-Google-Smtp-Source: AGHT+IGwav32T4NblBUv5bFLZek0N56zklNrVO6yA5Qu4ylVRCvMxiDrAwEzIwD5E/hYcYVP9UJBwA== X-Received: by 2002:a5d:5983:0:b0:390:ebae:6c18 with SMTP id ffacd0b85a97d-39c120db794mr2007321f8f.12.1743256481235; Sat, 29 Mar 2025 06:54:41 -0700 (PDT) Received: from localhost ([2a02:1748:dd5e:5d70:ee5:2065:fd77:d603]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-39c0b79e467sm5832067f8f.79.2025.03.29.06.54.40 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 29 Mar 2025 06:54:40 -0700 (PDT) From: Dominik Schrempf To: Eli Zaretskii Subject: Re: bug#77311: Minor documentation fix (`use-package') In-Reply-To: <86pli0885g.fsf@gnu.org> (Eli Zaretskii's message of "Sat, 29 Mar 2025 13:04:43 +0300") References: <874izeikky.fsf@gmail.com> <86pli0885g.fsf@gnu.org> User-Agent: mu4e 1.12.9; emacs 30.1 Date: Sat, 29 Mar 2025 14:54:39 +0100 Message-ID: <87v7rshrhc.fsf@gmail.com> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 77311 Cc: 77311@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) --=-=-= Content-Type: text/plain Hi, thanks for your comments. Please find attached the updated patch. I still changed the tense used in the documentation of `:commands'. Best, Dominik --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0001-Fix-minor-issues-in-documentation-of-use-package.patch >From c0d881d651c6998650d2c895b3e5f39a2c3c8078 Mon Sep 17 00:00:00 2001 From: Dominik Schrempf Date: Thu, 27 Mar 2025 15:54:52 +0100 Subject: [PATCH] Fix minor issues in documentation of `use-package' --- lisp/use-package/use-package-core.el | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/lisp/use-package/use-package-core.el b/lisp/use-package/use-package-core.el index 84ff637435a..630ee83601c 100644 --- a/lisp/use-package/use-package-core.el +++ b/lisp/use-package/use-package-core.el @@ -1849,11 +1849,11 @@ Usage: :magic-fallback Form to be added to `magic-fallback-mode-alist'. :interpreter Form to be added to `interpreter-mode-alist'. -:commands Define autoloads for commands that will be defined by the - package. This is useful if the package is being lazily - loaded, and you wish to conditionally call functions in your +:commands Define autoloads for commands defined by the package. + This is useful if the package is being lazily loaded, + and you wish to conditionally call functions in your `:init' block that are defined in the package. -:autoload Similar to :commands, but it for no-interactive one. +:autoload Similar to `:commands', but used for non-interactive functions. :hook Specify hook(s) to attach this package to. :bind Bind keys, and define autoloads for the bound commands. -- 2.48.1 --=-=-= Content-Type: text/plain Eli Zaretskii writes: >> From: Dominik Schrempf >> Date: Thu, 27 Mar 2025 16:01:33 +0100 >> >> I attach a suggested minor patch of the documentation of `use-package'. > > Thanks, see some comments below. > >> --- a/lisp/use-package/use-package-core.el >> +++ b/lisp/use-package/use-package-core.el >> @@ -1849,11 +1849,11 @@ Usage: >> :magic-fallback Form to be added to `magic-fallback-mode-alist'. >> :interpreter Form to be added to `interpreter-mode-alist'. >> >> -:commands Define autoloads for commands that will be defined by the >> +:commands Define autoloads for interactive commands defined by the >> package. This is useful if the package is being lazily >> - loaded, and you wish to conditionally call functions in your >> - `:init' block that are defined in the package. >> -:autoload Similar to :commands, but it for no-interactive one. >> + loaded, and you wish to conditionally call functions in >> + your `:init' block that are defined in the package. >> +:autoload Similar to `:commands', but used for non-interactive commands. >> :hook Specify hook(s) to attach this package to. >> >> :bind Bind keys, and define autoloads for the bound commands. > > A command is always interactive. So saying "interactive commands" is > a kind-of tautology, and "non-interactive commands" is something that > doesn't exist in Emacs. > > My suggestion is to leave the description of :commands unchanged, and > modify :autoload to say that its for non-interactive functions. --=-=-=-- From debbugs-submit-bounces@debbugs.gnu.org Sat Mar 29 10:18:03 2025 Received: (at 77311-done) by debbugs.gnu.org; 29 Mar 2025 14:18:03 +0000 Received: from localhost ([127.0.0.1]:60649 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1tyX0c-00047a-SF for submit@debbugs.gnu.org; Sat, 29 Mar 2025 10:18:03 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:50144) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1tyX0a-000473-6b for 77311-done@debbugs.gnu.org; Sat, 29 Mar 2025 10:18:00 -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 ) id 1tyX0U-0000qc-Bn; Sat, 29 Mar 2025 10:17:54 -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=G0ZiccQJr1EH1HAZwLWRm3mHdYBXwlDBqtEPeqMFlQU=; b=NEHMKi0YNfU+ y72Lg1dinDXe6eOUBlFge1n559YtGyeASeUWIpVmxmsaL323gqbjIR/k2CHklQKkzxNN16R+Jpm1V XMEQyErlcFAuP+P3iZqh1KhRVrn4tRkMfG9qqQMU95x4pKgMTjDKBZBQNVBPh23i3pKZKj0fUUMZU NpMVzMJOIlqtEdSM/+RytrJrMDCybtuxvoxZV3wye7/1PFQS4sptysPkNS+75ZjNOz6E9CB/t8oAM iEQos8Lt0Zer4Nte3+JoaKiJuqAFrNn8EjSxdnmLEhjyGCvP/nwnA2V/UGUB3vfTMb57Q8Wb5z8el djHCAbpF5BI9d2aEVY5NHg==; Date: Sat, 29 Mar 2025 17:17:43 +0300 Message-Id: <867c477wfs.fsf@gnu.org> From: Eli Zaretskii To: Dominik Schrempf In-Reply-To: <87v7rshrhc.fsf@gmail.com> (message from Dominik Schrempf on Sat, 29 Mar 2025 14:54:39 +0100) Subject: Re: bug#77311: Minor documentation fix (`use-package') References: <874izeikky.fsf@gmail.com> <86pli0885g.fsf@gnu.org> <87v7rshrhc.fsf@gmail.com> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 77311-done Cc: 77311-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Dominik Schrempf > Cc: 77311@debbugs.gnu.org > Date: Sat, 29 Mar 2025 14:54:39 +0100 > > thanks for your comments. > > Please find attached the updated patch. I still changed the tense used > in the documentation of `:commands'. Thanks, installed on the emacs-30 branch, and closing the bug. From unknown Wed Jun 18 23:04:19 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sun, 27 Apr 2025 11:24:08 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator