Mercurial > hg > xemacs-beta
comparison lisp/utils/auto-autoloads.el @ 193:f53b5ca2e663 r20-3b23
Import from CVS: tag r20-3b23
| author | cvs |
|---|---|
| date | Mon, 13 Aug 2007 09:58:30 +0200 |
| parents | 489f57a838ef |
| children | a2f645c6b9f8 |
comparison
equal
deleted
inserted
replaced
| 192:9d35321dd38c | 193:f53b5ca2e663 |
|---|---|
| 854 Save the histories from `savehist-history-variables' to `savehist-file'. | 854 Save the histories from `savehist-history-variables' to `savehist-file'. |
| 855 A variable will be saved if it is bound and non-nil." t nil) | 855 A variable will be saved if it is bound and non-nil." t nil) |
| 856 | 856 |
| 857 ;;;*** | 857 ;;;*** |
| 858 | 858 |
| 859 ;;;### (autoloads (list-load-path-shadows) "shadow" "utils/shadow.el") | |
| 860 | |
| 861 (autoload 'list-load-path-shadows "shadow" "\ | |
| 862 Display a list of Emacs Lisp files that shadow other files. | |
| 863 | |
| 864 This function lists potential load-path problems. Directories in the | |
| 865 `load-path' variable are searched, in order, for Emacs Lisp | |
| 866 files. When a previously encountered file name is found again, a | |
| 867 message is displayed indicating that the later file is \"hidden\" by | |
| 868 the earlier. | |
| 869 | |
| 870 For example, suppose `load-path' is set to | |
| 871 | |
| 872 \(\"/usr/gnu/emacs/site-lisp\" \"/usr/gnu/emacs/share/emacs/19.30/lisp\") | |
| 873 | |
| 874 and that each of these directories contains a file called XXX.el. Then | |
| 875 XXX.el in the site-lisp directory is referred to by all of: | |
| 876 \(require 'XXX), (autoload .... \"XXX\"), (load-library \"XXX\") etc. | |
| 877 | |
| 878 The first XXX.el file prevents emacs from seeing the second (unless | |
| 879 the second is loaded explicitly via load-file). | |
| 880 | |
| 881 When not intended, such shadowings can be the source of subtle | |
| 882 problems. For example, the above situation may have arisen because the | |
| 883 XXX package was not distributed with versions of emacs prior to | |
| 884 19.30. An emacs maintainer downloaded XXX from elsewhere and installed | |
| 885 it. Later, XXX was updated and included in the emacs distribution. | |
| 886 Unless the emacs maintainer checks for this, the new version of XXX | |
| 887 will be hidden behind the old (which may no longer work with the new | |
| 888 emacs version). | |
| 889 | |
| 890 This function performs these checks and flags all possible | |
| 891 shadowings. Because a .el file may exist without a corresponding .elc | |
| 892 \(or vice-versa), these suffixes are essentially ignored. A file | |
| 893 XXX.elc in an early directory (that does not contain XXX.el) is | |
| 894 considered to shadow a later file XXX.el, and vice-versa. | |
| 895 | |
| 896 When run interactively, the shadowings (if any) are displayed in a | |
| 897 buffer called `*Shadows*'. Shadowings are located by calling the | |
| 898 \(non-interactive) companion function, `find-emacs-lisp-shadows'." t nil) | |
| 899 | |
| 900 ;;;*** | |
| 901 | |
| 859 ;;;### (autoloads (skeleton-pair-insert-maybe skeleton-insert skeleton-proxy skeleton-proxy-new define-skeleton) "skeleton" "utils/skeleton.el") | 902 ;;;### (autoloads (skeleton-pair-insert-maybe skeleton-insert skeleton-proxy skeleton-proxy-new define-skeleton) "skeleton" "utils/skeleton.el") |
| 860 | 903 |
| 861 (defvar skeleton-filter 'identity "\ | 904 (defvar skeleton-filter 'identity "\ |
| 862 Function for transforming a skeleton proxy's aliases' variable value.") | 905 Function for transforming a skeleton proxy's aliases' variable value.") |
| 863 | 906 |