diff options
| author | Paul Eggert | 2019-05-03 13:58:09 -0700 |
|---|---|---|
| committer | Paul Eggert | 2019-05-03 14:54:38 -0700 |
| commit | dae48faec640bba57a42c1a81cc0ab6703a2ddbd (patch) | |
| tree | 0def7bc0f135866faccbb35c96076c522b6f396a | |
| parent | 6caf9be6cacad2da36f2a1303304df588325d38b (diff) | |
| download | emacs-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-- | INSTALL | 33 |
1 files changed, 17 insertions, 16 deletions
| @@ -34,11 +34,12 @@ some of the steps manually. The more detailed description in the other | |||
| 34 | sections of this guide will help you do that, so please refer to those | 34 | sections of this guide will help you do that, so please refer to those |
| 35 | sections if you need to. | 35 | sections 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, | |||
| 118 | for use at compilation time rather than run time, you will need that | 119 | for use at compilation time rather than run time, you will need that |
| 119 | as well as the corresponding run time package; typically the dev | 120 | as well as the corresponding run time package; typically the dev |
| 120 | package will contain header files and a library archive. Otherwise, | 121 | package will contain header files and a library archive. Otherwise, |
| 121 | you can download the libraries from <http://www.nongnu.org/m17n/>. | 122 | you can download the libraries from <https://www.nongnu.org/m17n/>. |
| 122 | 123 | ||
| 123 | Note that Emacs cannot support complex scripts on a TTY, unless the | 124 | Note that Emacs cannot support complex scripts on a TTY, unless the |
| 124 | terminal includes such a support. | 125 | terminal includes such a support. |
| @@ -162,14 +163,14 @@ can be found (in the unlikely event that your distribution does not | |||
| 162 | provide them). By default, libraries marked with an X are required if | 163 | provide them). By default, libraries marked with an X are required if |
| 163 | X11 is being used. | 164 | X11 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 | ||
| 174 | If you supply the appropriate --without-LIB option, 'configure' will | 175 | If you supply the appropriate --without-LIB option, 'configure' will |
| 175 | omit the corresponding library from Emacs, even if that makes for a | 176 | omit the corresponding library from Emacs, even if that makes for a |
| @@ -213,7 +214,7 @@ DETAILED BUILDING AND INSTALLATION: | |||
| 213 | see nextstep/INSTALL. For non-ancient versions of MS Windows, see | 214 | see nextstep/INSTALL. For non-ancient versions of MS Windows, see |
| 214 | the file nt/INSTALL. For MS-DOS and MS Windows 3.X, see msdos/INSTALL.) | 215 | the file nt/INSTALL. For MS-DOS and MS Windows 3.X, see msdos/INSTALL.) |
| 215 | 216 | ||
| 216 | 1) See the basic installation summary above for the disk space requirements. | 217 | 1) See BASIC INSTALLATION above for getting and configuring Emacs. |
| 217 | 218 | ||
| 218 | 2) In the unlikely event that 'configure' does not detect your system | 219 | 2) In the unlikely event that 'configure' does not detect your system |
| 219 | type correctly, consult './etc/MACHINES' to see what --host, --build | 220 | type correctly, consult './etc/MACHINES' to see what --host, --build |
| @@ -352,7 +353,7 @@ Use --enable-link-time-optimization to enable link-time optimization. | |||
| 352 | With GCC, you need GCC 4.5.0 and later, and 'configure' arranges for | 353 | With GCC, you need GCC 4.5.0 and later, and 'configure' arranges for |
| 353 | linking to be parallelized if possible. With Clang, you need GNU | 354 | linking to be parallelized if possible. With Clang, you need GNU |
| 354 | binutils with the gold linker and plugin support, along with the LLVM | 355 | binutils with the gold linker and plugin support, along with the LLVM |
| 355 | gold plugin <http://llvm.org/docs/GoldPlugin.html>. Link time | 356 | gold plugin <https://llvm.org/docs/GoldPlugin.html>. Link time |
| 356 | optimization is not the default as it tends to cause crashes and to | 357 | optimization is not the default as it tends to cause crashes and to |
| 357 | make Emacs slower. | 358 | make Emacs slower. |
| 358 | 359 | ||