GNU bug report logs - #77311
Minor documentation fix (`use-package')

Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.

Package: emacs; Reported by: Dominik Schrempf <dominik.schrempf@HIDDEN>; Keywords: patch; dated Thu, 27 Mar 2025 15:02:04 UTC; Maintainer for emacs is bug-gnu-emacs@HIDDEN.
Added tag(s) patch. Request was from Stefan Kangas <stefankangas@HIDDEN> to control <at> debbugs.gnu.org. Full text available.

Message received at submit <at> debbugs.gnu.org:


Received: (at submit) by debbugs.gnu.org; 27 Mar 2025 15:01:53 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Thu Mar 27 11:01:52 2025
Received: from localhost ([127.0.0.1]:50806 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1txojw-0005L6-7F
	for submit <at> 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 <dominik.schrempf@HIDDEN>)
 id 1txojt-0005Jb-Bo
 for submit <at> 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 <dominik.schrempf@HIDDEN>)
 id 1txojj-0001Hn-PL
 for bug-gnu-emacs@HIDDEN; 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 <dominik.schrempf@HIDDEN>)
 id 1txojh-0001Lg-W2
 for bug-gnu-emacs@HIDDEN; Thu, 27 Mar 2025 11:01:39 -0400
Received: by mail-ej1-x635.google.com with SMTP id
 a640c23a62f3a-aaee2c5ee6eso167270966b.1
 for <bug-gnu-emacs@HIDDEN>; 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 <bug-gnu-emacs@HIDDEN>
 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
 Thu, 27 Mar 2025 08:01:35 -0700 (PDT)
From: Dominik Schrempf <dominik.schrempf@HIDDEN>
To: "Emacs Bug Tracker" <bug-gnu-emacs@HIDDEN>
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@HIDDEN>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="=-=-="
Received-SPF: pass client-ip=2a00:1450:4864:20::635;
 envelope-from=dominik.schrempf@HIDDEN; 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 <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 (/)

--=-=-=
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 <dominik.schrempf@HIDDEN>
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


--=-=-=--




Acknowledgement sent to Dominik Schrempf <dominik.schrempf@HIDDEN>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs@HIDDEN. Full text available.
Report forwarded to bug-gnu-emacs@HIDDEN:
bug#77311; Package emacs. Full text available.
Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
Last modified: Fri, 28 Mar 2025 00:15:02 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.