comparison man/xemacs/startup.texi @ 442:abe6d1db359e r21-2-36

Import from CVS: tag r21-2-36
author cvs
date Mon, 13 Aug 2007 11:35:02 +0200
parents 3a7e78e1142d
children 576fb035e263
comparison
equal deleted inserted replaced
441:72a7cfa4a488 442:abe6d1db359e
37 the one where it is being built.) Such a directory containing a 37 the one where it is being built.) Such a directory containing a
38 hierarchy is called a @dfn{root}. 38 hierarchy is called a @dfn{root}.
39 @cindex root of a hierarchy 39 @cindex root of a hierarchy
40 Whenever this section refers to a directory using the shorthand 40 Whenever this section refers to a directory using the shorthand
41 @code{<root>}, it means that XEmacs searches for it under all 41 @code{<root>}, it means that XEmacs searches for it under all
42 hierarchies under all hierarchies XEmacs was able to scrounge up. In a 42 hierarchies XEmacs was able to scrounge up. In a
43 running XEmacs, the hierarchy roots are stored in the variable 43 running XEmacs, the hierarchy roots are stored in the variable
44 @code{emacs-roots}. 44 @code{emacs-roots}.
45 @vindex emacs-roots 45 @vindex emacs-roots
46 46
47 @subsection Package Hierarchies 47 @subsection Package Hierarchies
61 according to the relative location at which they show 61 according to the relative location at which they show
62 up in the various XEmacs paths. Early package hierarchies are at the 62 up in the various XEmacs paths. Early package hierarchies are at the
63 very front, late ones somewhere in the middle, and last hierarchies are 63 very front, late ones somewhere in the middle, and last hierarchies are
64 (you guessed it) last. 64 (you guessed it) last.
65 65
66 By default, XEmacs expects an early package hierarchy in the a 66 By default, XEmacs expects an early package hierarchy in the
67 subdirectory @file{.xemacs} of the user's home directory. 67 subdirectory @file{.xemacs/xemacs-packages} of the user's home
68 directory.
68 69
69 Moreover, XEmacs expects late hierarchies in the subdirectories 70 Moreover, XEmacs expects late hierarchies in the subdirectories
70 @file{site-packages}, @file{mule-packages}, and @file{xemacs-packages} 71 @file{site-packages}, @file{mule-packages}, and @file{xemacs-packages}
71 (in that order) of the @file{<root>/lib/xemacs} subdirectory of one of 72 (in that order) of the @file{<root>/lib/xemacs} subdirectory of one of
72 the installation hierarchies. (If you run in-place, these are direct 73 the installation hierarchies. (If you run in-place, these are direct
75 subdirectory and prefer directories found there. 76 subdirectory and prefer directories found there.
76 77
77 By default, XEmacs does not have a pre-configured last package 78 By default, XEmacs does not have a pre-configured last package
78 hierarchy. Last hierarchies are primarily for using package hierarchies 79 hierarchy. Last hierarchies are primarily for using package hierarchies
79 of outdated versions of XEmacs as a fallback option. For example, it is 80 of outdated versions of XEmacs as a fallback option. For example, it is
80 possible to run XEmacs 21.0 with the 20.4 package hierarchy as a last 81 possible to run XEmacs 21 with the 20.4 package hierarchy as a last
81 hierarchy. 82 hierarchy.
82 83
83 It is possible to specify at configure-time the location of the various 84 It is possible to specify at configure-time the location of the various
84 package hierarchies with the @code{--package-path} option to configure. 85 package hierarchies with the @code{--package-path} option to configure.
85 @cindex package path 86 @cindex package path
86 The early, late, and last components of the package path are separated 87 The early, late, and last components of the package path are separated
87 by double instead of single colons. If three components are present, 88 by double instead of single colons. If all three components are
88 they are locate the early, late, and last package hierarchies 89 present, they locate the early, late, and last package hierarchies
89 respectively. If two components are present, they locate the early and 90 respectively. If two components are present, they locate the early and
90 late hierarchies. If only one component is present, it locates the late 91 late hierarchies. If only one component is present, it locates the
91 hierarchy. At run time, the package path may also be specified via the 92 late hierarchy. At run time, the package path may also be specified via
92 @code{EMACSPACKAGEPATH} environment variable. 93 the @code{EMACSPACKAGEPATH} environment variable.
93 94
94 An XEmacs package is laid out just like a normal installed XEmacs lisp 95 An XEmacs package is laid out just like a normal installed XEmacs lisp
95 directory. It may have @file{lisp}, @file{etc}, @file{info}, and 96 directory. It may have @file{lisp}, @file{etc}, @file{info}, and
96 @file{lib-src} subdirectories. XEmacs adds these at appropriate places 97 @file{lib-src} subdirectories. XEmacs adds these at appropriate places
97 within the various system-wide paths. 98 within the various system-wide paths.
156 @file{/usr/local/info} as well as the directories of the environment 157 @file{/usr/local/info} as well as the directories of the environment
157 variable @code{INFOPATH} 158 variable @code{INFOPATH}
158 @vindex INFOPATH 159 @vindex INFOPATH
159 to @code{Info-directory-list}. 160 to @code{Info-directory-list}.
160 161
161 @item lock-directory
162 @itemx superlock-file
163 @vindex lock-directory
164 @vindex superlock-file
165 Are the site-specific locations of the lock directory and the superlock
166 file, respectively. The @code{lock-directory} variable may also be
167 initialized from the @code{EMACSLOCKDIR}
168 @vindex EMACSLOCKDIR
169 environment variable.
170
171 @item exec-directory 162 @item exec-directory
172 @vindex exec-directory 163 @vindex exec-directory
173 Is the directory of architecture-dependent files that come with XEmacs, 164 Is the directory of architecture-dependent files that come with XEmacs,
174 especially executable programs intended for XEmacs to invoke. 165 especially executable programs intended for XEmacs to invoke.
175 166