Re: use-package documentation

[Eli Zaretskii]

> From: David Masterson <dsmasterson@gmail.com>
> Cc: emacs-devel@gnu.org
> Date: Thu, 05 Jan 2023 22:03:57 -0800
> 
> Richard Stallman <rms@gnu.org> writes:
> 
> Question: is it too early to "integrate" use-package documentation in
> standard Emacs documents when there are other variants of use-package
> (quelpa, straight, etc.) out there that may enhance or replace it?
> 
> Personally, I could see use-package (or variant) be the standard tool
> for providing a standard structure to an init file and, so, talking
> about that structure and how use-package helps facilitate it would
> belong in the "Customization" section of the Emacs manual.  This would
> be for new users graduating from push button setup (M-x customize) into
> the next level of "programming" Emacs to fit the environment they want.
> References could point to the Elisp manual to go beyond the basics of
> "initialization" (setq, setup functions, etc.) to full programming for
> really special customization.

This is no longer a theoretical argument: use-package is now shortly
described in both core manuals as I thought it should be, with a
cross-reference to the full manual that came with use-package.  So
please review what's in the manuals now, and if you have concrete
suggestions for changes or improvements, please post such specific
suggestions wrt the existing text in the manuals.