Merge from savannah/emacs-30

1ee8579eb7d Fix bug#72255
05629d3af0a Delete redundant "a.k.a." in use-package.texi
c7609464f70 Document (use-package 'emacs) declarations
de9f9add138 Improve 'emacs-news-view-mode' menus and bindings
7588e1f8a9f ; * src/xdisp.c (Fformat_mode_line): Doc fix.
2074e94c3b1 Fix disappearing bar cursor on Hebrew text (bug#72230)
1aaadc8aec5 Fix DocView with DVI files
c1382257aa8 ; Fix typo in use-package.texi
caf7426f0ca FIx spurious fontification of variable in Java Mode
9b426e15abd Correctly typeset nil and t in texinfo
f050b9c5033 Fix Tramp IPv6 handling in tests
46b192c04b1 Update to Org 9.7.8-5-gfdf0e0
87f41b937bc Fix Ftreesit_parser_create

2 files changed, 41 insertions, 13 deletions

diff --git a/doc/misc/gnus-faq.texi b/doc/misc/gnus-faq.texi
index a773d48417c..c21f19cc784 100644
--- a/doc/misc/gnus-faq.texi
+++ b/doc/misc/gnus-faq.texi
@@ -1173,12 +1173,11 @@ to postings you send to the gmane hierarchy, use
 send to groups containing the string binaries in their
 name etc.
 
-You can instead of specifying a regexp specify a function
-which is evaluated, only if it returns true, the
-corresponding settings take effect.  Two interesting
-candidates for this are message-news-p which returns t if
-the current Group is a newsgroup and the corresponding
-message-mail-p.
+You can instead of specifying a regexp specify a function which is
+evaluated, only if it returns true, the corresponding settings take
+effect.  Two interesting candidates for this are @code{message-news-p}
+which returns @code{t} if the current Group is a newsgroup and the
+corresponding @code{message-mail-p}.
 
 Note that all forms that match are applied, that means in
 the example below, when I post to
diff --git a/doc/misc/use-package.texi b/doc/misc/use-package.texi
index 99348398550..8a7af5bc6f6 100644
--- a/doc/misc/use-package.texi
+++ b/doc/misc/use-package.texi
@@ -177,13 +177,13 @@ loading actually occurs.  As you might expect, you can use
 @end group
 @end lisp
 
-The above declarations will load the @samp{foo} package
-immediately.  In most cases, this is not necessary or desirable, as
-that will slow down Emacs startup.  Instead, you should try to set
-things up so that packages are only loaded when they are actually
-needed (a.k.a. ``autoloading'').  If you have installed a package from
-@acronym{GNU} @acronym{ELPA} that provides it's own autoloads, it is often
-enough to say:
+The above declarations will load the @samp{foo} package immediately.  In
+most cases, this is not necessary or desirable, as that will slow down
+Emacs startup.  Instead, you should try to set things up so that
+packages are only loaded when they are actually needed
+(``autoloading'').  If you have installed a package from @acronym{GNU}
+@acronym{ELPA} that provides its own autoloads, it is often enough to
+say:
 
 @lisp
 @group
@@ -252,6 +252,7 @@ on Emacs start.  @xref{Installing packages}, for details.
 * Forcing loading::             Loading packages immediately.
 * Conditional loading::         Loading packages conditionally.
 * Loading sequentially::        Loading packages in sequence.
+* The @code{emacs} package::    Customizing built-in variables.
 * Load dependencies::           Don't load without dependencies.
 * Manual installation::         Loading manually installed packages.
 @end menu
@@ -567,6 +568,34 @@ registers autoloads, such as @code{:bind} or @code{:hook}
 it is possible that your package will never be loaded if you do not
 add @code{:demand t} to those declarations.
 
+@node The @code{emacs} package
+@section Customizing built-in variables
+@cindex customizing built-in variables
+
+Some users want to put all their customizations in use-package
+declarations, even for variables, hooks, and options that are always
+available, without loading any package.@footnote{In other words, they
+are either preloaded in Emacs or defined in Emacs' C sources.}
+
+For that purpose, you can use the no-op @samp{emacs} package:
+
+@lisp
+@group
+(use-package emacs
+  :init
+  (setq custom-file "~/.emacs.d/emacs-custom.el")
+  (load custom-file)
+  (setq frame-title-format "%b")
+  :custom
+  (use-short-answers t))
+@end group
+@end lisp
+
+This declaration takes advantage of the fact that @w{@code{(featurep
+'emacs)}} always returns true, and has no special meaning beyond that.
+It simply provides a way to organize your customizations, without
+loading anything.
+
 @node Load dependencies
 @section Prevent loading if dependencies are missing
 @cindex prevent loading package if dependencies are missing