X-Git-Url: http://git.hcoop.net/bpt/emacs.git/blobdiff_plain/94eb8e0a5ac97228c17d2ec3260d3c6ca46999e2..58c7641d1b069be3ead47dbe4a44c8360ef8d1f2:/INSTALL diff --git a/INSTALL b/INSTALL index 5c6bc0b97d..4716bbecf9 100644 --- a/INSTALL +++ b/INSTALL @@ -280,6 +280,12 @@ You can tell configure where to search for GTK by specifying `--with-pkg-config-prog=PATH' where PATH is the pathname to pkg-config. Note that GTK version 2.6 or newer is required for Emacs. +Emacs will autolaunch a D-Bus session bus, when the environment +variable DISPLAY is set, but no session bus is running. This might be +inconvenient for Emacs when running as daemon or running via a remote +ssh connection. In order to completely prevent the use of D-Bus, configure +Emacs with the options `--without-dbus --without-gconf --without-gsettings'. + The Emacs mail reader RMAIL is configured to be able to read mail from a POP3 server by default. Versions of the POP protocol older than POP3 are not supported. For Kerberos-authenticated POP add @@ -313,6 +319,22 @@ systems which support that. Use --without-sound to disable sound support. +Use --without-all if you want to build a small executable with the minimal +dependencies on external libraries, at the cost of disabling most of the +features that are normally enabled by default. Using --without-all is +equivalent to --without-sound --without-dbus --without-libotf +--without-selinux --without-xft --without-gsettings --without-gnutls +--without-rsvg --without-xml2 --without-gconf --without-imagemagick +--without-m17n-flt --without-jpeg --without-tiff --without-gif +--without-png --without-gpm. Note that --without-all leaves X support +enabled, and using the GTK2 or GTK3 toolkit creates a lot of library +dependencies. So if you want to build a small executable with very basic +X support, use --without-all --with-x-toolkit=no. For the smallest possible +executable without X, use --without-all --without-x. If you want to build +with just a few features enabled, you can combine --without-all with +--with-FEATURE. For example, you can use --without-all --with-dbus +to build with DBus support and nothing more. + Use --with-wide-int to implement Emacs values with the type 'long long', even on hosts where a narrower type would do. With this option, on a typical 32-bit host, Emacs integers have 62 bits instead of 30. @@ -667,25 +689,15 @@ running the `configure' program, you have to perform the following steps. 1) Copy `./src/config.in' to `./src/config.h'. -2) Consult `./etc/MACHINES' to see what configuration name you should -use for your system. Look at the code of the `configure' script to -see which operating system and architecture description files from -`src/s' and `src/m' should be used for that configuration name. Edit -`src/config.h', and change the two `#include' directives to include -the appropriate system and architecture description files. - -2) Edit `./src/config.h' to set the right options for your system. If -you need to override any of the definitions in the s/*.h and m/*.h -files for your system and machine, do so by editing config.h, not by -changing the s/*.h and m/*.h files. +2) Edit `./src/config.h' to set the right options for your system. 3) Create `Makefile' files in various directories from the corresponding `Makefile.in' files. This isn't so hard, just a matter of editing in appropriate substitutions for the @...@ constructs. -The `configure' script is built from `configure.in' by the `autoconf' -program. You need at least the version of autoconf specified in the -AC_PREREQ(...) command to rebuild `configure' from `configure.in'. +The `configure' script is built from `configure.ac' by the +`autogen.sh' script, which checks that `autoconf' and other build +tools are sufficiently up to date and then runs the build tools. BUILDING GNU EMACS BY HAND