diff options
| author | Eli Zaretskii | 2014-03-30 21:55:19 +0300 |
|---|---|---|
| committer | Eli Zaretskii | 2014-03-30 21:55:19 +0300 |
| commit | 34cad8271df666d5f45431dba73eed02b2634657 (patch) | |
| tree | fdcadfb2bcfdb430827b73f1906d38c863336bef | |
| parent | 632e91a6452ee7b56f2153746ad17fa643d512b8 (diff) | |
| download | emacs-34cad8271df666d5f45431dba73eed02b2634657.tar.gz emacs-34cad8271df666d5f45431dba73eed02b2634657.zip | |
nt/INSTALL: Minor fixes.
| -rw-r--r-- | nt/INSTALL | 55 |
1 files changed, 9 insertions, 46 deletions
diff --git a/nt/INSTALL b/nt/INSTALL index e3d7dd072a0..1fe00a37d97 100644 --- a/nt/INSTALL +++ b/nt/INSTALL | |||
| @@ -9,15 +9,15 @@ Windows starting with Windows 2000 and newer. Windows 9X are not | |||
| 9 | supported (but the Emacs binary produced by this build will run on | 9 | supported (but the Emacs binary produced by this build will run on |
| 10 | Windows 9X as well). | 10 | Windows 9X as well). |
| 11 | 11 | ||
| 12 | Do not use this recipe with Cygwin. For building on Cygwin, use the | ||
| 13 | normal installation instructions, ../INSTALL. | ||
| 14 | |||
| 12 | * For the brave (a.k.a. "impatient"): | 15 | * For the brave (a.k.a. "impatient"): |
| 13 | 16 | ||
| 14 | For those who have a working MSYS/MinGW development environment and | 17 | For those who have a working MSYS/MinGW development environment and |
| 15 | are comfortable with running Posix configure scripts, here are the | 18 | are comfortable with running Posix configure scripts, here are the |
| 16 | concise instructions for configuring and building the native Windows | 19 | concise instructions for configuring and building the native Windows |
| 17 | binary of Emacs with these tools. | 20 | binary of Emacs with these tools: |
| 18 | |||
| 19 | Do not use this recipe with Cygwin. For building on Cygwin, use the | ||
| 20 | normal installation instructions, ../INSTALL. | ||
| 21 | 21 | ||
| 22 | 0. Start the MSYS Bash window. Everything else below is done from | 22 | 0. Start the MSYS Bash window. Everything else below is done from |
| 23 | that window's Bash prompt. | 23 | that window's Bash prompt. |
| @@ -49,7 +49,7 @@ Windows 9X as well). | |||
| 49 | You can pass other options to the configure script. Here's a | 49 | You can pass other options to the configure script. Here's a |
| 50 | typical example (for an in-place debug build): | 50 | typical example (for an in-place debug build): |
| 51 | 51 | ||
| 52 | CPPFLAGS='-DGLYPH_DEBUG=1' CFLAGS='-O0 -g3' ./configure --prefix=/d/usr/emacs --enable-checking | 52 | CFLAGS='-O0 -g3' ./configure --prefix=/d/usr/emacs --enable-checking='yes,glyphs' |
| 53 | 53 | ||
| 54 | 3. After the configure script finishes, it should display the | 54 | 3. After the configure script finishes, it should display the |
| 55 | resulting configuration. After that, type | 55 | resulting configuration. After that, type |
| @@ -82,7 +82,7 @@ Windows 9X as well). | |||
| 82 | A correct installation makes all the rest almost trivial; a botched | 82 | A correct installation makes all the rest almost trivial; a botched |
| 83 | installation will likely make you miserable for quite some time. | 83 | installation will likely make you miserable for quite some time. |
| 84 | 84 | ||
| 85 | There are two alternative to installing MinGW + MSYS: using the GUI | 85 | There are two alternatives to installing MinGW + MSYS: using the GUI |
| 86 | installer, called mingw-get, provided by the MinGW project, or | 86 | installer, called mingw-get, provided by the MinGW project, or |
| 87 | manual installation. The next two sections describe each one of | 87 | manual installation. The next two sections describe each one of |
| 88 | these. | 88 | these. |
| @@ -169,7 +169,7 @@ Windows 9X as well). | |||
| 169 | you are building from the repository: | 169 | you are building from the repository: |
| 170 | 170 | ||
| 171 | . Texinfo (needed to produce the Info manuals when building from | 171 | . Texinfo (needed to produce the Info manuals when building from |
| 172 | bzr, and for "make install") | 172 | bzr/git, and for "make install") |
| 173 | 173 | ||
| 174 | Available from http://sourceforge.net/projects/ezwinports/files/. | 174 | Available from http://sourceforge.net/projects/ezwinports/files/. |
| 175 | 175 | ||
| @@ -373,11 +373,11 @@ Windows 9X as well). | |||
| 373 | A few frequently used options are needed when you want to produce an | 373 | A few frequently used options are needed when you want to produce an |
| 374 | unoptimized binary with runtime checks enabled: | 374 | unoptimized binary with runtime checks enabled: |
| 375 | 375 | ||
| 376 | CPPFLAGS='-DGLYPH_DEBUG=1' CFLAGS='-O0 -g3' ./configure --prefix=PREFIX --enable-checking | 376 | CFLAGS='-O0 -g3' ./configure --prefix=PREFIX --enable-checking='yes,glyphs' |
| 377 | 377 | ||
| 378 | Once invoked, the configure script will run for some time, and, if | 378 | Once invoked, the configure script will run for some time, and, if |
| 379 | successful, will eventually produce a summary of the configuration | 379 | successful, will eventually produce a summary of the configuration |
| 380 | like this: | 380 | similar to this: |
| 381 | 381 | ||
| 382 | Configured for `i686-pc-mingw32'. | 382 | Configured for `i686-pc-mingw32'. |
| 383 | 383 | ||
| @@ -724,43 +724,6 @@ Windows 9X as well). | |||
| 724 | You need the libiconv-X.Y.Z-N-mingw32-dev.tar.lzma tarball from that | 724 | You need the libiconv-X.Y.Z-N-mingw32-dev.tar.lzma tarball from that |
| 725 | site. | 725 | site. |
| 726 | 726 | ||
| 727 | * Experimental SVG support | ||
| 728 | |||
| 729 | To compile with SVG, you will need pkg-config to be installed, as | ||
| 730 | the configure script invokes pkg-config to find out which compiler | ||
| 731 | switches to use for SVG. See above for the URL where you can find | ||
| 732 | pkg-config for Windows. | ||
| 733 | |||
| 734 | SVG support is currently experimental, and not built by default. | ||
| 735 | Specify --with-rsvg and ensure you have all the dependencies in your | ||
| 736 | include path. Unless you have built a minimalist librsvg yourself | ||
| 737 | (untested), librsvg depends on a significant chunk of GTK+ to build, | ||
| 738 | plus a few Gnome libraries, libxml2, libbz2 and zlib at runtime. The | ||
| 739 | easiest way to obtain the dependencies required for building is to | ||
| 740 | download a pre-bundled GTK+ development environment for Windows. | ||
| 741 | |||
| 742 | To use librsvg at runtime, ensure that librsvg and its dependencies | ||
| 743 | are on your PATH. If you didn't build librsvg yourself, you will | ||
| 744 | need to check with where you downloaded it from for the | ||
| 745 | dependencies, as there are different build options. If it is a | ||
| 746 | short list, then it most likely only lists the immediate | ||
| 747 | dependencies of librsvg, but the dependencies themselves have | ||
| 748 | dependencies - so don't download individual libraries from GTK+, | ||
| 749 | download and install the whole thing. If you think you've got all | ||
| 750 | the dependencies and SVG support is still not working, check your | ||
| 751 | PATH for other libraries that shadow the ones you downloaded. | ||
| 752 | Libraries of the same name from different sources may not be | ||
| 753 | compatible, this problem was encountered with libbzip2 from GnuWin32 | ||
| 754 | with libcroco from gnome.org. | ||
| 755 | |||
| 756 | If you can see etc/images/splash.svg, then you have managed to get | ||
| 757 | SVG support working. Congratulations for making it through DLL hell | ||
| 758 | to this point. You'll probably find that some SVG images crash | ||
| 759 | Emacs. Problems have been observed in some images that contain | ||
| 760 | text, they seem to be a problem in the Windows port of Pango, or | ||
| 761 | maybe a problem with the way Cairo or librsvg is using it that | ||
| 762 | doesn't show up on other platforms. | ||
| 763 | |||
| 764 | 727 | ||
| 765 | This file is part of GNU Emacs. | 728 | This file is part of GNU Emacs. |
| 766 | 729 | ||