annotate lisp/ediff/README @ 0:376386a54a3c r19-14

Import from CVS: tag r19-14
author cvs
date Mon, 13 Aug 2007 08:45:50 +0200
parents
children bcdc7deadc19
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1 **** EDIFF -- a comprehensive interface to diff for Emacs 19 and XEmacs 19
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3 **** This version of Ediff requires *at least* Emacs 19.30 or XEmacs 19.14
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
4
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
5 This directory:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
6
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
7 README -- This file
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
8 Makefile -- Automated installation file
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
9 ediff.texi -- Manual in Texinfo format
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
10 ediff.info* -- The Info files
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
11 ediff.dvi -- Manual in DVI format
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
12
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
13 ediff.el -- Ediff Emacs Lisp code
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
14 ediff-init.el -- Ediff Emacs Lisp code
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
15 ediff-wind.el -- Ediff Emacs Lisp code
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
16 ediff-util.el -- Ediff Emacs Lisp code
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
17 ediff-diff.el -- Ediff Emacs Lisp code
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
18 ediff-merg.el -- Ediff Emacs Lisp code
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
19 ediff-mult.el -- Ediff Emacs Lisp code
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
20 ediff-vers.el -- Ediff Emacs Lisp code
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
21 ediff-ptch.el -- Ediff Emacs Lisp code
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
22 ediff-hook.el -- Ediff Emacs Lisp code
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
23
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
24
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
25 To install Ediff do:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
26
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
27 uncompress ediff.tar.Z
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
28 tar xf ediff.tar
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
29
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
30
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
31 Then do the following:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
32
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
33 1. To compile Lisp:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
34
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
35 make (or 'make all')
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
36
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
37 2. You can also type
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
38
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
39 make install
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
40
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
41 to do what "make all" does plus it will copy the files ediff*.elc
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
42 into a suitable Lisp directory.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
43
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
44 To make this happen, you will most likely have to change the PREFIX
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
45 variable in Makefile and, possibly, one or more of these variables:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
46
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
47 DATADIR, LISPDIR, INFODIR, ETCDIR, and VERSION
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
48
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
49 if they don't point to the right directories in your installation.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
50 You also need to have a write permission for all directories
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
51 mentioned in LISPDIR, INFODIR, and ETCDIR.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
52
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
53 3. XEmacs users must invoke `make' with the parameter EMACS=xemacs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
54 or whatever name is used to invoke XEmacs (some sites still use xemacs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
55 for Emacs 18). An even better thing would be to edit Makefile directly
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
56 as indicated in the comments there.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
57
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
58 For manual installation, copy ediff*.elc into a directory on your load-path.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
59
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
60 For more details, read documentation at the beginning of the file ediff.el
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
61
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
62 To install on-line documentation, you need to install the Info files
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
63 by copying
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
64
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
65 ediff.info*
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
66
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
67 into your Info directory (which is emacs-root-dir/info,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
68 if emacs-root-dir is the root directory of the installation).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
69
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
70 Then edit the file
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
71
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
72 emacs-root-dir/info/dir
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
73
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
74 to include the root menu item for Ediff (check how other menu
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
75 items look like in this file).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
76
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
77 In Emacs, this item should look like this:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
78
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
79 * Ediff: (ediff.info). A Visual Interface to Unix Diff and Patch Utilities
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
80
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
81 In XEmacs, it looks like:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
82
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
83 * Ediff:: A Visual Interface to Unix Diff and Patch Utilities
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
84
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
85
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
86 Normally, all Ediff menus and autoloads are already defined in Emacs, so u
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
87 don't need to define anything in your .emacs to run Ediff.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
88 However, if it was announced that this distribution of Ediff contains
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
89 new features, you may have to put
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
90
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
91 (require 'ediff-hook)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
92
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
93 in your .emacs to take advantage of these new features. This doesn't load
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
94 Ediff, but readies it for any taks u assign to it. When this version of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
95 Ediff gets installed in the standard Emacs distribution, you may remove
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
96 the above require-statement (but leaving it in does no harm).