diff options
| author | Lars Ingebrigtsen | 2016-04-30 19:20:12 +0200 |
|---|---|---|
| committer | Lars Ingebrigtsen | 2016-04-30 19:20:12 +0200 |
| commit | 9392193be56eebdfac702a0bbb5e954088371c7a (patch) | |
| tree | 65ce8a90be60658b9e44fc8a879e7d78897a2ace /doc/lispref | |
| parent | 77c5f4554ebb3b7c7d49bc881e45a550f6c93987 (diff) | |
| download | emacs-9392193be56eebdfac702a0bbb5e954088371c7a.tar.gz emacs-9392193be56eebdfac702a0bbb5e954088371c7a.zip | |
Transform mentions of `eval-after-load' to `with-eval-after-load'
* doc/lispref/loading.texi (Hooks for Loading): Update text to
not mention `eval-after-load' (bug#20038).
Diffstat (limited to 'doc/lispref')
| -rw-r--r-- | doc/lispref/loading.texi | 11 | ||||
| -rw-r--r-- | doc/lispref/tips.texi | 12 |
2 files changed, 12 insertions, 11 deletions
diff --git a/doc/lispref/loading.texi b/doc/lispref/loading.texi index 06900a49477..d2d38d7fb5e 100644 --- a/doc/lispref/loading.texi +++ b/doc/lispref/loading.texi | |||
| @@ -1089,11 +1089,12 @@ execution of the rest of @var{body}. | |||
| 1089 | @end defmac | 1089 | @end defmac |
| 1090 | 1090 | ||
| 1091 | Normally, well-designed Lisp programs should not use | 1091 | Normally, well-designed Lisp programs should not use |
| 1092 | @code{eval-after-load}. If you need to examine and set the variables | 1092 | @code{with-eval-after-load}. If you need to examine and set the |
| 1093 | defined in another library (those meant for outside use), you can do | 1093 | variables defined in another library (those meant for outside use), |
| 1094 | it immediately---there is no need to wait until the library is loaded. | 1094 | you can do it immediately---there is no need to wait until the library |
| 1095 | If you need to call functions defined by that library, you should load | 1095 | is loaded. If you need to call functions defined by that library, you |
| 1096 | the library, preferably with @code{require} (@pxref{Named Features}). | 1096 | should load the library, preferably with @code{require} (@pxref{Named |
| 1097 | Features}). | ||
| 1097 | 1098 | ||
| 1098 | @node Dynamic Modules | 1099 | @node Dynamic Modules |
| 1099 | @section Emacs Dynamic Modules | 1100 | @section Emacs Dynamic Modules |
diff --git a/doc/lispref/tips.texi b/doc/lispref/tips.texi index 0a3d244157e..d12de7aee2d 100644 --- a/doc/lispref/tips.texi +++ b/doc/lispref/tips.texi | |||
| @@ -200,12 +200,12 @@ It is likewise a bad idea for one Lisp package to advise a function in | |||
| 200 | another Lisp package (@pxref{Advising Functions}). | 200 | another Lisp package (@pxref{Advising Functions}). |
| 201 | 201 | ||
| 202 | @item | 202 | @item |
| 203 | Avoid using @code{eval-after-load} in libraries and packages | 203 | Avoid using @code{eval-after-load} and @code{with-eval-after-load} in |
| 204 | (@pxref{Hooks for Loading}). This feature is meant for personal | 204 | libraries and packages (@pxref{Hooks for Loading}). This feature is |
| 205 | customizations; using it in a Lisp program is unclean, because it | 205 | meant for personal customizations; using it in a Lisp program is |
| 206 | modifies the behavior of another Lisp file in a way that's not visible | 206 | unclean, because it modifies the behavior of another Lisp file in a |
| 207 | in that file. This is an obstacle for debugging, much like advising a | 207 | way that's not visible in that file. This is an obstacle for |
| 208 | function in the other package. | 208 | debugging, much like advising a function in the other package. |
| 209 | 209 | ||
| 210 | @item | 210 | @item |
| 211 | If a file does replace any of the standard functions or library | 211 | If a file does replace any of the standard functions or library |