From: Glenn Morris <rgm@gnu.org>
Date: Sat, 16 May 2020 17:29:14 +0000 (-0700)
Subject: Merge from origin/emacs-27
X-Git-Tag: emacs-28.0.90~7342
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=788c2480f448e97773172f3e840976dbcdc3e6c8;p=emacs.git

Merge from origin/emacs-27

b4937f64cd (origin/emacs-27) Improve documentation of manually instal...
efd4e973a4 Reflect the emacs-devel ELPA/MELPA dispute in FAQ
28541674cd Consider face inheritance when checking region face backgr...
e75f6be6cc Fix dired default file operation (bug#41261)
406fb0746c Fix documentation related to 'command-switch-alist'.
747e0a2523 Improve ediff readability in misterioso theme (Bug#41221)
48830c73e7 Fix a crash in handle_display_spec
a37290a6f9 In x_hide_tip reset tip_last_frame for GTK+ tooltips only ...
3d81995692 Fix docstring of flymake-make-diagnostic (bug#40351)
632aa9d57a Go back to “Bahá’í”
e2406ff60f * lisp/dired.el (dired-toggle-marks): Doc fix.  (Bug#41097)

# Conflicts:
#	doc/emacs/building.texi
---

788c2480f448e97773172f3e840976dbcdc3e6c8
diff --cc doc/emacs/building.texi
index 77a0e807c2b,fa60ce26621..7074bd45d71
--- a/doc/emacs/building.texi
+++ b/doc/emacs/building.texi
@@@ -1563,6 -1536,40 +1568,33 @@@ Automatic loading also occurs when comp
  prefix being completed.  To disable this feature, change the variable
  @code{help-enable-completion-autoload} to @code{nil}.
  
 -@vindex load-dangerous-libraries
 -@cindex Lisp files byte-compiled by XEmacs
 -  By default, Emacs refuses to load compiled Lisp files which were
 -compiled with XEmacs, a modified version of Emacs---they can cause
 -Emacs to crash.  Set the variable @code{load-dangerous-libraries} to
 -@code{t} if you want to try loading them.
 -
+   Once you put your library in a directory where Emacs can find and
+ load it, you may wish to make it available at startup.  This is useful
+ when the library defines features that should be available
+ automatically on demand, and manually loading the library is thus
+ inconvenient.  In these cases, make sure the library will be loaded by
+ adding suitable forms to your init file: either @code{load} or
+ @code{require} (if you always need to load the library at startup), or
+ @code{autoload} if you need Emacs to load the library when some
+ command or function is invoked.  For example:
+ 
+ @smalllisp
+ @group
+  ;; Loads @file{my-shining-package.elc} unconditionally.
+  (require 'my-shining-package)
+ @end group
+ @group
+  ;; Will load @file{my-shining-package.elc} when @code{my-func} is invoked.
+  (autoload 'my-func "my-shining-package")
+ @end group
+ @end smalllisp
+ 
+   Note that installing a package using @code{package-install}
+ (@pxref{Package Installation}) takes care of placing the package's
+ Lisp files in a directory where Emacs will find it, and also writes
+ the necessary initialization code into your init files, making the
+ above manual customizations unnecessary.
+ 
  @node Lisp Eval
  @section Evaluating Emacs Lisp Expressions
  @cindex Emacs Lisp mode