annotate README.packages @ 826:6728e641994e

[xemacs-hg @ 2002-05-05 11:30:15 by ben] syntax cache, 8-bit-format, lots of code cleanup README.packages: Update info about --package-path. i.c: Create an inheritable event and pass it on to XEmacs, so that ^C can be handled properly. Intercept ^C and signal the event. "Stop Build" in VC++ now works. bytecomp-runtime.el: Doc string changes. compat.el: Some attempts to redo this to make it truly useful and fix the "multiple versions interacting with each other" problem. Not yet done. Currently doesn't work. files.el: Use with-obsolete-variable to avoid warnings in new revert-buffer code. xemacs.mak: Split up CFLAGS into a version without flags specifying the C library. The problem seems to be that minitar depends on zlib, which depends specifically on libc.lib, not on any of the other C libraries. Unless you compile with libc.lib, you get errors -- specifically, no _errno in the other libraries, which must make it something other than an int. (#### But this doesn't seem to obtain in XEmacs, which also uses zlib, and can be linked with any of the C libraries. Maybe zlib is used differently and doesn't need errno, or maybe XEmacs provides an int errno; ... I don't understand. Makefile.in.in: Fix so that packages are around when testing. abbrev.c, alloc.c, buffer.c, buffer.h, bytecode.c, callint.c, casefiddle.c, casetab.c, casetab.h, charset.h, chartab.c, chartab.h, cmds.c, console-msw.h, console-stream.c, console-x.c, console.c, console.h, data.c, device-msw.c, device.c, device.h, dialog-msw.c, dialog-x.c, dired-msw.c, dired.c, doc.c, doprnt.c, dumper.c, editfns.c, elhash.c, emacs.c, eval.c, event-Xt.c, event-gtk.c, event-msw.c, event-stream.c, events.c, events.h, extents.c, extents.h, faces.c, file-coding.c, file-coding.h, fileio.c, fns.c, font-lock.c, frame-gtk.c, frame-msw.c, frame-x.c, frame.c, frame.h, glade.c, glyphs-gtk.c, glyphs-msw.c, glyphs-msw.h, glyphs-x.c, glyphs.c, glyphs.h, gui-msw.c, gui-x.c, gui.h, gutter.h, hash.h, indent.c, insdel.c, intl-win32.c, intl.c, keymap.c, lisp-disunion.h, lisp-union.h, lisp.h, lread.c, lrecord.h, lstream.c, lstream.h, marker.c, menubar-gtk.c, menubar-msw.c, menubar-x.c, menubar.c, minibuf.c, mule-ccl.c, mule-charset.c, mule-coding.c, mule-wnnfns.c, nas.c, objects-msw.c, objects-x.c, opaque.c, postgresql.c, print.c, process-nt.c, process-unix.c, process.c, process.h, profile.c, rangetab.c, redisplay-gtk.c, redisplay-msw.c, redisplay-output.c, redisplay-x.c, redisplay.c, redisplay.h, regex.c, regex.h, scrollbar-msw.c, search.c, select-x.c, specifier.c, specifier.h, symbols.c, symsinit.h, syntax.c, syntax.h, syswindows.h, tests.c, text.c, text.h, tooltalk.c, ui-byhand.c, ui-gtk.c, unicode.c, win32.c, window.c: Another big Ben patch. -- FUNCTIONALITY CHANGES: add partial support for 8-bit-fixed, 16-bit-fixed, and 32-bit-fixed formats. not quite done yet. (in particular, needs functions to actually convert the buffer.) NOTE: lots of changes to regex.c here. also, many new *_fmt() inline funs that take an Internal_Format argument. redo syntax cache code. make the cache per-buffer; keep the cache valid across calls to functions that use it. also keep it valid across insertions/deletions and extent changes, as much as is possible. eliminate the junky regex-reentrancy code by passing in the relevant lisp info to the regex routines as local vars. add general mechanism in extents code for signalling extent changes. fix numerous problems with the case-table implementation; yoshiki never properly transferred many algorithms from old-style to new-style case tables. redo char tables to support a default argument, so that mapping only occurs over changed args. change many chartab functions to accept Lisp_Object instead of Lisp_Char_Table *. comment out the code in font-lock.c by default, because font-lock.el no longer uses it. we should consider eliminating it entirely. Don't output bell as ^G in console-stream when not a TTY. add -mswindows-termination-handle to interface with i.c, so we can properly kill a build. add more error-checking to buffer/string macros. add some additional buffer_or_string_() funs. -- INTERFACE CHANGES AFFECTING MORE CODE: switch the arguments of write_c_string and friends to be consistent with write_fmt_string, which must have printcharfun first. change BI_* macros to BYTE_* for increased clarity; similarly for bi_* local vars. change VOID_TO_LISP to be a one-argument function. eliminate no-longer-needed CVOID_TO_LISP. -- char/string macro changes: rename MAKE_CHAR() to make_emchar() for slightly less confusion with make_char(). (The former generates an Emchar, the latter a Lisp object. Conceivably we should rename make_char() -> wrap_char() and similarly for make_int(), make_float().) Similar changes for other *CHAR* macros -- we now consistently use names with `emchar' whenever we are working with Emchars. Any remaining name with just `char' always refers to a Lisp object. rename macros with XSTRING_* to string_* except for those that reference actual fields in the Lisp_String object, following conventions used elsewhere. rename set_string_{data,length} macros (the only ones to work with a Lisp_String_* instead of a Lisp_Object) to set_lispstringp_* to make the difference clear. try to be consistent about caps vs. lowercase in macro/inline-fun names for chars and such, which wasn't the case before. we now reserve caps either for XFOO_ macros that reference object fields (e.g. XSTRING_DATA) or for things that have non-function semantics, e.g. directly modifying an arg (BREAKUP_EMCHAR) or evaluating an arg (any arg) more than once. otherwise, use lowercase. here is a summary of most of the macros/inline funs changed by all of the above changes: BYTE_*_P -> byte_*_p XSTRING_BYTE -> string_byte set_string_data/length -> set_lispstringp_data/length XSTRING_CHAR_LENGTH -> string_char_length XSTRING_CHAR -> string_emchar INTBYTE_FIRST_BYTE_P -> intbyte_first_byte_p INTBYTE_LEADING_BYTE_P -> intbyte_leading_byte_p charptr_copy_char -> charptr_copy_emchar LEADING_BYTE_* -> leading_byte_* CHAR_* -> EMCHAR_* *_CHAR_* -> *_EMCHAR_* *_CHAR -> *_EMCHAR CHARSET_BY_ -> charset_by_* BYTE_SHIFT_JIS* -> byte_shift_jis* BYTE_BIG5* -> byte_big5* REP_BYTES_BY_FIRST_BYTE -> rep_bytes_by_first_byte char_to_unicode -> emchar_to_unicode valid_char_p -> valid_emchar_p Change intbyte_strcmp -> qxestrcmp_c (duplicated functionality). -- INTERFACE CHANGES AFFECTING LESS CODE: use DECLARE_INLINE_HEADER in various places. remove '#ifdef emacs' from XEmacs-only files. eliminate CHAR_TABLE_VALUE(), which duplicated the functionality of get_char_table(). add BUFFER_TEXT_LOOP to simplify iterations over buffer text. define typedefs for signed and unsigned types of fixed sizes (INT_32_BIT, UINT_32_BIT, etc.). create ALIGN_FOR_TYPE as a higher-level interface onto ALIGN_SIZE; fix code to use it. add charptr_emchar_len to return the text length of the character pointed to by a ptr; use it in place of charcount_to_bytecount(..., 1). add emchar_len to return the text length of a given character. add types Bytexpos and Charxpos to generalize Bytebpos/Bytecount and Charbpos/Charcount, in code (particularly, the extents code and redisplay code) that works with either kind of index. rename redisplay struct params with names such as `charbpos' to e.g. `charpos' when they are e.g. a Charxpos, not a Charbpos. eliminate xxDEFUN in place of DEFUN; no longer necessary with changes awhile back to doc.c. split up big ugly combined list of EXFUNs in lisp.h on a file-by-file basis, since other prototypes are similarly split. rewrite some "*_UNSAFE" macros as inline funs and eliminate the _UNSAFE suffix. move most string code from lisp.h to text.h; the string code and text.h code is now intertwined in such a fashion that they need to be in the same place and partially interleaved. (you can't create forward references for inline funs) automated/lisp-tests.el, automated/symbol-tests.el, automated/test-harness.el: Fix test harness to output FAIL messages to stderr when in batch mode. Fix up some problems in lisp-tests/symbol-tests that were causing spurious failures.
author ben
date Sun, 05 May 2002 11:33:57 +0000
parents e7ef97881643
children 712931b4b71d
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
1 -*- Outline -*-
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
2 This file is in Outline mode. It is best viewed under XEmacs.
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
3
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
4 Press C-c C-o (Ctrl+c Ctrl+o) now to see a list of headings.
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
5 To expand a heading: Put the cursor on the heading and press C-c C-s
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
6 To collapse a heading: Press C-c C-d
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
7
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
8 For general XEmacs navigation tips: Press C-h t
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
9
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
10 The XEmacs Packages Quick Start Guide
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
11 -------------------------------------
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
12
826
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
13 This text is intended to help you get started installing a new XEmacs and
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
14 its packages. For more details see the 'Startup Paths' and 'Packages'
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
15 sections of the XEmacs info manual.
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
16
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
17 * Real Real Quickstart FAQ
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
18 --------------------------
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
19
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
20 Q. Do I need to have the packages to compile XEmacs?
826
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
21
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
22 A. Theoretically, no -- XEmacs will build and install just fine without any
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
23 packages installed. However, only the most basic editing functions will
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
24 be available with no packages installed, so installing packages is an
438
84b14dcb0985 Import from CVS: tag r21-2-27
cvs
parents: 424
diff changeset
25 essential part of making your installed XEmacs _useful_.
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
26
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
27 Q. I really liked the old way that packages were bundled and do not
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
28 want to mess with packages at all.
826
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
29
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
30 A. You can grab all the packages at once like you used to with old
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
31 XEmacs versions, skip to the 'Sumo Tarball' section below.
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
32
826
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
33 Q. How do I tell XEmacs where to find the packages?
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
34
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
35 A. Normally, you put the packages under $prefix/lib/packages, where
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
36 $prefix is specified using the `--prefix' parameter to `configure'.
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
37 (See `Package hierarchies' below). However, if you have the packages
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
38 somewhere else (e.g. you're a developer and are compiling the packages
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
39 yourself, and want your own private copy of everything), use the
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
40 `--package-path' parameter, something like this:
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
41
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
42 configure --package-path="~/.xemacs::/src/xemacs/site-packages:/src/xemacs/xemacs-packages:/src/xemacs/mule-packages" ...
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
43
444
576fb035e263 Import from CVS: tag r21-2-37
cvs
parents: 438
diff changeset
44 Q. After installing, I want XEmacs to do `foo', but when I invoke it
576fb035e263 Import from CVS: tag r21-2-37
cvs
parents: 438
diff changeset
45 (or click the toolbar button or select the menu item), nothing (or
576fb035e263 Import from CVS: tag r21-2-37
cvs
parents: 438
diff changeset
46 an error) happens, and it used to work.
826
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
47
444
576fb035e263 Import from CVS: tag r21-2-37
cvs
parents: 438
diff changeset
48 A. See the first FAQ; you may be missing a package that is essential to
576fb035e263 Import from CVS: tag r21-2-37
cvs
parents: 438
diff changeset
49 you. You can either track it down and install it, or install the
576fb035e263 Import from CVS: tag r21-2-37
cvs
parents: 438
diff changeset
50 `Sumo Tarball' (see the second FAQ).
576fb035e263 Import from CVS: tag r21-2-37
cvs
parents: 438
diff changeset
51
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
52 * A note of caution
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
53 -------------------
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
54
438
84b14dcb0985 Import from CVS: tag r21-2-27
cvs
parents: 424
diff changeset
55 The XEmacs package system is still in its infancy. Please expect a few
84b14dcb0985 Import from CVS: tag r21-2-27
cvs
parents: 424
diff changeset
56 minor hurdles on the way. Also neither the interface nor the structure is
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
57 set in stone. The XEmacs maintainers reserve the right to sacrifice
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
58 backwards compatibility as quirks are worked out over the coming
438
84b14dcb0985 Import from CVS: tag r21-2-27
cvs
parents: 424
diff changeset
59 releases.
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
60
826
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
61 * Some package theory
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
62 ---------------------
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
63
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
64 In order to reduce the size and increase the maintainability of XEmacs,
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
65 the majority of the Elisp packages that came with previous releases
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
66 have been unbundled. They have been replaced by the package system.
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
67 Each elisp add-on (or groups of them when they are small) now comes
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
68 in its own tarball that contains a small search hierarchy.
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
69
438
84b14dcb0985 Import from CVS: tag r21-2-27
cvs
parents: 424
diff changeset
70 You select just the ones you need. Install them by untarring them into
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
71 the right place. On startup XEmacs will find them, set up the load
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
72 path correctly, install autoloads, etc, etc.
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
73
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
74 * Package hierarchies
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
75 ---------------------
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
76
826
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
77 On Startup XEmacs looks for packages in so-called package hierarchies.
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
78 Normally, there are three system wide hierarchies, like this:
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
79
826
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
80 $prefix/lib/xemacs/xemacs-packages/
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
81 Normal packages go here.
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
82
826
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
83 $prefix/lib/xemacs/mule-packages/
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
84 Mule packages go here and are only searched by MULE-enabled XEmacsen.
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
85
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
86 $prefix/lib/xemacs/site-packages/
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
87 Local and 3rd party packages go here.
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
88
826
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
89 This is what you get when you untar the SUMO tarballs under
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
90 $prefix/lib/xemacs.
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
91
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
92 $prefix is specified using the `--prefix' parameter to `configure', and
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
93 defaults to `usr/local'.
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
94
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
95 If your packages are located in the above directories, XEmacs will
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
96 automatically find them at startup; however, if you have your packages
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
97 somewhere else (e.g. you're a developer and are compiling the packages
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
98 yourself, and want your own private copy of everything), you can tell
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
99 XEmacs specifically where to look for the packages by using the
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
100 `--package-path' parameter to the 'configure' script. Normally, it looks
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
101 like this:
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
102
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
103 configure --package-path="~/.xemacs::/src/xemacs/site-packages:/src/xemacs/xemacs-packages:/src/xemacs/mule-packages" ...
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
104
6728e641994e [xemacs-hg @ 2002-05-05 11:30:15 by ben]
ben
parents: 456
diff changeset
105 See `configure.usage' for more info about the format of this parameter.
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
106
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
107 * Where to get the packages
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
108 ---------------------------
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
109
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
110 Packages are available from ftp://ftp.xemacs.org/pub/xemacs/packages
438
84b14dcb0985 Import from CVS: tag r21-2-27
cvs
parents: 424
diff changeset
111 and its mirrors.
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
112
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
113 * How to install the packages
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
114 -----------------------------
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
115 There are a few different ways to install packages:
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
116
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
117 1. Manually, all at once, using the 'Sumo Tarball'.
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
118 2. Manually, using individual package tarballs.
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
119 3. Automatically, using the package tools from XEmacs.
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
120
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
121 ** Manually, all at once, using the 'Sumo Tarball'
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
122 --------------------------------------------------
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
123
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
124 Those with little time, cheap connections and plenty of disk space can
438
84b14dcb0985 Import from CVS: tag r21-2-27
cvs
parents: 424
diff changeset
125 install all the packages at once using the sumo tarballs.
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
126 Download the file:
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
127
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
128 xemacs-sumo.tar.gz
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
129
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
130 For an XEmacs compiled with Mule you also need:
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
131
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
132 xemacs-mule-sumo.tar.gz
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
133
333
4f79e16b1112 Import from CVS: tag r21-0-64
cvs
parents: 331
diff changeset
134 N.B. They are called 'Sumo Tarballs' for good reason. They are
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
135 currently about 19MB and 4.5MB (gzipped) respectively.
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
136
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
137 Install them by:
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
138
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
139 cd $prefix/lib/xemacs ; gunzip -c <tarballname> | tar xvf - RET
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
140
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
141 Or, if you have GNU tar:
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
142
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
143 cd $prefix/lib/xemacs ; tar zxvf /path/to/<tarballname> RET
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
144
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
145 As the Sumo tarballs are not regenerated as often as the individual
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
146 packages, it is recommended that you use the automatic package tools
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
147 afterwards to pick up any recent updates.
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
148
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
149 ** Manually, using individual package tarballs
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
150 ----------------------------------------------
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
151
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
152 Fetch the packages from the FTP site, CD-ROM whatever. The filenames
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
153 have the form name-<version>-pkg.tar.gz and are gzipped tar files. For
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
154 a fresh install it is sufficient to untar the file at the top of the
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
155 package hierarchy.
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
156
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
157 Note: If you are upgrading packages already installed, it's best to
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
158 remove the old package first (see 'Upgrading/Removing Packages' below).
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
159
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
160 For example if we are installing the 'xemacs-base'
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
161 package (version 1.48):
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
162
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
163 mkdir $prefix/lib/xemacs/xemacs-packages RET # if it does not exist yet
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
164 cd $prefix/lib/xemacs/xemacs-packages RET
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
165 gunzip -c /path/to/xemacs-base-1.48-pkg.tar.gz | tar xvf - RET
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
166
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
167 Or if you have GNU tar, the last step can be:
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
168
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
169 tar zxvf /path/to/xemacs-base-1.48-pkg.tar.gz RET
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
170
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
171 For MULE related packages, it is best to untar into the mule-packages
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
172 hierarchy, i.e. for the mule-base package, version 1.37:
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
173
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
174 mkdir $prefix/lib/xemacs/mule-packages RET # if it does not exist yet
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
175 cd $prefix/lib/xemacs/mule-packages RET
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
176 gunzip -c /path/to/mule-base-1.37-pkg.tar.gz | tar xvf - RET
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
177
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
178 Or if you have GNU tar, the last step can be:
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
179
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
180 tar zxvf /path/to/mule-base-1.37-pkg.tar.gz RET
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
181
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
182
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
183 ** Automatically, using the package tools from XEmacs
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
184 -----------------------------------------------------
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
185
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
186 XEmacs comes with some tools to make the periodic updating and
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
187 installing easier. It will notice if new packages or versions are
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
188 available and will fetch them from the FTP site.
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
189
438
84b14dcb0985 Import from CVS: tag r21-2-27
cvs
parents: 424
diff changeset
190 Unfortunately this requires that a few packages are already in place.
84b14dcb0985 Import from CVS: tag r21-2-27
cvs
parents: 424
diff changeset
191 You will have to install them by hand as above or use a SUMO tarball.
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
192 This requirement will hopefully go away in the future. The packages
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
193 you need are:
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
194
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
195 efs - To fetch the files from the FTP site or mirrors.
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
196 xemacs-base - Needed by efs.
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
197
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
198 and optionally:
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
199
438
84b14dcb0985 Import from CVS: tag r21-2-27
cvs
parents: 424
diff changeset
200 mule-base - Needed if you want to use XEmacs with MULE.
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
201
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
202 After installing these by hand, fire up XEmacs and follow these
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
203 steps.
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
204
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
205 Note: The menus in XEmacs 21.2.x and up have changed slightly, so
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
206 where I mention "Options -> Manage Packages", substitute "Tools ->
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
207 Packages".
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
208
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
209 (1) Choose a download site.
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
210 - via menu: Options -> Manages Packages -> Add Download Site
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
211 - via keyb: M-x customize-variable RET package-get-remote RET
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
212 (put in the details of remote host and directory)
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
213
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
214 If the package tarballs _AND_ the package-index file are in a
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
215 local directory, you can: M-x pui-add-install-directory RET
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
216
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
217 (2) Obtain a list of packages and display the list in a buffer named
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
218 "*Packages*".
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
219 - menu: Options -> Manage Packages -> List & Install
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
220 - keyb: M-x pui-list-packages RET
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
221
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
222 XEmacs will now connect to the remote site and download the
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
223 latest package-index file. If you see an error about the
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
224 package-index entries not being PGP signed, you can safely
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
225 ignore this because PGP has not been integrated into the XEmacs
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
226 package tools yet.
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
227
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
228 The resulting buffer, "*Packages*" has brief instructions at the
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
229 end of the buffer.
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
230
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
231 (3) Choose the packages you wish to install.
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
232 - mouse: Click button 2 on the package name.
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
233 - keyb: RET on the package name
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
234
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
235 (4) Make sure you have everything you need.
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
236 - menu: Packages -> Add Required
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
237 - keyb: r
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
238
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
239 XEmacs will now search for packages that are required by the
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
240 ones that you have chosen to install and offer to select
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
241 those packages also.
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
242
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
243 For novices and gurus alike, this step can save your bacon.
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
244 It's easy to forget to install a critical package.
438
84b14dcb0985 Import from CVS: tag r21-2-27
cvs
parents: 424
diff changeset
245
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
246 (5) Download and install the packages.
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
247 - menu: Packages -> Install/Remove Selected
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
248 - keyb: x
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
249
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
250 * After Installation
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
251 --------------------
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
252
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
253 New packages can only be used by XEmacs after a restart.
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
254
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
255 * Which Packages to install?
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
256 ----------------------------
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
257
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
258 This is difficult to say. When in doubt install a package. If you
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
259 administrate a big site it might be a good idea to just install
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
260 everything. A good minimal set of packages for XEmacs-latin1 would be
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
261
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
262 xemacs-base, xemacs-devel, c-support, cc-mode, debug, dired, efs,
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
263 edit-utils, fsf-compat, mail-lib, net-utils, os-utils, prog-modes,
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
264 text-modes, time
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
265
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
266 If you are using the XEmacs package tools, don't forget to do:
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
267
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
268 Packages -> Add Required
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
269
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
270 To make sure you have everything that the packages you have chosen to
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
271 install need.
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
272
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
273 See also '.../etc/PACKAGES' for further descriptions of the individual
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
274 packages.
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
275
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
276 * Upgrading/Removing Packages
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
277 -----------------------------
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
278
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
279 As the exact files and their locations contained in a package may
438
84b14dcb0985 Import from CVS: tag r21-2-27
cvs
parents: 424
diff changeset
280 change it is recommended to remove a package first before installing a
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
281 new version. In order to facilitate removal each package contains an
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
282 pgkinfo/MANIFEST.pkgname file which list all the files belong to the
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
283 package. M-x package-admin-delete-binary-package RET can be used to
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
284 remove a package using this file.
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
285
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
286 Note that the interactive package tools included with XEmacs already do
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
287 this for you.
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
288
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
289 * User Package directories
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
290 --------------------------
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
291
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
292 In addition to the system wide packages, each user can have his own
420
41dbb7a9d5f2 Import from CVS: tag r21-2-18
cvs
parents: 414
diff changeset
293 packages installed in "~/.xemacs/xemacs-packages". If you want to
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
294 install packages there using the interactive tools, you need to set
420
41dbb7a9d5f2 Import from CVS: tag r21-2-18
cvs
parents: 414
diff changeset
295 'pui-package-install-dest-dir' to "~/.xemacs/xemacs-packages"
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
296
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
297 * Site lisp/Site start
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
298 ----------------------
331
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
299
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
300 The site-packages hierarchy replaces the old 'site-lisp' directory.
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
301 XEmacs no longer looks into a 'site-lisp' directly by default.
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
302 A good place to put 'site-start.el' would be in
c9ae480b1fff Import from CVS: tag r21-0-63
cvs
parents:
diff changeset
303 $prefix/lib/xemacs/site-packages/lisp/
424
11054d720c21 Import from CVS: tag r21-2-20
cvs
parents: 420
diff changeset
304
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
305 * Finding the right packages
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
306 ----------------------------
424
11054d720c21 Import from CVS: tag r21-2-20
cvs
parents: 420
diff changeset
307
11054d720c21 Import from CVS: tag r21-2-20
cvs
parents: 420
diff changeset
308 If you want to find out which package contains the functionality you
11054d720c21 Import from CVS: tag r21-2-20
cvs
parents: 420
diff changeset
309 are looking for, use M-x package-get-package-provider, and give it a
456
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
310 symbol that is likely to be in that package.
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
311
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
312 For example, if some code you want to use has a (require 'thingatpt)
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
313 in it:
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
314
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
315 M-x package-get-package-provider RET thingatpt RET
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
316
e7ef97881643 Import from CVS: tag r21-2-43
cvs
parents: 444
diff changeset
317 which will return something like: (fsf-compat "1.08").