From: Stefan Kangas <stefankangas@gmail.com>
Date: Wed, 19 Mar 2025 20:27:29 +0000 (+0100)
Subject: ; Improve introduction to use-package manual
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=6e64973a3352c690af042cc1e5a4251d31154887;p=emacs.git

; Improve introduction to use-package manual

* doc/misc/use-package.texi (Top): Improve introduction.

(cherry picked from commit b681d62436f577ddfbfbac50885d48cde320632e)
---

diff --git a/doc/misc/use-package.texi b/doc/misc/use-package.texi
index b31a09bbc2c..fb3538cae8b 100644
--- a/doc/misc/use-package.texi
+++ b/doc/misc/use-package.texi
@@ -49,19 +49,18 @@ modify this GNU manual.''
 @node Top
 @top use-package User Manual
 
-The @code{use-package} macro allows you to set up package
-customization in your init file in a declarative way.  It takes care
-of many things for you that would otherwise require a lot of
-repetitive boilerplate code.  It can help with common customization,
-such as binding keys, setting up hooks, customizing user options and
-faces, autoloading, and more.  It also helps you keep Emacs startup
-fast, even when you use many (even hundreds) of packages.
-
-Note that use-package is not a package manager.  Although use-package
-does have the useful capability to interface with the Emacs package
-manager, its primary purpose is help with the configuration and
-loading of packages, not with managing their download, upgrades, and
-installation.
+The @code{use-package} macro allows you to set up package customization
+in your init file in a declarative way.  It reduces the need for
+repetitive boilerplate code by handling many common customization tasks
+for you.  These include binding keys, setting hooks, customizing user
+options and faces, setting up autoloading, and more.  It also helps you
+keep Emacs startup fast, even when you use many (even hundreds) of
+packages.
+
+Note that use-package is not a package manager.  While it provides
+convenient integration with Emacs's built-in package manager, its
+primary purpose is to help with configuring and loading packages, not
+with downloading, upgrading, or installing them.
 
 @insertcopying