annotate etc/bundled-packages/README @ 5477:90dcf2376909

Last minute notice fixups.
author Stephen J. Turnbull <stephen@xemacs.org>
date Fri, 29 Apr 2011 02:35:13 +0900
parents fd714e8ba81e
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
5477
90dcf2376909 Last minute notice fixups.
Stephen J. Turnbull <stephen@xemacs.org>
parents: 5411
diff changeset
1 Copyright 2007 Free Software Foundation
90dcf2376909 Last minute notice fixups.
Stephen J. Turnbull <stephen@xemacs.org>
parents: 5411
diff changeset
2
5411
fd714e8ba81e Converted to GPLv3 or later. Written by Stephen Turnbull hence.GPLv2 or later.
Mats Lidell <matsl@xemacs.org>
parents: 4361
diff changeset
3 This file is part of XEmacs.
fd714e8ba81e Converted to GPLv3 or later. Written by Stephen Turnbull hence.GPLv2 or later.
Mats Lidell <matsl@xemacs.org>
parents: 4361
diff changeset
4
fd714e8ba81e Converted to GPLv3 or later. Written by Stephen Turnbull hence.GPLv2 or later.
Mats Lidell <matsl@xemacs.org>
parents: 4361
diff changeset
5 XEmacs is free software: you can redistribute it and/or modify it
fd714e8ba81e Converted to GPLv3 or later. Written by Stephen Turnbull hence.GPLv2 or later.
Mats Lidell <matsl@xemacs.org>
parents: 4361
diff changeset
6 under the terms of the GNU General Public License as published by the
fd714e8ba81e Converted to GPLv3 or later. Written by Stephen Turnbull hence.GPLv2 or later.
Mats Lidell <matsl@xemacs.org>
parents: 4361
diff changeset
7 Free Software Foundation, either version 3 of the License, or (at your
fd714e8ba81e Converted to GPLv3 or later. Written by Stephen Turnbull hence.GPLv2 or later.
Mats Lidell <matsl@xemacs.org>
parents: 4361
diff changeset
8 option) any later version.
fd714e8ba81e Converted to GPLv3 or later. Written by Stephen Turnbull hence.GPLv2 or later.
Mats Lidell <matsl@xemacs.org>
parents: 4361
diff changeset
9
fd714e8ba81e Converted to GPLv3 or later. Written by Stephen Turnbull hence.GPLv2 or later.
Mats Lidell <matsl@xemacs.org>
parents: 4361
diff changeset
10 XEmacs is distributed in the hope that it will be useful, but WITHOUT
fd714e8ba81e Converted to GPLv3 or later. Written by Stephen Turnbull hence.GPLv2 or later.
Mats Lidell <matsl@xemacs.org>
parents: 4361
diff changeset
11 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
fd714e8ba81e Converted to GPLv3 or later. Written by Stephen Turnbull hence.GPLv2 or later.
Mats Lidell <matsl@xemacs.org>
parents: 4361
diff changeset
12 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
fd714e8ba81e Converted to GPLv3 or later. Written by Stephen Turnbull hence.GPLv2 or later.
Mats Lidell <matsl@xemacs.org>
parents: 4361
diff changeset
13 for more details.
fd714e8ba81e Converted to GPLv3 or later. Written by Stephen Turnbull hence.GPLv2 or later.
Mats Lidell <matsl@xemacs.org>
parents: 4361
diff changeset
14
fd714e8ba81e Converted to GPLv3 or later. Written by Stephen Turnbull hence.GPLv2 or later.
Mats Lidell <matsl@xemacs.org>
parents: 4361
diff changeset
15 You should have received a copy of the GNU General Public License
fd714e8ba81e Converted to GPLv3 or later. Written by Stephen Turnbull hence.GPLv2 or later.
Mats Lidell <matsl@xemacs.org>
parents: 4361
diff changeset
16 along with XEmacs. If not, see <http://www.gnu.org/licenses/>.
fd714e8ba81e Converted to GPLv3 or later. Written by Stephen Turnbull hence.GPLv2 or later.
Mats Lidell <matsl@xemacs.org>
parents: 4361
diff changeset
17
fd714e8ba81e Converted to GPLv3 or later. Written by Stephen Turnbull hence.GPLv2 or later.
Mats Lidell <matsl@xemacs.org>
parents: 4361
diff changeset
18
4354
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
19 Package distributions may be placed in this directory.
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
20 If present and a package-path is configured, packages can be installed
4361
146742e30f05 Ensure LATE_PACKAGES_DIRECTORIES is a trivial search path.
Stephen J. Turnbull <stephen@xemacs.org>
parents: 4354
diff changeset
21 using the top-level Makefile.
4354
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
22
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
23 To configure the package path, use the --with-late-packages option to
4361
146742e30f05 Ensure LATE_PACKAGES_DIRECTORIES is a trivial search path.
Stephen J. Turnbull <stephen@xemacs.org>
parents: 4354
diff changeset
24 configure, which specifies a single directory in which to install the
146742e30f05 Ensure LATE_PACKAGES_DIRECTORIES is a trivial search path.
Stephen J. Turnbull <stephen@xemacs.org>
parents: 4354
diff changeset
25 xemacs-packages and mule-packages hierarchies provided. If this is null,
146742e30f05 Ensure LATE_PACKAGES_DIRECTORIES is a trivial search path.
Stephen J. Turnbull <stephen@xemacs.org>
parents: 4354
diff changeset
26 or contains a Unix-style search path (i.e., a colon is present in the
146742e30f05 Ensure LATE_PACKAGES_DIRECTORIES is a trivial search path.
Stephen J. Turnbull <stephen@xemacs.org>
parents: 4354
diff changeset
27 argument of the --with-late-packages option), you will have to install
146742e30f05 Ensure LATE_PACKAGES_DIRECTORIES is a trivial search path.
Stephen J. Turnbull <stephen@xemacs.org>
parents: 4354
diff changeset
28 the packages by hand.
4354
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
29
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
30 To find out if a distribution includes bundled packages, type
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
31
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
32 make check-available-packages
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
33
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
34 There are three Make targets that may be available depending on the package
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
35 sets supplied.
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
36
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
37 make install-bootstrap-packages
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
38 Install a selected set of packages sufficient to support
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
39 downloading and installing packages via the M-x list-packages
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
40 interface. Chose this if you want to be able to install the
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
41 latest version of each package immediately.
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
42
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
43 make install-nomule-packages
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
44 Install the full distribution of packages that do not require a
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
45 Mule-enabled XEmacs. Choose this package if you don't have a
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
46 Mule-enabled XEmacs and want the convenience of a single-command
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
47 installation. You can add or update packages via M-x list-packages
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
48 at any time.
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
49
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
50 make install-all-packages
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
51 Install the full distribution of packages, including those requiring
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
52 a Mule-enabled XEmacs. Choose this package if you have a Mule-
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
53 enabled XEmacs and want the convenience of a single-command
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
54 installation. You can add or update packages via M-x list-packages
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
55 at any time.
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
56
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
57 DISTRIBUTOR'S NOTE: you may choose what packages you wish to include in
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
58 bootstrap.tar.gz, but to make list-packages work you need to include at
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
59 least xemacs-base, dired, and efs. The tarball should unpack directly as
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
60 an xemacs-packages tree (and optionaly, a mule-packages tree. Also, if
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
61 either of xemacs-sumo.tar.gz or xemacs-mule-sumo.tar.gz is provided, the
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
62 other should be as well.
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
63
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
64 If packages are not available with the distribution, you can get them at
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
65
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
66 ftp://ftp.xemacs.org/pub/xemacs/packages/xemacs-sumo.tar.gz
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
67 ftp://ftp.xemacs.org/pub/xemacs/packages/xemacs-mule-sumo.tar.gz
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
68 http://turnbull.sk.tsukuba.ac.jp/Tools/XEmacs/bootstrap.tar.gz
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
69
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
70 and place them in the same directory as this file. You can also make your
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
71 own bootstrap.tar.gz by creating a directory xemacs-packages, then
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
72 untarring the packages of your choice into that directory, and tarring the
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
73 whole thing up with "tar czf bootstrap.tar.gz xemacs-packages". (If you
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
74 wish to include mule-packages, you should place them in mule-packages as
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
75 a sibling of xemacs-packages.)
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
76
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
77 This facility currently does not support installations which configure
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
78 the --with-early-packages, --with-late-packages, or --with-last-packages
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
79 options.
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
80
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
81 This facility currently will not overwrite an existing package
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
82 installation, not even if a whole hierarchy (usually the mule-packages)
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
83 is missing. In particular, you cannot use this feature to add the
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
84 mule-packages to a package installation which lacks them, even if the
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
85 hierarchy is missing, or the xemacs-packages hierarchy was installed
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
86 this way. Nor can you "upgrade" a bootstrap installation to a full
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
87 installation. If you wish to do any of these things you will need to
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
88 remove the existing hierarchies.
232d873b9705 Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff changeset
89