annotate lisp/ediff/README @ 70:131b0175ea99 r20-0b30

Import from CVS: tag r20-0b30
author cvs
date Mon, 13 Aug 2007 09:02:59 +0200
parents 0293115a14e9
children c7528f8e288d
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
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
3 **** This version of Ediff requires *at least* Emacs 19.30 or XEmacs 19.14
0
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
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
10 ediff.info* -- The Info files
0
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
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
58 For manual installation, copy ediff*.elc into a directory on your load-path.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
59
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
60 For more details, read documentation at the beginning of the file ediff.el
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
61
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
62 To install on-line documentation, you need to install the Info files
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
63 by copying
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
64
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
65 ediff.info*
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
66
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
67 into your Info directory (which is emacs-root-dir/info,
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
68 if emacs-root-dir is the root directory of the installation).
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
69
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
70 Then edit the file
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
71
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
72 emacs-root-dir/info/dir
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
73
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
74 to include the root menu item for Ediff (check how other menu
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
75 items look like in this file).
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
76
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
77 In Emacs, this item should look like this:
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
78
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
79 * Ediff: (ediff.info). A Visual Interface to Unix Diff and Patch Utilities
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
80
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
81 In XEmacs, it looks like:
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
82
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
83 * Ediff:: A Visual Interface to Unix Diff and Patch Utilities
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
84
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
85
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
86 Normally, all Ediff menus and autoloads are already defined in Emacs, so u
0
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
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
89 new features, you may have to put
0
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
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
94 Ediff, but readies it for any taks u assign to it. When this version of
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 16
diff changeset
95 Ediff gets installed in the standard Emacs distribution, you may remove
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
96 the above require-statement (but leaving it in does no harm).