|
331
|
1 The XEmacs Packages Quick Start Guide
|
|
|
2 -------------------------------------
|
|
|
3
|
|
|
4 This text is intended to help you get started installing a new XEmacs
|
|
|
5 and its packages from start. For details see the 'Startup Paths' and
|
|
|
6 'Packages' sections of the XEmacs info manual.
|
|
|
7
|
|
|
8 Real Real Quickstart FAQ
|
|
|
9 ------------------------
|
|
|
10
|
|
|
11 Q. Do I need to have the packages to compile XEmacs?
|
|
339
|
12 A. No.
|
|
331
|
13
|
|
|
14 Q. I really liked the old way that packages were bundled and do not
|
|
|
15 want to mess with packages at all.
|
|
|
16 A. You can grab all the packages at once like you used to with old
|
|
|
17 XEmacs versions, skip to the 'Sumo Tarball' section below.
|
|
|
18
|
|
|
19 A note of caution
|
|
|
20 -----------------
|
|
|
21
|
|
|
22 The XEmacs package system is still in its infancy. Please expect a few
|
|
|
23 minor hurdles on the way. Also neither the interface nor the structure is
|
|
|
24 set in stone. The XEmacs maintainers reserve the right to sacrifice
|
|
|
25 backwards compatibility as quirks are worked out over the coming
|
|
|
26 releases.
|
|
|
27
|
|
|
28 Some Package Theory
|
|
|
29 -------------------
|
|
|
30
|
|
|
31 In order to reduce the size and increase the maintainability of XEmacs,
|
|
|
32 the majority of the Elisp packages that came with previous releases
|
|
|
33 have been unbundled. They have been replaced by the package system.
|
|
|
34 Each elisp add-on (or groups of them when they are small) now comes
|
|
|
35 in its own tarball that contains a small search hierarchy.
|
|
|
36
|
|
|
37 You select just the ones you need. Install them by untarring them into
|
|
|
38 the right place. On startup XEmacs will find them, set up the load
|
|
|
39 path correctly, install autoloads, etc, etc.
|
|
|
40
|
|
|
41 Package hierarchies
|
|
|
42 -------------------
|
|
|
43
|
|
|
44 On Startup XEmacs looks for packages in so called package hierarchies.
|
|
|
45 These can be specified by the 'package-path' parameter to the
|
|
|
46 'configure' script. However by default there are three system wide
|
|
|
47 hierarchies.
|
|
|
48
|
|
|
49 $prefix/lib/xemacs/site-packages
|
|
|
50 Local and 3rd party packages go here.
|
|
|
51
|
|
|
52 $prefix/lib/xemacs/mule-packages
|
|
|
53 Only searched by MULE-enabled XEmacsen.
|
|
|
54
|
|
|
55 $prefix/lib/xemacs/xemacs-packages
|
|
|
56 Normal packages go here.
|
|
|
57
|
|
|
58 Where to get the packages
|
|
|
59 -------------------------
|
|
|
60
|
|
|
61 Packages are available from ftp://ftp.xemacs.org/pub/xemacs/packages
|
|
|
62 and its mirror.
|
|
|
63
|
|
|
64 How to install the packages
|
|
|
65 ---------------------------
|
|
|
66
|
|
|
67 1. All at once, using the 'Sumo Tarball'.
|
|
|
68 2. By hand.
|
|
|
69 3. Automatically, using the package tools from XEmacs.
|
|
|
70
|
|
|
71 The Sumo Tarball
|
|
|
72 ----------------
|
|
|
73
|
|
|
74 Those with little time, cheap connections and plenty of disk space can
|
|
|
75 install all packages at once using the sumo tarballs.
|
|
333
|
76 Download the file
|
|
331
|
77
|
|
333
|
78 xemacs-sumo-<date>.tar.gz
|
|
331
|
79
|
|
333
|
80 For an XEmacs compiled with Mule you also need
|
|
331
|
81
|
|
333
|
82 xemacs-mule-sumo-<date>.tar.gz
|
|
331
|
83
|
|
333
|
84 N.B. They are called 'Sumo Tarballs' for good reason. They are
|
|
|
85 currently about 15MB and 2.3MB (gzipped) respectively.
|
|
331
|
86
|
|
|
87 Install them by
|
|
|
88
|
|
|
89 cd $prefix/lib/xemacs ; gunzip -c <tarballname> | tar xf -
|
|
|
90
|
|
|
91 As the Sumo tarballs are not regenerated as often as the individual
|
|
|
92 packages, it is recommended that you use the automatic package tools
|
|
|
93 afterwards to pick up any recent updates.
|
|
|
94
|
|
|
95 Installing by Hand
|
|
|
96 ------------------
|
|
|
97
|
|
|
98 Fetch the packages from the ftp site, CDROM whatever. The filenames
|
|
|
99 have the form name-<version>-pkg.tar.gz and are gzipped tar files. For
|
|
|
100 a fresh install it is sufficient to untar the file at the top of the
|
|
|
101 package hierarchy. For example if we are installing the 'xemacs-base'
|
|
|
102 package in version 1.27:
|
|
|
103
|
|
|
104 mkdir $prefix/lib/xemacs/xemacs-packages # if it does not exist yet
|
|
|
105 cd $prefix/lib/xemacs/xemacs-packages
|
|
|
106 gunzip -c ...../xemacs-base-1.27-pkg.tar.gz | tar xf -
|
|
|
107
|
|
|
108 For MULE related packages, it is best to untar in the mule-packages
|
|
|
109 hierarchy, i.e. for the mule-base package, version 1.25
|
|
|
110
|
|
|
111 mkdir $prefix/lib/xemacs/mule-packages # if it does not exist yet
|
|
|
112 cd $prefix/lib/xemacs/mule-packages
|
|
|
113 gunzip -c ...../mule-base-1.25-pkg.tar.gz | tar xf -
|
|
|
114
|
|
|
115 Installing automatically
|
|
|
116 ------------------------
|
|
|
117
|
|
|
118 XEmacs comes with some tools to make the periodic updating and
|
|
|
119 installing easier. It will notice if new packages or versions are
|
|
|
120 available and will fetch them from the ftp site.
|
|
|
121
|
|
333
|
122 Unfortunately this requires that a few packages are already in place.
|
|
331
|
123 You will have to install them by hand as above or use a SUMO tarball.
|
|
|
124 This requirement will hopefully go away in the future. The packages
|
|
|
125 you need are:
|
|
|
126
|
|
|
127 efs - To fetch the files from the ftp site or mirrors.
|
|
|
128 xemacs-base - Needed by efs.
|
|
|
129
|
|
|
130 and optionally:
|
|
|
131
|
|
|
132 mailcrypt - If you have PGP installed and want to verify the
|
|
|
133 signature of the index file.
|
|
339
|
134 mule-base - Needed if you want to run XEmacs with MULE with a
|
|
|
135 non-English language environment.
|
|
331
|
136
|
|
|
137 After installing these by hand, you can start XEmacs. (It is a good
|
|
|
138 idea to use 'xemacs -vanilla' here as your startup files might need
|
|
|
139 things now moved to packages.)
|
|
|
140
|
|
|
141 - First you need to specify an FTP site to use.
|
|
|
142 Use Options->Manage Packages->Add Download Site
|
|
|
143 or M-x customize-variable RET package-get-remote RET
|
|
|
144
|
|
|
145 Alternatively, if you already have the packages on a local disk
|
|
|
146 then you can specify this directly using 'M-x
|
|
|
147 pui-add-install-directory'. Please make sure you also have a
|
|
|
148 corresponding copy of the package index there.
|
|
|
149
|
|
|
150 - Invoke Options->Manage Packages->List & Install
|
|
|
151 or M-x pui-list-packages RET
|
|
|
152 XEmacs will now first try to fetch a new version of the package
|
|
|
153 index from the FTP site. Depending on whether you are using
|
|
|
154 'mailcrypt/PGP', you will get some question about keys to fetch or
|
|
|
155 whether to use the index without verifying the signature. If the
|
|
|
156 new index was different from the one already on disk, XEmacs will
|
|
|
157 offer you to overwrite the old index.
|
|
|
158
|
|
|
159 - XEmacs will show you a buffer named "*Packages*" with an overview
|
|
|
160 of available and installed packages, including a short description.
|
|
|
161 In this buffer you can select which packages you want using the
|
|
|
162 mouse or using RET.
|
|
|
163
|
|
|
164 - When you are finished choosing packages, invoke
|
|
|
165 'Packages->Install/Remove Select' from the menu or type 'x' to
|
|
|
166 begin installing packages.
|
|
|
167
|
|
|
168 After Installation
|
|
|
169 ------------------
|
|
|
170
|
|
|
171 New packages can only be used by XEmacs after a restart.
|
|
|
172
|
|
|
173 Note to MULE users
|
|
|
174 ------------------
|
|
|
175
|
|
339
|
176 It is a good idea to keep packages that are MULE-only separate by
|
|
|
177 putting them in the mule-packages hierarchy. Non-Mule XEmacsen will
|
|
|
178 ignore packages in mule-packages so it is safe to have that directory
|
|
|
179 in the package path of a Non-Mule XEmacs.
|
|
331
|
180
|
|
|
181 Which Packages to install?
|
|
|
182 --------------------------
|
|
|
183
|
|
|
184 This is difficult to say. When in doubt install a package. If you
|
|
|
185 administrate a big site it might be a good idea to just install
|
|
|
186 everything. A good minimal set of packages for XEmacs-latin1 would be
|
|
|
187
|
|
|
188 xemacs-base, xemacs-devel, c-support, cc-mode, debug, dired, efs,
|
|
|
189 edit-utils, fsf-compat, mail-lib, net-utils, os-utils, prog-modes,
|
|
|
190 text-modes, time
|
|
|
191
|
|
|
192 Unfortunately the package system currently provides neither
|
|
|
193 dependencies nor conflicts. This will be a future enhancement. The
|
|
|
194 above set includes most packages that are used by others.
|
|
|
195
|
|
|
196 See also '.../etc/PACKAGES' for further descriptions of the individual
|
|
|
197 packages (currently outdated).
|
|
|
198
|
|
|
199 Upgrading/Removing Packages
|
|
|
200 ---------------------------
|
|
|
201
|
|
|
202 As the exact files and their locations contained in a package may
|
|
|
203 change it is recommend to remove a package first before installing a
|
|
|
204 new version. In order to facilitate removal each package contains an
|
|
|
205 pgkinfo/MANIFEST.pkgname file which list all the files belong to the
|
|
|
206 package. M-x package-admin-delete-binary-package RET can be used to
|
|
|
207 remove a package using this file.
|
|
|
208
|
|
|
209 Note that the interactive package tools included with XEmacs already do
|
|
|
210 this for you.
|
|
|
211
|
|
|
212 User Package directories
|
|
|
213 ------------------------
|
|
|
214
|
|
|
215 In addition to the system wide packages, each user can have his own
|
|
347
|
216 packages installed in "~/.xemacs" (Note that this will most likely
|
|
|
217 change to "~/.xemacs/packages" in the near future). If you want to
|
|
331
|
218 install packages there using the interactive tools, you need to set
|
|
347
|
219 'pui-package-install-dest-dir' to "~/xemacs"
|
|
331
|
220
|
|
|
221 Site lisp/Site start
|
|
|
222 --------------------
|
|
|
223
|
|
|
224 The site-packages hierarchy replaces the old 'site-lisp' directory.
|
|
|
225 XEmacs no longer looks into a 'site-lisp' directly by default.
|
|
|
226 A good place to put 'site-start.el' would be in
|
|
|
227 $prefix/lib/xemacs/site-packages/lisp/
|
