aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPaul Eggert2019-05-03 13:58:09 -0700
committerPaul Eggert2019-05-03 14:54:38 -0700
commitdae48faec640bba57a42c1a81cc0ab6703a2ddbd (patch)
tree0def7bc0f135866faccbb35c96076c522b6f396a
parent6caf9be6cacad2da36f2a1303304df588325d38b (diff)
downloademacs-dae48faec640bba57a42c1a81cc0ab6703a2ddbd.tar.gz
emacs-dae48faec640bba57a42c1a81cc0ab6703a2ddbd.zip
Modernize INSTALL a bit
* INSTALL: Omit filesystem space estimates. These estimates were (1) wrong and (2) no longer important nowadays, as people have plenty of space. Instead, start with how to get and unpack an Emacs tarball. Don’t say "disk" as it’s often not disk nowadays. Update URLs.
-rw-r--r--INSTALL33
1 files changed, 17 insertions, 16 deletions
diff --git a/INSTALL b/INSTALL
index 80223850100..e38635c60b7 100644
--- a/INSTALL
+++ b/INSTALL
@@ -34,11 +34,12 @@ some of the steps manually. The more detailed description in the other
34sections of this guide will help you do that, so please refer to those 34sections of this guide will help you do that, so please refer to those
35sections if you need to. 35sections if you need to.
36 36
37 1. Unpacking the Emacs release requires about 200 MB of free 37 1. Obtain and unpack the Emacs release, with commands like this:
38 disk space. Building Emacs uses about another 200 MB of space. 38
39 The final installed Emacs uses about 150 MB of disk space. 39 wget https://ftp.gnu.org/gnu/emacs/emacs-VERSION.tar.xz
40 This includes the space-saving that comes from automatically 40 tar -xf emacs-VERSION.tar.xz
41 compressing the Lisp source files on installation. 41
42 where VERSION is the Emacs version number.
42 43
43 2a. 'cd' to the directory where you unpacked Emacs and invoke the 44 2a. 'cd' to the directory where you unpacked Emacs and invoke the
44 'configure' script: 45 'configure' script:
@@ -87,7 +88,7 @@ sections if you need to.
87 88
88 make install 89 make install
89 90
90 You are now ready to use Emacs. If you wish to conserve disk space, 91 You are now ready to use Emacs. If you wish to conserve space,
91 you may remove the program binaries and object files from the 92 you may remove the program binaries and object files from the
92 directory where you built Emacs: 93 directory where you built Emacs:
93 94
@@ -118,7 +119,7 @@ packages. Note that if there is a separate 'dev' or 'devel' package,
118for use at compilation time rather than run time, you will need that 119for use at compilation time rather than run time, you will need that
119as well as the corresponding run time package; typically the dev 120as well as the corresponding run time package; typically the dev
120package will contain header files and a library archive. Otherwise, 121package will contain header files and a library archive. Otherwise,
121you can download the libraries from <http://www.nongnu.org/m17n/>. 122you can download the libraries from <https://www.nongnu.org/m17n/>.
122 123
123Note that Emacs cannot support complex scripts on a TTY, unless the 124Note that Emacs cannot support complex scripts on a TTY, unless the
124terminal includes such a support. 125terminal includes such a support.
@@ -162,14 +163,14 @@ can be found (in the unlikely event that your distribution does not
162provide them). By default, libraries marked with an X are required if 163provide them). By default, libraries marked with an X are required if
163X11 is being used. 164X11 is being used.
164 165
165 libXaw3d https://directory.fsf.org/project/xaw3d/ 166 libXaw3d https://directory.fsf.org/project/Xaw3d
166 X libxpm for XPM: http://www.x.org/releases/current/src/lib/ 167 X libxpm for XPM: https://www.x.org/releases/current/src/lib/
167 X libpng for PNG: http://www.libpng.org/ 168 X libpng for PNG: http://www.libpng.org/
168 libz (for PNG): http://www.zlib.net/ 169 libz (for PNG): https://www.zlib.net/
169 X libjpeg for JPEG: http://www.ijg.org/ 170 X libjpeg for JPEG: https://www.ijg.org/
170 X libtiff for TIFF: http://www.remotesensing.org/libtiff/ 171 X libtiff for TIFF: http://www.simplesystems.org/libtiff/
171 X libgif for GIF: http://sourceforge.net/projects/giflib/ 172 X libgif for GIF: http://giflib.sourceforge.net/
172 librsvg2 for SVG: http://wiki.gnome.org/action/show/Projects/LibRsvg 173 librsvg2 for SVG: https://wiki.gnome.org/Projects/LibRsvg
173 174
174If you supply the appropriate --without-LIB option, 'configure' will 175If you supply the appropriate --without-LIB option, 'configure' will
175omit the corresponding library from Emacs, even if that makes for a 176omit the corresponding library from Emacs, even if that makes for a
@@ -213,7 +214,7 @@ DETAILED BUILDING AND INSTALLATION:
213see nextstep/INSTALL. For non-ancient versions of MS Windows, see 214see nextstep/INSTALL. For non-ancient versions of MS Windows, see
214the file nt/INSTALL. For MS-DOS and MS Windows 3.X, see msdos/INSTALL.) 215the file nt/INSTALL. For MS-DOS and MS Windows 3.X, see msdos/INSTALL.)
215 216
2161) See the basic installation summary above for the disk space requirements. 2171) See BASIC INSTALLATION above for getting and configuring Emacs.
217 218
2182) In the unlikely event that 'configure' does not detect your system 2192) In the unlikely event that 'configure' does not detect your system
219type correctly, consult './etc/MACHINES' to see what --host, --build 220type correctly, consult './etc/MACHINES' to see what --host, --build
@@ -352,7 +353,7 @@ Use --enable-link-time-optimization to enable link-time optimization.
352With GCC, you need GCC 4.5.0 and later, and 'configure' arranges for 353With GCC, you need GCC 4.5.0 and later, and 'configure' arranges for
353linking to be parallelized if possible. With Clang, you need GNU 354linking to be parallelized if possible. With Clang, you need GNU
354binutils with the gold linker and plugin support, along with the LLVM 355binutils with the gold linker and plugin support, along with the LLVM
355gold plugin <http://llvm.org/docs/GoldPlugin.html>. Link time 356gold plugin <https://llvm.org/docs/GoldPlugin.html>. Link time
356optimization is not the default as it tends to cause crashes and to 357optimization is not the default as it tends to cause crashes and to
357make Emacs slower. 358make Emacs slower.
358 359