diff options
| author | Paul Eggert | 2015-04-19 14:40:51 -0700 |
|---|---|---|
| committer | Paul Eggert | 2015-04-19 14:44:50 -0700 |
| commit | 9099d45df734f63145d414a0e1205245973c9efb (patch) | |
| tree | 45d131ea09c07024f85bb27c1ada901e40a45331 /INSTALL | |
| parent | 62e170072e6000b30c37792227dc34e71a31d797 (diff) | |
| download | emacs-9099d45df734f63145d414a0e1205245973c9efb.tar.gz emacs-9099d45df734f63145d414a0e1205245973c9efb.zip | |
Quote 'like this' in top-level files
* CONTRIBUTE, INSTALL, Makefile.in, README, configure.ac, make-dist:
Prefer to single-quote 'like this' (instead of the older style
`like this').
* configure.ac: Fix some space-before-tab problems that 'git commit'
complained about.
Diffstat (limited to 'INSTALL')
| -rw-r--r-- | INSTALL | 302 |
1 files changed, 151 insertions, 151 deletions
| @@ -13,21 +13,21 @@ msdos/INSTALL. For information about building from a repository checkout | |||
| 13 | 13 | ||
| 14 | BASIC INSTALLATION | 14 | BASIC INSTALLATION |
| 15 | 15 | ||
| 16 | On most Unix systems, you build Emacs by first running the `configure' | 16 | On most Unix systems, you build Emacs by first running the 'configure' |
| 17 | shell script. This attempts to deduce the correct values for | 17 | shell script. This attempts to deduce the correct values for |
| 18 | various system-dependent variables and features, and find the | 18 | various system-dependent variables and features, and find the |
| 19 | directories where certain system headers and libraries are kept. | 19 | directories where certain system headers and libraries are kept. |
| 20 | In a few cases, you may need to explicitly tell configure where to | 20 | In a few cases, you may need to explicitly tell configure where to |
| 21 | find some things, or what options to use. | 21 | find some things, or what options to use. |
| 22 | 22 | ||
| 23 | `configure' creates a `Makefile' in several subdirectories, and a | 23 | 'configure' creates a 'Makefile' in several subdirectories, and a |
| 24 | `src/config.h' file containing system-dependent definitions. | 24 | 'src/config.h' file containing system-dependent definitions. |
| 25 | Running the `make' utility then builds the package for your system. | 25 | Running the 'make' utility then builds the package for your system. |
| 26 | 26 | ||
| 27 | Building Emacs requires GNU make, <http://www.gnu.org/software/make/>. | 27 | Building Emacs requires GNU make, <http://www.gnu.org/software/make/>. |
| 28 | On most systems that Emacs supports, this is the default `make' program. | 28 | On most systems that Emacs supports, this is the default 'make' program. |
| 29 | 29 | ||
| 30 | Here's the procedure to build Emacs using `configure' on systems which | 30 | Here's the procedure to build Emacs using 'configure' on systems which |
| 31 | are supported by it. In some cases, if the simplified procedure fails, | 31 | are supported by it. In some cases, if the simplified procedure fails, |
| 32 | you might need to use various non-default options, and maybe perform | 32 | you might need to use various non-default options, and maybe perform |
| 33 | some of the steps manually. The more detailed description in the other | 33 | some of the steps manually. The more detailed description in the other |
| @@ -40,48 +40,48 @@ sections if you need to. | |||
| 40 | This includes the space-saving that comes from automatically | 40 | This includes the space-saving that comes from automatically |
| 41 | compressing the Lisp source files on installation. | 41 | compressing the Lisp source files on installation. |
| 42 | 42 | ||
| 43 | 2a. `cd' to the directory where you unpacked Emacs and invoke the | 43 | 2a. 'cd' to the directory where you unpacked Emacs and invoke the |
| 44 | `configure' script: | 44 | 'configure' script: |
| 45 | 45 | ||
| 46 | ./configure | 46 | ./configure |
| 47 | 47 | ||
| 48 | 2b. Alternatively, create a separate directory, outside the source | 48 | 2b. Alternatively, create a separate directory, outside the source |
| 49 | directory, where you want to build Emacs, and invoke `configure' | 49 | directory, where you want to build Emacs, and invoke 'configure' |
| 50 | from there: | 50 | from there: |
| 51 | 51 | ||
| 52 | SOURCE-DIR/configure | 52 | SOURCE-DIR/configure |
| 53 | 53 | ||
| 54 | where SOURCE-DIR is the top-level Emacs source directory. | 54 | where SOURCE-DIR is the top-level Emacs source directory. |
| 55 | 55 | ||
| 56 | 3. When `configure' finishes, it prints several lines of details | 56 | 3. When 'configure' finishes, it prints several lines of details |
| 57 | about the system configuration. Read those details carefully | 57 | about the system configuration. Read those details carefully |
| 58 | looking for anything suspicious, such as wrong CPU and operating | 58 | looking for anything suspicious, such as wrong CPU and operating |
| 59 | system names, wrong places for headers or libraries, missing | 59 | system names, wrong places for headers or libraries, missing |
| 60 | libraries that you know are installed on your system, etc. | 60 | libraries that you know are installed on your system, etc. |
| 61 | 61 | ||
| 62 | If you find anything wrong, you may have to pass to `configure' | 62 | If you find anything wrong, you may have to pass to 'configure' |
| 63 | one or more options specifying the explicit machine configuration | 63 | one or more options specifying the explicit machine configuration |
| 64 | name, where to find various headers and libraries, etc. | 64 | name, where to find various headers and libraries, etc. |
| 65 | Refer to the section DETAILED BUILDING AND INSTALLATION below. | 65 | Refer to the section DETAILED BUILDING AND INSTALLATION below. |
| 66 | 66 | ||
| 67 | If `configure' didn't find some image support libraries, such as | 67 | If 'configure' didn't find some image support libraries, such as |
| 68 | Xpm and jpeg, refer to "Image support libraries" below. | 68 | Xpm and jpeg, refer to "Image support libraries" below. |
| 69 | 69 | ||
| 70 | If the details printed by `configure' don't make any sense to | 70 | If the details printed by 'configure' don't make any sense to |
| 71 | you, but there are no obvious errors, assume that `configure' did | 71 | you, but there are no obvious errors, assume that 'configure' did |
| 72 | its job and proceed. | 72 | its job and proceed. |
| 73 | 73 | ||
| 74 | 4. Invoke the `make' program: | 74 | 4. Invoke the 'make' program: |
| 75 | 75 | ||
| 76 | make | 76 | make |
| 77 | 77 | ||
| 78 | 5. If `make' succeeds, it will build an executable program `emacs' | 78 | 5. If 'make' succeeds, it will build an executable program 'emacs' |
| 79 | in the `src' directory. You can try this program, to make sure | 79 | in the 'src' directory. You can try this program, to make sure |
| 80 | it works: | 80 | it works: |
| 81 | 81 | ||
| 82 | src/emacs -Q | 82 | src/emacs -Q |
| 83 | 83 | ||
| 84 | 6. Assuming that the program `src/emacs' starts and displays its | 84 | 6. Assuming that the program 'src/emacs' starts and displays its |
| 85 | opening screen, you can install the program and its auxiliary | 85 | opening screen, you can install the program and its auxiliary |
| 86 | files into their installation directories: | 86 | files into their installation directories: |
| 87 | 87 | ||
| @@ -101,7 +101,7 @@ sections if you need to. | |||
| 101 | make distclean | 101 | make distclean |
| 102 | 102 | ||
| 103 | Note that the install automatically saves space by compressing | 103 | Note that the install automatically saves space by compressing |
| 104 | (provided you have the `gzip' program) those installed Lisp source (.el) | 104 | (provided you have the 'gzip' program) those installed Lisp source (.el) |
| 105 | files that have corresponding .elc versions, as well as the Info files. | 105 | files that have corresponding .elc versions, as well as the Info files. |
| 106 | 106 | ||
| 107 | 107 | ||
| @@ -114,7 +114,7 @@ On GNU and Unix systems, Emacs needs the optional libraries "m17n-db", | |||
| 114 | Indic and Khmer, and also for scripts that require Arabic shaping | 114 | Indic and Khmer, and also for scripts that require Arabic shaping |
| 115 | support (Arabic and Farsi). On some systems, particularly GNU/Linux, | 115 | support (Arabic and Farsi). On some systems, particularly GNU/Linux, |
| 116 | these libraries may be already present or available as additional | 116 | these libraries may be already present or available as additional |
| 117 | packages. Note that if there is a separate `dev' or `devel' package, | 117 | 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 | 118 | 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 | 119 | as well as the corresponding run time package; typically the dev |
| 120 | package will contain header files and a library archive. Otherwise, | 120 | package will contain header files and a library archive. Otherwise, |
| @@ -148,7 +148,7 @@ XBM images whose support is built-in. | |||
| 148 | 148 | ||
| 149 | On some systems, particularly on GNU/Linux, these libraries may | 149 | On some systems, particularly on GNU/Linux, these libraries may |
| 150 | already be present or available as additional packages. If | 150 | already be present or available as additional packages. If |
| 151 | there is a separate `dev' or `devel' package, for use at compilation | 151 | there is a separate 'dev' or 'devel' package, for use at compilation |
| 152 | time rather than run time, you will need that as well as the | 152 | time rather than run time, you will need that as well as the |
| 153 | corresponding run time package; typically the dev package will | 153 | corresponding run time package; typically the dev package will |
| 154 | contain header files and a library archive. Otherwise, you can | 154 | contain header files and a library archive. Otherwise, you can |
| @@ -195,15 +195,15 @@ number of free Unicode fonts. | |||
| 195 | Many GNU/Linux systems do not come with development packages by default; | 195 | Many GNU/Linux systems do not come with development packages by default; |
| 196 | they include the files that you need to run Emacs, but not those you | 196 | they include the files that you need to run Emacs, but not those you |
| 197 | need to compile it. For example, to compile Emacs with support for X | 197 | need to compile it. For example, to compile Emacs with support for X |
| 198 | and graphics libraries, you may need to install the `X development' | 198 | and graphics libraries, you may need to install the X development |
| 199 | package(s), and development versions of the jpeg, png, etc. packages. | 199 | package(s), and development versions of the jpeg, png, etc. packages. |
| 200 | 200 | ||
| 201 | The names of the packages that you need varies according to the | 201 | The names of the packages that you need varies according to the |
| 202 | GNU/Linux distribution that you use, and the options that you want to | 202 | GNU/Linux distribution that you use, and the options that you want to |
| 203 | configure Emacs with. On Debian-based systems, you can install all the | 203 | configure Emacs with. On Debian-based systems, you can install all the |
| 204 | packages needed to build the installed version of Emacs with a command | 204 | packages needed to build the installed version of Emacs with a command |
| 205 | like `apt-get build-dep emacs24'. On Red Hat systems, the | 205 | like 'apt-get build-dep emacs24'. On Red Hat systems, the |
| 206 | corresponding command is `yum-builddep emacs'. | 206 | corresponding command is 'yum-builddep emacs'. |
| 207 | 207 | ||
| 208 | 208 | ||
| 209 | DETAILED BUILDING AND INSTALLATION: | 209 | DETAILED BUILDING AND INSTALLATION: |
| @@ -214,37 +214,37 @@ the file nt/INSTALL. For MS-DOS and MS Windows 3.X, see msdos/INSTALL.) | |||
| 214 | 214 | ||
| 215 | 1) See the basic installation summary above for the disk space requirements. | 215 | 1) See the basic installation summary above for the disk space requirements. |
| 216 | 216 | ||
| 217 | 2) In the unlikely event that `configure' does not detect your system | 217 | 2) In the unlikely event that 'configure' does not detect your system |
| 218 | type correctly, consult `./etc/MACHINES' to see what --host, --build | 218 | type correctly, consult './etc/MACHINES' to see what --host, --build |
| 219 | options you should pass to `configure'. That file also offers hints | 219 | options you should pass to 'configure'. That file also offers hints |
| 220 | for getting around some possible installation problems. | 220 | for getting around some possible installation problems. |
| 221 | 221 | ||
| 222 | 3) You can build Emacs in the top-level Emacs source directory | 222 | 3) You can build Emacs in the top-level Emacs source directory |
| 223 | or in a separate directory. | 223 | or in a separate directory. |
| 224 | 224 | ||
| 225 | 3a) To build in the top-level Emacs source directory, go to that | 225 | 3a) To build in the top-level Emacs source directory, go to that |
| 226 | directory and run the program `configure' as follows: | 226 | directory and run the program 'configure' as follows: |
| 227 | 227 | ||
| 228 | ./configure [--OPTION[=VALUE]] ... | 228 | ./configure [--OPTION[=VALUE]] ... |
| 229 | 229 | ||
| 230 | If `configure' cannot determine your system type, try again | 230 | If 'configure' cannot determine your system type, try again |
| 231 | specifying the proper --build, --host options explicitly. | 231 | specifying the proper --build, --host options explicitly. |
| 232 | 232 | ||
| 233 | If you don't want X support, specify `--with-x=no'. If you omit this | 233 | If you don't want X support, specify '--with-x=no'. If you omit this |
| 234 | option, `configure' will try to figure out for itself whether your | 234 | option, 'configure' will try to figure out for itself whether your |
| 235 | system has X, and arrange to use it if present. | 235 | system has X, and arrange to use it if present. |
| 236 | 236 | ||
| 237 | The `--x-includes=DIR' and `--x-libraries=DIR' options tell the build | 237 | The '--x-includes=DIR' and '--x-libraries=DIR' options tell the build |
| 238 | process where the compiler should look for the include files and | 238 | process where the compiler should look for the include files and |
| 239 | object libraries used with the X Window System. Normally, `configure' | 239 | object libraries used with the X Window System. Normally, 'configure' |
| 240 | is able to find them; these options are necessary if you have your X | 240 | is able to find them; these options are necessary if you have your X |
| 241 | Window System files installed in unusual places. These options also | 241 | Window System files installed in unusual places. These options also |
| 242 | accept a list of directories, separated with colons. | 242 | accept a list of directories, separated with colons. |
| 243 | 243 | ||
| 244 | To get more attractive menus, you can specify an X toolkit when you | 244 | To get more attractive menus, you can specify an X toolkit when you |
| 245 | configure Emacs; use the option `--with-x-toolkit=TOOLKIT', where | 245 | configure Emacs; use the option '--with-x-toolkit=TOOLKIT', where |
| 246 | TOOLKIT is `gtk' (the default), `athena', or `motif' (`yes' and | 246 | TOOLKIT is 'gtk' (the default), 'athena', or 'motif' ('yes' and |
| 247 | `lucid' are synonyms for `athena'). Compiling with Motif causes a | 247 | 'lucid' are synonyms for 'athena'). Compiling with Motif causes a |
| 248 | standard File Selection Dialog to pop up when you invoke file commands | 248 | standard File Selection Dialog to pop up when you invoke file commands |
| 249 | with the mouse. You can get fancy 3D-style scroll bars, even without | 249 | with the mouse. You can get fancy 3D-style scroll bars, even without |
| 250 | Gtk or Motif, if you have the Xaw3d library installed (see | 250 | Gtk or Motif, if you have the Xaw3d library installed (see |
| @@ -257,12 +257,12 @@ Emacs will autolaunch a D-Bus session bus, when the environment | |||
| 257 | variable DISPLAY is set, but no session bus is running. This might be | 257 | variable DISPLAY is set, but no session bus is running. This might be |
| 258 | inconvenient for Emacs when running as daemon or running via a remote | 258 | inconvenient for Emacs when running as daemon or running via a remote |
| 259 | ssh connection. In order to completely prevent the use of D-Bus, configure | 259 | ssh connection. In order to completely prevent the use of D-Bus, configure |
| 260 | Emacs with the options `--without-dbus --without-gconf --without-gsettings'. | 260 | Emacs with the options '--without-dbus --without-gconf --without-gsettings'. |
| 261 | 261 | ||
| 262 | The Emacs mail reader RMAIL is configured to be able to read mail from | 262 | The Emacs mail reader RMAIL is configured to be able to read mail from |
| 263 | a POP3 server by default. Versions of the POP protocol older than | 263 | a POP3 server by default. Versions of the POP protocol older than |
| 264 | POP3 are not supported. For Kerberos-authenticated POP add | 264 | POP3 are not supported. For Kerberos-authenticated POP add |
| 265 | `--with-kerberos', for Hesiod support add `--with-hesiod'. While POP3 | 265 | '--with-kerberos', for Hesiod support add '--with-hesiod'. While POP3 |
| 266 | is always enabled, whether Emacs actually uses POP is controlled by | 266 | is always enabled, whether Emacs actually uses POP is controlled by |
| 267 | individual users--see the Rmail chapter of the Emacs manual. | 267 | individual users--see the Rmail chapter of the Emacs manual. |
| 268 | 268 | ||
| @@ -322,28 +322,28 @@ that goes awry. 'make V=1' also enables the extra chatter. | |||
| 322 | 322 | ||
| 323 | Use --enable-link-time-optimization to enable link-time optimizer. If | 323 | Use --enable-link-time-optimization to enable link-time optimizer. If |
| 324 | you're using GNU compiler, this feature is supported since version 4.5.0. | 324 | you're using GNU compiler, this feature is supported since version 4.5.0. |
| 325 | If `configure' can determine number of online CPUS on your system, final | 325 | If 'configure' can determine number of online CPUS on your system, final |
| 326 | link-time optimization and code generation is executed in parallel using | 326 | link-time optimization and code generation is executed in parallel using |
| 327 | one job per each available online CPU. | 327 | one job per each available online CPU. |
| 328 | 328 | ||
| 329 | This option is also supported for clang. You should have GNU binutils | 329 | This option is also supported for clang. You should have GNU binutils |
| 330 | with `gold' linker and plugin support, and clang with LLVMgold.so plugin. | 330 | with 'gold' linker and plugin support, and clang with LLVMgold.so plugin. |
| 331 | Read http://llvm.org/docs/GoldPlugin.html for details. Also note that | 331 | Read http://llvm.org/docs/GoldPlugin.html for details. Also note that |
| 332 | this feature is still experimental, so prepare to build binutils and | 332 | this feature is still experimental, so prepare to build binutils and |
| 333 | clang from the corresponding source code repositories. | 333 | clang from the corresponding source code repositories. |
| 334 | 334 | ||
| 335 | The `--prefix=PREFIXDIR' option specifies where the installation process | 335 | The '--prefix=PREFIXDIR' option specifies where the installation process |
| 336 | should put emacs and its data files. This defaults to `/usr/local'. | 336 | should put emacs and its data files. This defaults to '/usr/local'. |
| 337 | - Emacs (and the other utilities users run) go in PREFIXDIR/bin | 337 | - Emacs (and the other utilities users run) go in PREFIXDIR/bin |
| 338 | (unless the `--exec-prefix' option says otherwise). | 338 | (unless the '--exec-prefix' option says otherwise). |
| 339 | - The architecture-independent files go in PREFIXDIR/share/emacs/VERSION | 339 | - The architecture-independent files go in PREFIXDIR/share/emacs/VERSION |
| 340 | (where VERSION is the version number of Emacs, like `23.2'). | 340 | (where VERSION is the version number of Emacs, like '23.2'). |
| 341 | - The architecture-dependent files go in | 341 | - The architecture-dependent files go in |
| 342 | PREFIXDIR/libexec/emacs/VERSION/CONFIGURATION | 342 | PREFIXDIR/libexec/emacs/VERSION/CONFIGURATION |
| 343 | (where CONFIGURATION is the configuration name, like | 343 | (where CONFIGURATION is the configuration name, like |
| 344 | i686-pc-linux-gnu), unless the `--exec-prefix' option says otherwise. | 344 | i686-pc-linux-gnu), unless the '--exec-prefix' option says otherwise. |
| 345 | 345 | ||
| 346 | The `--exec-prefix=EXECDIR' option allows you to specify a separate | 346 | The '--exec-prefix=EXECDIR' option allows you to specify a separate |
| 347 | portion of the directory tree for installing architecture-specific | 347 | portion of the directory tree for installing architecture-specific |
| 348 | files, like executables and utility programs. If specified, | 348 | files, like executables and utility programs. If specified, |
| 349 | - Emacs (and the other utilities users run) go in EXECDIR/bin, and | 349 | - Emacs (and the other utilities users run) go in EXECDIR/bin, and |
| @@ -358,26 +358,26 @@ For example, the command | |||
| 358 | configures Emacs to build for a 32-bit GNU/Linux distribution, | 358 | configures Emacs to build for a 32-bit GNU/Linux distribution, |
| 359 | without sound support. | 359 | without sound support. |
| 360 | 360 | ||
| 361 | `configure' doesn't do any compilation or installation itself. | 361 | 'configure' doesn't do any compilation or installation itself. |
| 362 | It just creates the files that influence those things: | 362 | It just creates the files that influence those things: |
| 363 | `./Makefile' in the top-level directory and several subdirectories; | 363 | './Makefile' in the top-level directory and several subdirectories; |
| 364 | and `./src/config.h'. | 364 | and './src/config.h'. |
| 365 | 365 | ||
| 366 | When it is done, `configure' prints a description of what it did and | 366 | When it is done, 'configure' prints a description of what it did and |
| 367 | creates a shell script `config.status' which, when run, recreates the | 367 | creates a shell script 'config.status' which, when run, recreates the |
| 368 | same configuration. If `configure' exits with an error after | 368 | same configuration. If 'configure' exits with an error after |
| 369 | disturbing the status quo, it removes `config.status'. `configure' | 369 | disturbing the status quo, it removes 'config.status'. 'configure' |
| 370 | also creates a file `config.cache' that saves the results of its tests | 370 | also creates a file 'config.cache' that saves the results of its tests |
| 371 | to make reconfiguring faster, and a file `config.log' containing compiler | 371 | to make reconfiguring faster, and a file 'config.log' containing compiler |
| 372 | output (useful mainly for debugging `configure'). You can give | 372 | output (useful mainly for debugging 'configure'). You can give |
| 373 | `configure' the option `--cache-file=FILE' to use the results of the | 373 | 'configure' the option '--cache-file=FILE' to use the results of the |
| 374 | tests in FILE instead of `config.cache'. Set FILE to `/dev/null' to | 374 | tests in FILE instead of 'config.cache'. Set FILE to '/dev/null' to |
| 375 | disable caching, for debugging `configure'. | 375 | disable caching, for debugging 'configure'. |
| 376 | 376 | ||
| 377 | If the description of the system configuration printed by `configure' | 377 | If the description of the system configuration printed by 'configure' |
| 378 | is not right, or if it claims some of the features or libraries are not | 378 | is not right, or if it claims some of the features or libraries are not |
| 379 | available when you know they are, look at the `config.log' file for | 379 | available when you know they are, look at the 'config.log' file for |
| 380 | the trace of the failed tests performed by `configure' to check | 380 | the trace of the failed tests performed by 'configure' to check |
| 381 | whether these features are supported. Typically, some test fails | 381 | whether these features are supported. Typically, some test fails |
| 382 | because the compiler cannot find some function in the system | 382 | because the compiler cannot find some function in the system |
| 383 | libraries, or some macro-processor definition in the system headers. | 383 | libraries, or some macro-processor definition in the system headers. |
| @@ -385,29 +385,29 @@ libraries, or some macro-processor definition in the system headers. | |||
| 385 | Some tests might fail because the compiler should look in special | 385 | Some tests might fail because the compiler should look in special |
| 386 | directories for some header files, or link against optional | 386 | directories for some header files, or link against optional |
| 387 | libraries, or use special compilation options. You can force | 387 | libraries, or use special compilation options. You can force |
| 388 | `configure' and the build process which follows it to do that by | 388 | 'configure' and the build process which follows it to do that by |
| 389 | setting the variables CPPFLAGS, CFLAGS, LDFLAGS, LIBS, CPP and CC | 389 | setting the variables CPPFLAGS, CFLAGS, LDFLAGS, LIBS, CPP and CC |
| 390 | before running `configure'. CPP is the command which invokes the | 390 | before running 'configure'. CPP is the command which invokes the |
| 391 | preprocessor, CPPFLAGS lists the options passed to it, CFLAGS are | 391 | preprocessor, CPPFLAGS lists the options passed to it, CFLAGS are |
| 392 | compilation options, LDFLAGS are options used when linking, LIBS are | 392 | compilation options, LDFLAGS are options used when linking, LIBS are |
| 393 | libraries to link against, and CC is the command which invokes the | 393 | libraries to link against, and CC is the command which invokes the |
| 394 | compiler. By default, gcc is used if available. | 394 | compiler. By default, gcc is used if available. |
| 395 | 395 | ||
| 396 | Here's an example of a `configure' invocation, assuming a Bourne-like | 396 | Here's an example of a 'configure' invocation, assuming a Bourne-like |
| 397 | shell such as Bash, which uses these variables: | 397 | shell such as Bash, which uses these variables: |
| 398 | 398 | ||
| 399 | ./configure \ | 399 | ./configure \ |
| 400 | CPPFLAGS='-I/foo/myinclude' LDFLAGS='-L/bar/mylib' \ | 400 | CPPFLAGS='-I/foo/myinclude' LDFLAGS='-L/bar/mylib' \ |
| 401 | CFLAGS='-O3' LIBS='-lfoo -lbar' | 401 | CFLAGS='-O3' LIBS='-lfoo -lbar' |
| 402 | 402 | ||
| 403 | (this is all one shell command). This tells `configure' to instruct the | 403 | (this is all one shell command). This tells 'configure' to instruct the |
| 404 | preprocessor to look in the `/foo/myinclude' directory for header | 404 | preprocessor to look in the '/foo/myinclude' directory for header |
| 405 | files (in addition to the standard directories), instruct the linker | 405 | files (in addition to the standard directories), instruct the linker |
| 406 | to look in `/bar/mylib' for libraries, pass the -O3 optimization | 406 | to look in '/bar/mylib' for libraries, pass the -O3 optimization |
| 407 | switch to the compiler, and link against libfoo and libbar | 407 | switch to the compiler, and link against libfoo and libbar |
| 408 | libraries in addition to the standard ones. | 408 | libraries in addition to the standard ones. |
| 409 | 409 | ||
| 410 | For some libraries, like Gtk+, fontconfig and ALSA, `configure' uses | 410 | For some libraries, like Gtk+, fontconfig and ALSA, 'configure' uses |
| 411 | pkg-config to find where those libraries are installed. | 411 | pkg-config to find where those libraries are installed. |
| 412 | If you want pkg-config to look in special directories, you have to set | 412 | If you want pkg-config to look in special directories, you have to set |
| 413 | PKG_CONFIG_PATH to point to the directories where the .pc-files for | 413 | PKG_CONFIG_PATH to point to the directories where the .pc-files for |
| @@ -417,27 +417,27 @@ those libraries are. For example: | |||
| 417 | PKG_CONFIG_PATH='/usr/local/alsa/lib/pkgconfig:/opt/gtk+-2.8/lib/pkgconfig' | 417 | PKG_CONFIG_PATH='/usr/local/alsa/lib/pkgconfig:/opt/gtk+-2.8/lib/pkgconfig' |
| 418 | 418 | ||
| 419 | 3b) To build in a separate directory, go to that directory | 419 | 3b) To build in a separate directory, go to that directory |
| 420 | and run the program `configure' as follows: | 420 | and run the program 'configure' as follows: |
| 421 | 421 | ||
| 422 | SOURCE-DIR/configure CONFIGURATION-NAME [--OPTION[=VALUE]] ... | 422 | SOURCE-DIR/configure CONFIGURATION-NAME [--OPTION[=VALUE]] ... |
| 423 | 423 | ||
| 424 | SOURCE-DIR refers to the top-level Emacs source directory which is | 424 | SOURCE-DIR refers to the top-level Emacs source directory which is |
| 425 | where Emacs's configure script is located. `configure' looks for the | 425 | where Emacs's configure script is located. 'configure' looks for the |
| 426 | Emacs source code in the directory that `configure' is in. | 426 | Emacs source code in the directory that 'configure' is in. |
| 427 | 427 | ||
| 428 | 4) Put into `./lisp/site-init.el' or `./lisp/site-load.el' any Emacs | 428 | 4) Put into './lisp/site-init.el' or './lisp/site-load.el' any Emacs |
| 429 | Lisp code you want Emacs to load before it is dumped out. Use | 429 | Lisp code you want Emacs to load before it is dumped out. Use |
| 430 | site-load.el for additional libraries if you arrange for their | 430 | site-load.el for additional libraries if you arrange for their |
| 431 | documentation strings to be in the etc/DOC file (see | 431 | documentation strings to be in the etc/DOC file (see |
| 432 | src/Makefile.in if you wish to figure out how to do that). For all | 432 | src/Makefile.in if you wish to figure out how to do that). For all |
| 433 | else, use site-init.el. Do not load byte-compiled code which | 433 | else, use site-init.el. Do not load byte-compiled code which |
| 434 | was built with a non-nil value of `byte-compile-dynamic'. | 434 | was built with a non-nil value of 'byte-compile-dynamic'. |
| 435 | 435 | ||
| 436 | It is not a good idea to edit the normal .el files that come with Emacs. | 436 | It is not a good idea to edit the normal .el files that come with Emacs. |
| 437 | Instead, use a file like site-init.el to change settings. | 437 | Instead, use a file like site-init.el to change settings. |
| 438 | 438 | ||
| 439 | To change the value of a variable that is already defined in Emacs, | 439 | To change the value of a variable that is already defined in Emacs, |
| 440 | you should use the Lisp function `setq', not `defvar'. For example, | 440 | you should use the Lisp function 'setq', not 'defvar'. For example, |
| 441 | 441 | ||
| 442 | (setq news-inews-program "/usr/bin/inews") | 442 | (setq news-inews-program "/usr/bin/inews") |
| 443 | 443 | ||
| @@ -449,46 +449,46 @@ variable gets by default! Make sure you know what kind of value the | |||
| 449 | variable should have. If you don't pay attention to what you are | 449 | variable should have. If you don't pay attention to what you are |
| 450 | doing, you'll make a mistake. | 450 | doing, you'll make a mistake. |
| 451 | 451 | ||
| 452 | The `site-*.el' files are nonexistent in the distribution. You do not | 452 | The 'site-*.el' files are nonexistent in the distribution. You do not |
| 453 | need to create them if you have nothing to put in them. | 453 | need to create them if you have nothing to put in them. |
| 454 | 454 | ||
| 455 | 5) Refer to the file `./etc/TERMS' for information on fields you may | 455 | 5) Refer to the file './etc/TERMS' for information on fields you may |
| 456 | wish to add to various termcap entries. (This is unlikely to be necessary.) | 456 | wish to add to various termcap entries. (This is unlikely to be necessary.) |
| 457 | 457 | ||
| 458 | 6) Run `make' in the top directory of the Emacs distribution to finish | 458 | 6) Run 'make' in the top directory of the Emacs distribution to finish |
| 459 | building Emacs in the standard way. The final executable file is | 459 | building Emacs in the standard way. The final executable file is |
| 460 | named `src/emacs'. You can execute this file "in place" without | 460 | named 'src/emacs'. You can execute this file "in place" without |
| 461 | copying it, if you wish; then it automatically uses the sibling | 461 | copying it, if you wish; then it automatically uses the sibling |
| 462 | directories ../lisp, ../lib-src, ../info. | 462 | directories ../lisp, ../lib-src, ../info. |
| 463 | 463 | ||
| 464 | Or you can "install" the executable and the other files into their | 464 | Or you can "install" the executable and the other files into their |
| 465 | installed locations, with `make install'. By default, Emacs's files | 465 | installed locations, with 'make install'. By default, Emacs's files |
| 466 | are installed in the following directories: | 466 | are installed in the following directories: |
| 467 | 467 | ||
| 468 | `/usr/local/bin' holds the executable programs users normally run - | 468 | '/usr/local/bin' holds the executable programs users normally run - |
| 469 | `emacs', `etags', `ctags', `emacsclient'. | 469 | 'emacs', 'etags', 'ctags', 'emacsclient'. |
| 470 | 470 | ||
| 471 | `/usr/local/share/emacs/VERSION/lisp' holds the Emacs Lisp library; | 471 | '/usr/local/share/emacs/VERSION/lisp' holds the Emacs Lisp library; |
| 472 | `VERSION' stands for the number of the Emacs version | 472 | 'VERSION' stands for the number of the Emacs version |
| 473 | you are installing, like `23.1' or `23.2'. Since the | 473 | you are installing, like '23.1' or '23.2'. Since the |
| 474 | Lisp library changes from one version of Emacs to | 474 | Lisp library changes from one version of Emacs to |
| 475 | another, including the version number in the path | 475 | another, including the version number in the path |
| 476 | allows you to have several versions of Emacs installed | 476 | allows you to have several versions of Emacs installed |
| 477 | at the same time; in particular, you don't have to | 477 | at the same time; in particular, you don't have to |
| 478 | make Emacs unavailable while installing a new version. | 478 | make Emacs unavailable while installing a new version. |
| 479 | 479 | ||
| 480 | `/usr/local/share/emacs/VERSION/etc' holds the Emacs tutorial, the DOC | 480 | '/usr/local/share/emacs/VERSION/etc' holds the Emacs tutorial, the DOC |
| 481 | file, and other architecture-independent files Emacs | 481 | file, and other architecture-independent files Emacs |
| 482 | might need while running. | 482 | might need while running. |
| 483 | 483 | ||
| 484 | `/usr/local/libexec/emacs/VERSION/CONFIGURATION-NAME' contains executable | 484 | '/usr/local/libexec/emacs/VERSION/CONFIGURATION-NAME' contains executable |
| 485 | programs used by Emacs that users are not expected to | 485 | programs used by Emacs that users are not expected to |
| 486 | run themselves. | 486 | run themselves. |
| 487 | `VERSION' is the number of the Emacs version you are | 487 | 'VERSION' is the number of the Emacs version you are |
| 488 | installing, and `CONFIGURATION-NAME' is the value | 488 | installing, and 'CONFIGURATION-NAME' is the value |
| 489 | deduced by the `configure' program to identify the | 489 | deduced by the 'configure' program to identify the |
| 490 | architecture and operating system of your machine, | 490 | architecture and operating system of your machine, |
| 491 | like `i686-pc-linux-gnu' or `sparc-sun-sunos'. Since | 491 | like 'i686-pc-linux-gnu' or 'sparc-sun-sunos'. Since |
| 492 | these files are specific to the version of Emacs, | 492 | these files are specific to the version of Emacs, |
| 493 | operating system, and architecture in use, including | 493 | operating system, and architecture in use, including |
| 494 | the configuration name in the path allows you to have | 494 | the configuration name in the path allows you to have |
| @@ -497,35 +497,35 @@ are installed in the following directories: | |||
| 497 | useful for sites at which different kinds of machines | 497 | useful for sites at which different kinds of machines |
| 498 | share the file system Emacs is installed on. | 498 | share the file system Emacs is installed on. |
| 499 | 499 | ||
| 500 | `/usr/local/share/info' holds the on-line documentation for Emacs, | 500 | '/usr/local/share/info' holds the on-line documentation for Emacs, |
| 501 | known as "info files". Many other GNU programs are | 501 | known as "info files". Many other GNU programs are |
| 502 | documented using info files as well, so this directory | 502 | documented using info files as well, so this directory |
| 503 | stands apart from the other, Emacs-specific directories. | 503 | stands apart from the other, Emacs-specific directories. |
| 504 | 504 | ||
| 505 | `/usr/local/share/man/man1' holds the man pages for the programs installed | 505 | '/usr/local/share/man/man1' holds the man pages for the programs installed |
| 506 | in `/usr/local/bin'. | 506 | in '/usr/local/bin'. |
| 507 | 507 | ||
| 508 | Any version of Emacs, whether installed or not, also looks for Lisp | 508 | Any version of Emacs, whether installed or not, also looks for Lisp |
| 509 | files in these directories. | 509 | files in these directories. |
| 510 | 510 | ||
| 511 | `/usr/local/share/emacs/VERSION/site-lisp' holds the local Emacs Lisp | 511 | '/usr/local/share/emacs/VERSION/site-lisp' holds the local Emacs Lisp |
| 512 | files installed for Emacs version VERSION only. | 512 | files installed for Emacs version VERSION only. |
| 513 | 513 | ||
| 514 | `/usr/local/share/emacs/site-lisp' holds the local Emacs Lisp | 514 | '/usr/local/share/emacs/site-lisp' holds the local Emacs Lisp |
| 515 | files installed for all Emacs versions. | 515 | files installed for all Emacs versions. |
| 516 | 516 | ||
| 517 | When Emacs is installed, it searches for its Lisp files | 517 | When Emacs is installed, it searches for its Lisp files |
| 518 | in `/usr/local/share/emacs/VERSION/site-lisp', then in | 518 | in '/usr/local/share/emacs/VERSION/site-lisp', then in |
| 519 | `/usr/local/share/emacs/site-lisp', and finally in | 519 | '/usr/local/share/emacs/site-lisp', and finally in |
| 520 | `/usr/local/share/emacs/VERSION/lisp'. | 520 | '/usr/local/share/emacs/VERSION/lisp'. |
| 521 | 521 | ||
| 522 | If these directories are not what you want, you can specify where to | 522 | If these directories are not what you want, you can specify where to |
| 523 | install Emacs's libraries and data files or where Emacs should search | 523 | install Emacs's libraries and data files or where Emacs should search |
| 524 | for its Lisp files by giving values for `make' variables as part of | 524 | for its Lisp files by giving values for 'make' variables as part of |
| 525 | the command. See the section below called `MAKE VARIABLES' for more | 525 | the command. See the section below called 'MAKE VARIABLES' for more |
| 526 | information on this. | 526 | information on this. |
| 527 | 527 | ||
| 528 | 7) Check the file `dir' in your site's info directory (usually | 528 | 7) Check the file 'dir' in your site's info directory (usually |
| 529 | /usr/local/share/info) to make sure that it has a menu entry for the | 529 | /usr/local/share/info) to make sure that it has a menu entry for the |
| 530 | Emacs info files. | 530 | Emacs info files. |
| 531 | 531 | ||
| @@ -534,51 +534,51 @@ then you might need to make the movemail program setuid or setgid | |||
| 534 | to enable it to write the lock files. We believe this is safe. | 534 | to enable it to write the lock files. We believe this is safe. |
| 535 | 535 | ||
| 536 | 9) You are done! You can remove executables and object files from | 536 | 9) You are done! You can remove executables and object files from |
| 537 | the build directory by typing `make clean'. To also remove the files | 537 | the build directory by typing 'make clean'. To also remove the files |
| 538 | that `configure' created (so you can compile Emacs for a different | 538 | that 'configure' created (so you can compile Emacs for a different |
| 539 | configuration), type `make distclean'. | 539 | configuration), type 'make distclean'. |
| 540 | 540 | ||
| 541 | 541 | ||
| 542 | MAKE VARIABLES | 542 | MAKE VARIABLES |
| 543 | 543 | ||
| 544 | You can change where the build process installs Emacs and its data | 544 | You can change where the build process installs Emacs and its data |
| 545 | files by specifying values for `make' variables as part of the `make' | 545 | files by specifying values for 'make' variables as part of the 'make' |
| 546 | command line. For example, if you type | 546 | command line. For example, if you type |
| 547 | 547 | ||
| 548 | make install bindir=/usr/local/gnubin | 548 | make install bindir=/usr/local/gnubin |
| 549 | 549 | ||
| 550 | the `bindir=/usr/local/gnubin' argument indicates that the Emacs | 550 | the 'bindir=/usr/local/gnubin' argument indicates that the Emacs |
| 551 | executable files should go in `/usr/local/gnubin', not | 551 | executable files should go in '/usr/local/gnubin', not |
| 552 | `/usr/local/bin'. | 552 | '/usr/local/bin'. |
| 553 | 553 | ||
| 554 | Here is a complete list of the variables you may want to set. | 554 | Here is a complete list of the variables you may want to set. |
| 555 | 555 | ||
| 556 | `bindir' indicates where to put executable programs that users can | 556 | 'bindir' indicates where to put executable programs that users can |
| 557 | run. This defaults to /usr/local/bin. | 557 | run. This defaults to /usr/local/bin. |
| 558 | 558 | ||
| 559 | `datadir' indicates where to put the architecture-independent | 559 | 'datadir' indicates where to put the architecture-independent |
| 560 | read-only data files that Emacs refers to while it runs; it | 560 | read-only data files that Emacs refers to while it runs; it |
| 561 | defaults to /usr/local/share. We create the following | 561 | defaults to /usr/local/share. We create the following |
| 562 | subdirectories under `datadir': | 562 | subdirectories under 'datadir': |
| 563 | - `emacs/VERSION/lisp', containing the Emacs Lisp library, and | 563 | - 'emacs/VERSION/lisp', containing the Emacs Lisp library, and |
| 564 | - `emacs/VERSION/etc', containing the tutorials, DOC file, etc. | 564 | - 'emacs/VERSION/etc', containing the tutorials, DOC file, etc. |
| 565 | `VERSION' is the number of the Emacs version you are installing, | 565 | 'VERSION' is the number of the Emacs version you are installing, |
| 566 | like `23.1' or `23.2'. Since these files vary from one version | 566 | like '23.1' or '23.2'. Since these files vary from one version |
| 567 | of Emacs to another, including the version number in the path | 567 | of Emacs to another, including the version number in the path |
| 568 | allows you to have several versions of Emacs installed at the | 568 | allows you to have several versions of Emacs installed at the |
| 569 | same time; this means that you don't have to make Emacs | 569 | same time; this means that you don't have to make Emacs |
| 570 | unavailable while installing a new version. | 570 | unavailable while installing a new version. |
| 571 | 571 | ||
| 572 | `libexecdir' indicates where to put architecture-specific data files that | 572 | 'libexecdir' indicates where to put architecture-specific data files that |
| 573 | Emacs refers to as it runs; it defaults to `/usr/local/libexec'. | 573 | Emacs refers to as it runs; it defaults to '/usr/local/libexec'. |
| 574 | We create the following subdirectories under `libexecdir': | 574 | We create the following subdirectories under 'libexecdir': |
| 575 | - `emacs/VERSION/CONFIGURATION-NAME', containing executable | 575 | - 'emacs/VERSION/CONFIGURATION-NAME', containing executable |
| 576 | programs used by Emacs that users are not expected to run | 576 | programs used by Emacs that users are not expected to run |
| 577 | themselves. | 577 | themselves. |
| 578 | `VERSION' is the number of the Emacs version you are installing, | 578 | 'VERSION' is the number of the Emacs version you are installing, |
| 579 | and `CONFIGURATION-NAME' is the value deduced by the | 579 | and 'CONFIGURATION-NAME' is the value deduced by the |
| 580 | `configure' program to identify the architecture and operating | 580 | 'configure' program to identify the architecture and operating |
| 581 | system of your machine, like `i686-pc-linux-gnu' or `sparc-sun-sunos'. | 581 | system of your machine, like 'i686-pc-linux-gnu' or 'sparc-sun-sunos'. |
| 582 | Since these files are specific to the version of Emacs, | 582 | Since these files are specific to the version of Emacs, |
| 583 | operating system, and architecture in use, including the | 583 | operating system, and architecture in use, including the |
| 584 | configuration name in the path allows you to have several | 584 | configuration name in the path allows you to have several |
| @@ -587,57 +587,57 @@ Here is a complete list of the variables you may want to set. | |||
| 587 | at which different kinds of machines share the file system | 587 | at which different kinds of machines share the file system |
| 588 | Emacs is installed on. | 588 | Emacs is installed on. |
| 589 | 589 | ||
| 590 | `infodir' indicates where to put the info files distributed with | 590 | 'infodir' indicates where to put the info files distributed with |
| 591 | Emacs; it defaults to `/usr/local/share/info'. | 591 | Emacs; it defaults to '/usr/local/share/info'. |
| 592 | 592 | ||
| 593 | `mandir' indicates where to put the man pages for Emacs and its | 593 | 'mandir' indicates where to put the man pages for Emacs and its |
| 594 | utilities (like `etags'); it defaults to | 594 | utilities (like 'etags'); it defaults to |
| 595 | `/usr/local/share/man/man1'. | 595 | '/usr/local/share/man/man1'. |
| 596 | 596 | ||
| 597 | `prefix' doesn't give a path for any specific part of Emacs; instead, | 597 | 'prefix' doesn't give a path for any specific part of Emacs; instead, |
| 598 | its value is used to determine the defaults for all the | 598 | its value is used to determine the defaults for all the |
| 599 | architecture-independent path variables - `datadir', | 599 | architecture-independent path variables - 'datadir', |
| 600 | `sharedstatedir', `infodir', and `mandir'. Its default value is | 600 | 'sharedstatedir', 'infodir', and 'mandir'. Its default value is |
| 601 | `/usr/local'; the other variables add on `lib' or `man' to it | 601 | '/usr/local'; the other variables add on 'lib' or 'man' to it |
| 602 | by default. | 602 | by default. |
| 603 | 603 | ||
| 604 | For example, suppose your site generally places GNU software | 604 | For example, suppose your site generally places GNU software |
| 605 | under `/usr/users/software/gnusoft' instead of `/usr/local'. | 605 | under '/usr/users/software/gnusoft' instead of '/usr/local'. |
| 606 | By including | 606 | By including |
| 607 | `prefix=/usr/users/software/gnusoft' | 607 | 'prefix=/usr/users/software/gnusoft' |
| 608 | in the arguments to `make', you can instruct the build process | 608 | in the arguments to 'make', you can instruct the build process |
| 609 | to place all of the Emacs data files in the appropriate | 609 | to place all of the Emacs data files in the appropriate |
| 610 | directories under that path. | 610 | directories under that path. |
| 611 | 611 | ||
| 612 | `exec_prefix' serves the same purpose as `prefix', but instead | 612 | 'exec_prefix' serves the same purpose as 'prefix', but instead |
| 613 | determines the default values for the architecture-dependent | 613 | determines the default values for the architecture-dependent |
| 614 | path variables - `bindir' and `libexecdir'. | 614 | path variables - 'bindir' and 'libexecdir'. |
| 615 | 615 | ||
| 616 | The above variables serve analogous purposes in the makefiles for all | 616 | The above variables serve analogous purposes in the makefiles for all |
| 617 | GNU software; the following variables are specific to Emacs. | 617 | GNU software; the following variables are specific to Emacs. |
| 618 | 618 | ||
| 619 | `archlibdir' indicates where Emacs installs and expects the executable | 619 | 'archlibdir' indicates where Emacs installs and expects the executable |
| 620 | files and other architecture-dependent data it uses while | 620 | files and other architecture-dependent data it uses while |
| 621 | running. Its default value, based on `libexecdir' (which | 621 | running. Its default value, based on 'libexecdir' (which |
| 622 | see), is `/usr/local/libexec/emacs/VERSION/CONFIGURATION-NAME' | 622 | see), is '/usr/local/libexec/emacs/VERSION/CONFIGURATION-NAME' |
| 623 | (where VERSION and CONFIGURATION-NAME are as described above). | 623 | (where VERSION and CONFIGURATION-NAME are as described above). |
| 624 | 624 | ||
| 625 | `GZIP_PROG' is the name of the executable that compresses installed info, | 625 | 'GZIP_PROG' is the name of the executable that compresses installed info, |
| 626 | manual, and .el files. It defaults to gzip. Setting it to | 626 | manual, and .el files. It defaults to gzip. Setting it to |
| 627 | the empty string suppresses compression. | 627 | the empty string suppresses compression. |
| 628 | 628 | ||
| 629 | Remember that you must specify any variable values you need each time | 629 | Remember that you must specify any variable values you need each time |
| 630 | you run `make' in the top directory. If you run `make' once to build | 630 | you run 'make' in the top directory. If you run 'make' once to build |
| 631 | emacs, test it, and then run `make' again to install the files, you | 631 | emacs, test it, and then run 'make' again to install the files, you |
| 632 | must provide the same variable settings each time. To make the | 632 | must provide the same variable settings each time. To make the |
| 633 | settings persist, you can edit them into the `Makefile' in the top | 633 | settings persist, you can edit them into the 'Makefile' in the top |
| 634 | directory, but be aware that running the `configure' program erases | 634 | directory, but be aware that running the 'configure' program erases |
| 635 | `Makefile' and rebuilds it from `Makefile.in'. | 635 | 'Makefile' and rebuilds it from 'Makefile.in'. |
| 636 | 636 | ||
| 637 | The path for finding Lisp files is specified in src/epaths.h, | 637 | The path for finding Lisp files is specified in src/epaths.h, |
| 638 | a file which is generated by running configure. To change the path, | 638 | a file which is generated by running configure. To change the path, |
| 639 | you can edit the definition of PATH_LOADSEARCH in that file | 639 | you can edit the definition of PATH_LOADSEARCH in that file |
| 640 | before you run `make'. | 640 | before you run 'make'. |
| 641 | 641 | ||
| 642 | The top-level Makefile stores the variable settings it used in the | 642 | The top-level Makefile stores the variable settings it used in the |
| 643 | Makefiles for the subdirectories, so you don't have to specify them | 643 | Makefiles for the subdirectories, so you don't have to specify them |
| @@ -646,7 +646,7 @@ when running make in the subdirectories. | |||
| 646 | 646 | ||
| 647 | PROBLEMS | 647 | PROBLEMS |
| 648 | 648 | ||
| 649 | See the file `./etc/PROBLEMS' for a list of various problems sometimes | 649 | See the file './etc/PROBLEMS' for a list of various problems sometimes |
| 650 | encountered, and what to do about them. | 650 | encountered, and what to do about them. |
| 651 | 651 | ||
| 652 | This file is part of GNU Emacs. | 652 | This file is part of GNU Emacs. |