Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 107 lines (77 sloc) 4.037 kB
37de9cb @rgmorris Add 2009 to copyright years.
rgmorris authored
1 Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009
3d1069a @rgmorris Add copyright and permissions notices.
rgmorris authored
2 Free Software Foundation, Inc.
5b18429 @rgmorris Switch to standard GPL text for license.
rgmorris authored
3 See the end of the file for license conditions.
3d1069a @rgmorris Add copyright and permissions notices.
rgmorris authored
4
5
3274fe9 New file.
Eli Zaretskii authored
6 Building and Installing Emacs from CVS
7
52f55c7 @jurta Move configuration explicitly to the first step.
jurta authored
8 If this is the first time you go through it, you'll need to configure
9 before bootstrapping:
10
11 $ ./configure
12
3274fe9 New file.
Eli Zaretskii authored
13 Some of the files that are included in the Emacs tarball, such as
14 byte-compiled Lisp files, are not stored in the CVS repository.
15 Therefore, to build from CVS you must run "make bootstrap"
16 instead of just "make":
17
0fdfdbf @rgmorris There is no reason to not use the `-dP' options to `cvs update' every…
rgmorris authored
18 $ cvs update -dP
3274fe9 New file.
Eli Zaretskii authored
19 $ make bootstrap
20
21 Normally, it is not necessary to use "make bootstrap" after every CVS
56fdde2 * src/Makefile.in (emacs${EXEEXT}): Depend on the machine-specific fi…
Stefan Monnier authored
22 update. "make" should work in 90% of the cases and be much quicker.
3274fe9 New file.
Eli Zaretskii authored
23
24 $ make
25
26 (If you want to install the Emacs binary, type "make install" instead
27 of "make" in the last command.)
28
686c89e @rgmorris loaddefs are always fully regenerated on bootstrapping.
rgmorris authored
29 Occasionally the file "lisp/loaddefs.el" (and similar automatically
30 generated files, such as esh-groups.el, and *-loaddefs.el in some
31 subdirectories of lisp/, e.g. mh-e/ and calendar/) will need to be
32 updated to reflect new autoloaded functions. If you see errors (rather
33 than warnings) about undefined lisp functions during compilation, that
34 may be the reason. Another symptom may be an error saying that
35 "loaddefs.el" could not be found; this is due to a change in the way
36 loaddefs.el was handled in CVS, and should only happen once, for users
37 that are updating old CVS trees. Finally, sometimes there can be build
38 failures related to *loaddefs.el (e.g. "required feature `esh-groups'
39 was not provided"). In that case, follow the instructions below.
1f2fa82 @rgmorris Improve previous change.
rgmorris authored
40
41 To update loaddefs.el (and similar files), do:
66c407a @snogglethorpe Revision: miles@gnu.org--gnu-2003/emacs--cvs-trunk--0--patch-69
snogglethorpe authored
42
43 $ cd lisp
632981b @rgmorris Remove references to passing EMACS to make, since the defaults are
rgmorris authored
44 $ make autoloads
66c407a @snogglethorpe Revision: miles@gnu.org--gnu-2003/emacs--cvs-trunk--0--patch-69
snogglethorpe authored
45
7882b07 Add mh-autoloads to the partial rebuild procedure.
Eli Zaretskii authored
46 If either of the above partial procedures fails, try "make bootstrap".
dec86c4 @rgmorris Don't mention maintainer-clean, since `make bootstrap' does this now.
rgmorris authored
47 If CPU time is not an issue, the most thorough way to rebuild, and
48 avoid any spurious problems, is always to use this method.
c942b50 @rgmorris Mention deleting loaddefs, maintainer-clean.
rgmorris authored
49
3274fe9 New file.
Eli Zaretskii authored
50 Users of non-Posix systems (MS-Windows etc.) should run the
51 platform-specific configuration scripts (nt/configure.bat, config.bat,
52 etc.) before "make bootstrap" or "make"; the rest of the procedure is
632981b @rgmorris Remove references to passing EMACS to make, since the defaults are
rgmorris authored
53 applicable to those systems as well.
3274fe9 New file.
Eli Zaretskii authored
54
b87ed81 @monnier *** empty log message ***
monnier authored
55 Questions, requests, and bug reports about the CVS versions of Emacs
320f199 @monnier Clear up the last paragraph.
monnier authored
56 should be sent to emacs-pretest-bug@gnu.org rather than gnu.emacs.help
57 or gnu.emacs.bug. Ideally, use M-x report-emacs-bug RET which will
58 send it to the proper place.
8dc4c1d Add info about ssh/cvs related problems and work-around.
Kim F. Storm authored
59
f252778 @rgmorris A plea for fewer "it doesn't build" messages.
rgmorris authored
60 Because the CVS version of Emacs is a work in progress, it will
61 sometimes fail to build. Please wait a day or so (and check the bug
62 and development mailing list archives) before reporting such problems.
63 In most cases, the problem is known about and is just waiting for
64 someone to fix it.
65
8dc4c1d Add info about ssh/cvs related problems and work-around.
Kim F. Storm authored
66
4398e6f @monnier *** empty log message ***
monnier authored
67 Note on using SSH to access the CVS repository from inside Emacs
8dc4c1d Add info about ssh/cvs related problems and work-around.
Kim F. Storm authored
68 ----------------------------------------------------------------
69
70 Write access to the CVS repository requires using SSH v2.
71
4398e6f @monnier *** empty log message ***
monnier authored
72 If you execute cvs commands inside Emacs, specifically if you use
8dc4c1d Add info about ssh/cvs related problems and work-around.
Kim F. Storm authored
73 pcl-cvs, output from CVS may be lost due to a problem in the
ec9fb7e Corrupted checkins are known to have happened.
Kim F. Storm authored
74 interface between ssh, cvs, and libc. Corrupted checkins are
75 also known to have happened.
8dc4c1d Add info about ssh/cvs related problems and work-around.
Kim F. Storm authored
76
77 To fix the problem, save the following script into a file, make it
78 executable, and set CVS_RSH to the file name of the script:
79
80 #!/bin/bash
81 exec 2> >(exec cat >&2 2>/dev/null)
82 exec ssh "$@"
83
84 This may be combined with the following entry in ~/.ssh/config to
85 simplify accessing the CVS repository:
86
87 Host subversions.gnu.org
88 Protocol 2
89 ForwardX11 no
90 User YOUR_USERID
5b18429 @rgmorris Switch to standard GPL text for license.
rgmorris authored
91
92
93 This file is part of GNU Emacs.
94
4ae94cf @rgmorris Switch to recommended form of GPLv3 permissions notice.
rgmorris authored
95 GNU Emacs is free software: you can redistribute it and/or modify
5b18429 @rgmorris Switch to standard GPL text for license.
rgmorris authored
96 it under the terms of the GNU General Public License as published by
4ae94cf @rgmorris Switch to recommended form of GPLv3 permissions notice.
rgmorris authored
97 the Free Software Foundation, either version 3 of the License, or
98 (at your option) any later version.
5b18429 @rgmorris Switch to standard GPL text for license.
rgmorris authored
99
100 GNU Emacs is distributed in the hope that it will be useful,
101 but WITHOUT ANY WARRANTY; without even the implied warranty of
102 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
103 GNU General Public License for more details.
104
105 You should have received a copy of the GNU General Public License
4ae94cf @rgmorris Switch to recommended form of GPLv3 permissions notice.
rgmorris authored
106 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
Something went wrong with that request. Please try again.