annotate nt/README.W32 @ 109783:43f98127e0f3

Typo fix "hoo4a" -> "hook". From Ted Zlatanov <tzz@lifelogs.com>. * gnus-sync.el (gnus-sync-install-hooks): Typo fix.
author Katsumi Yamaoka <yamaoka@jpl.org>
date Sat, 14 Aug 2010 22:14:02 +0000
parents 1277fe6717c9
children 1b2674e70efe 1529ab88805c
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
106815
1d1d5d9bd884 Add 2010 to copyright years.
Glenn Morris <rgm@gnu.org>
parents: 102252
diff changeset
1 Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
79967
297013ef0ae4 Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents: 79142
diff changeset
2 Free Software Foundation, Inc.
297013ef0ae4 Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents: 79142
diff changeset
3 See the end of the file for license conditions.
297013ef0ae4 Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents: 79142
diff changeset
4
50662
017ff76022bd Remove personal email address and update wording.
Andrew Innes <andrewi@gnu.org>
parents: 50661
diff changeset
5 Emacs for Windows
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
6
102217
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
7 This README file describes how to set up and run a precompiled
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
8 version of GNU Emacs for Windows. This distribution can be found on
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
9 the ftp.gnu.org server and its mirrors:
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
10
69705
296901e2dded updated link(s)
Ramprasad B <ramprasad_i82@yahoo.com>
parents: 50662
diff changeset
11 ftp://ftp.gnu.org/gnu/emacs/windows/
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
12
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
13 This server contains other distributions, including the full Emacs
102217
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
14 source distribution and a barebin distribution which can be installed
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
15 over it, as well as older releases of Emacs for Windows.
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
16
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
17 Answers to frequently asked questions, and further information about
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
18 this port of GNU Emacs and related software packages can be found via
69705
296901e2dded updated link(s)
Ramprasad B <ramprasad_i82@yahoo.com>
parents: 50662
diff changeset
19 http:
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
20
102217
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
21 http://www.gnu.org/software/emacs/windows/
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
22
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
23 * Preliminaries
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
24
102252
d154d78e56fb Fix last change.
Eli Zaretskii <eliz@gnu.org>
parents: 102238
diff changeset
25 Along with this file should be six subdirectories (bin, etc, info,
d154d78e56fb Fix last change.
Eli Zaretskii <eliz@gnu.org>
parents: 102238
diff changeset
26 lisp, leim, site-lisp). If you have downloaded the barebin
d154d78e56fb Fix last change.
Eli Zaretskii <eliz@gnu.org>
parents: 102238
diff changeset
27 distribution, then it will contain only the bin directory and the
d154d78e56fb Fix last change.
Eli Zaretskii <eliz@gnu.org>
parents: 102238
diff changeset
28 built in documentation in etc/DOC-X, the rest of the subdirectories
d154d78e56fb Fix last change.
Eli Zaretskii <eliz@gnu.org>
parents: 102238
diff changeset
29 are in the src distribution, which the barebin distribution is
d154d78e56fb Fix last change.
Eli Zaretskii <eliz@gnu.org>
parents: 102238
diff changeset
30 designed to be used with.
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
31
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
32 * Setting up Emacs
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
33
102217
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
34 To install Emacs, simply unpack all the files into a directory of
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
35 your choice, but note that you might encounter minor problems if
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
36 there is a space anywhere in the directory name. To complete the
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
37 installation process, you can optionally run the program addpm.exe
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
38 in the bin subdirectory. This will put an icon for Emacs in the
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
39 Start Menu under "Start -> Programs -> Gnu Emacs".
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
40
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
41 Some users have reported that the Start Menu item is not created for
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
42 them. If this happens, just create your own shortcut to runemacs.exe,
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
43 eg. by dragging it on to the desktop or the Start button.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
44
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
45 Note that running addpm is now an optional step; Emacs is able to
102217
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
46 locate all of its files without needing any information to be set in
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
47 the environment or the registry, although such settings will still
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
48 be obeyed if present. This is convenient for running Emacs on a
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
49 machine which disallows registry changes, or on which software
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
50 should not be installed. For instance, you can now run Emacs
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
51 directly from a CD or USB flash drive without copying or installing
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
52 anything on the machine itself.
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
53
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
54 * Starting Emacs
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
55
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
56 To run Emacs, simply select Emacs from the Start Menu, or invoke
102217
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
57 runemacs.exe directly from Explorer or from a command prompt. This
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
58 will start Emacs in its default GUI mode, ready to use. If you have
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
59 never used Emacs before, you should follow the tutorial at this
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
60 point (select Emacs Tutorial from the Help menu), since Emacs is
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
61 quite different from ordinary Windows applications in many respects.
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
62
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
63 If you want to use Emacs in tty or character mode within a command
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
64 window, you can start it by typing "emacs -nw" at the command prompt.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
65 (Obviously, you need to ensure that the Emacs bin subdirectory is in
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
66 your PATH first, or specify the path to emacs.exe.) The -nw
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
67 (non-windowed) mode of operation is most useful if you have a telnet
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
68 server on your machine, allowing you to run Emacs remotely.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
69
79982
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
70 * EXE files included
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
71
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
72 Emacs comes with the following executable files in the bin directory.
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
73
102238
df4c10114523 * nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents: 102217
diff changeset
74 + emacs.exe - The main Emacs executable. As this is designed to run
79982
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
75 as both a text-mode application (emacs -nw) and as a GUI application,
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
76 it will pop up a command prompt window if run directly from Explorer.
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
77
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
78 + runemacs.exe - A wrapper for running Emacs as a GUI application
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
79 without popping up a command prompt window.
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
80
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
81 + emacsclient.exe - A command-line client program that can
102238
df4c10114523 * nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents: 102217
diff changeset
82 communicate with a running Emacs process. See the `Emacs Server'
101819
aa1eb92e5930 * nt/README.W32: Fix typo. (Bug#2207)
Juanma Barranquero <lekktu@gmail.com>
parents: 100971
diff changeset
83 node of the Emacs manual.
79982
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
84
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
85 + emacsclientw.exe - A version of emacsclient that does not open
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
86 a command-line window.
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
87
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
88 + addpm.exe - A basic installer that creates Start Menu icons for Emacs.
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
89 Running this is optional.
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
90
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
91 + cmdproxy.exe - Used internally by Emacs to work around problems with
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
92 the native shells in various versions of Windows.
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
93
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
94 + ctags.exe, etags.exe - Tools for generating tag files. See the
102238
df4c10114523 * nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents: 102217
diff changeset
95 `Tags' node of the Emacs manual.
79982
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
96
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
97 + ebrowse.exe - A tool for generating C++ browse information. See the
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
98 `Ebrowse' manual.
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
99
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
100 + ddeclient.exe - A tool for interacting with DDE servers.
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
101
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
102 + hexl.exe - A tool for converting files to hex dumps. See the
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
103 `Editing Binary Files' node of the Emacs manual.
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
104
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
105 + movemail.exe - A helper application for safely moving mail from
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
106 a mail spool or POP server to a local user mailbox. See the
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
107 `Movemail' node of the Emacs manual.
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
108
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
109 + digest-doc.exe, sorted-doc.exe - Tools for rebuilding the
102217
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
110 built-in documentation.
79982
416c1a9b8012 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79979
diff changeset
111
79142
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
112 * Image support
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
113
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
114 Emacs has built in support for XBM and PPM/PGM/PBM images, and the
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
115 libXpm library is bundled, providing XPM support (required for color
102238
df4c10114523 * nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents: 102217
diff changeset
116 toolbar icons and splash screen). Source for libXpm should be available
df4c10114523 * nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents: 102217
diff changeset
117 on the same place as you got this binary distribution from. The version
79979
643c20b8a0de Add note about obtaining libXpm source, and its origin.
Jason Rumney <jasonr@gnu.org>
parents: 79967
diff changeset
118 of libXpm bundled with this version of Emacs is 3.5.7, based on x.org's
643c20b8a0de Add note about obtaining libXpm source, and its origin.
Jason Rumney <jasonr@gnu.org>
parents: 79967
diff changeset
119 libXpm library from X11R7.3.
79142
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
120
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
121 Emacs can also support some other image formats with appropriate
102238
df4c10114523 * nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents: 102217
diff changeset
122 libraries. These libraries are all available as part of GTK, or from
df4c10114523 * nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents: 102217
diff changeset
123 gnuwin32.sourceforge.net. Emacs will find them if the directory they
79142
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
124 are installed in is on the PATH.
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
125
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
126 PNG: requires the PNG reference library 1.2 or later, which will
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
127 be named libpng13d.dll, libpng13.dll, libpng12d.dll, libpng12.dll
102238
df4c10114523 * nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents: 102217
diff changeset
128 or libpng.dll. LibPNG requires zlib, which should come from the same
79142
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
129 source as you got libpng.
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
130
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
131 JPEG: requires the Independant JPEG Group's libjpeg 6b or later,
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
132 which will be called jpeg62.dll, libjpeg.dll, jpeg-62.dll or jpeg.dll.
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
133
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
134 TIFF: requires libTIFF 3.0 or later, which will be called libtiff3.dll
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
135 or libtiff.dll.
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
136
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
137 GIF: requires libungif or giflib 4.1 or later, which will be
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
138 called giflib4.dll, libungif4.dll or libungif.dll.
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
139
102238
df4c10114523 * nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents: 102217
diff changeset
140 In addition, Emacs can be compiled to support SVG. This precompiled
102217
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
141 distribution has not been compiled that way, since the SVG library
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
142 or one or more of its extensive dependencies appear to be
102238
df4c10114523 * nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents: 102217
diff changeset
143 unreliable under Windows. See nt/INSTALL in the src distribution if
102217
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
144 you wish to compile Emacs with SVG support.
79142
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
145
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
146 * Uninstalling Emacs
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
147
102217
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
148 If you should need to uninstall Emacs, simply delete all the files
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
149 and subdirectories from the directory where it was unpacked (Emacs
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
150 does not install or update any files in system directories or
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
151 anywhere else). If you ran the addpm.exe program to create the
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
152 registry entries and the Start menu icon, then you can remove the
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
153 registry entries using regedit. All of the settings are written
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
154 under the Software\GNU\Emacs key in HKEY_LOCAL_MACHINE, or if you
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
155 didn't have administrator privileges when you installed, the same
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
156 key in HKEY_CURRENT_USER. Just delete the whole Software\GNU\Emacs
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
157 key.
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
158
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
159 The Start menu entry can be removed by right-clicking on the Task bar
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
160 and selecting Properties, then using the Remove option on the Start
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
161 Menu Programs page. (If you installed under an account with
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
162 administrator privileges, then you need to click the Advanced button
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
163 and look for the Gnu Emacs menu item under All Users.)
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
164
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
165 * Troubleshooting
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
166
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
167 Unpacking the distributions
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
168
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
169 If you encounter trouble trying to run Emacs, there are a number of
102217
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
170 possible causes. Check the following for indications that the
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
171 distribution was not corrupted by the tools used to unpack it:
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
172
102217
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
173 * Be sure to disable CR/LF translation or the executables will
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
174 be unusable. Older versions of WinZipNT would enable this
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
175 translation by default. If you are using WinZipNT, disable it.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
176 (I don't have WinZipNT myself, and I do not know the specific
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
177 commands necessary to disable it.)
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
178
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
179 * Check that filenames were not truncated to 8.3. For example,
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
180 there should be a file lisp\abbrevlist.elc; if this has been
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
181 truncated to abbrevli.elc, your distribution has been corrupted
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
182 while unpacking and Emacs will not start.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
183
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
184 If you believe you have unpacked the distributions correctly and are
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
185 still encountering problems, see the section on Further Information
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
186 below.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
187
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
188 Virus scanners
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
189
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
190 Some virus scanners interfere with Emacs' use of subprocesses. If you
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
191 are unable to use subprocesses and you use Dr. Solomon's WinGuard or
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
192 McAfee's Vshield, turn off "Scan all files" (WinGuard) or "boot sector
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
193 scanning" (McAfee exclusion properties).
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
194
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
195 * Further information
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
196
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
197 If you have access to the World Wide Web, I would recommend pointing
102238
df4c10114523 * nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents: 102217
diff changeset
198 your favorite web browser to the following document (if you haven't
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
199 already):
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
200
102217
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
201 http://www.gnu.org/software/emacs/windows/
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
202
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
203 This document serves as an FAQ and a source for further information
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
204 about the Windows port and related software packages.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
205
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
206 In addition to the FAQ, there is a mailing list for discussing issues
41243
ade47df15864 Update for Emacs 21, including the mailing list info.
Eli Zaretskii <eliz@gnu.org>
parents: 39011
diff changeset
207 related to the Windows port of Emacs. For information about the
ade47df15864 Update for Emacs 21, including the mailing list info.
Eli Zaretskii <eliz@gnu.org>
parents: 39011
diff changeset
208 list, see this Web page:
ade47df15864 Update for Emacs 21, including the mailing list info.
Eli Zaretskii <eliz@gnu.org>
parents: 39011
diff changeset
209
69705
296901e2dded updated link(s)
Ramprasad B <ramprasad_i82@yahoo.com>
parents: 50662
diff changeset
210 http://lists.gnu.org/mailman/listinfo/help-emacs-windows
41243
ade47df15864 Update for Emacs 21, including the mailing list info.
Eli Zaretskii <eliz@gnu.org>
parents: 39011
diff changeset
211
ade47df15864 Update for Emacs 21, including the mailing list info.
Eli Zaretskii <eliz@gnu.org>
parents: 39011
diff changeset
212 To ask questions on the mailing list, send email to
ade47df15864 Update for Emacs 21, including the mailing list info.
Eli Zaretskii <eliz@gnu.org>
parents: 39011
diff changeset
213 help-emacs-windows@gnu.org. (You don't need to subscribe for that.)
ade47df15864 Update for Emacs 21, including the mailing list info.
Eli Zaretskii <eliz@gnu.org>
parents: 39011
diff changeset
214 To subscribe to the list or unsubscribe from it, fill the form you
69705
296901e2dded updated link(s)
Ramprasad B <ramprasad_i82@yahoo.com>
parents: 50662
diff changeset
215 find at http://lists.gnu.org/mailman/listinfo/help-emacs-windows as
41243
ade47df15864 Update for Emacs 21, including the mailing list info.
Eli Zaretskii <eliz@gnu.org>
parents: 39011
diff changeset
216 explained there.
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
217
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
218 Another valuable source of information and help which should not be
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
219 overlooked is the various Usenet news groups dedicated to Emacs.
102238
df4c10114523 * nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents: 102217
diff changeset
220 These are particularly good for help with general issues which aren't
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
221 specific to the Windows port of Emacs. The main news groups to use
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
222 for seeking help are:
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
223
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
224 gnu.emacs.help
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
225 comp.emacs
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
226
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
227 There are also fairly regular postings and announcements of new or
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
228 updated Emacs packages on this group:
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
229
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
230 gnu.emacs.sources
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
231
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
232 * Reporting bugs
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
233
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
234 If you encounter a bug in this port of Emacs, we would like to hear
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
235 about it. First check the FAQ on the web page above to see if the bug
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
236 is already known and if there are any workarounds. Then check whether
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
237 the bug has something to do with code in your .emacs file, e.g. by
102217
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
238 invoking Emacs with the "-Q" option.
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
239
102217
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
240 If you decide that it is a bug in Emacs, use the built in bug
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
241 reporting facility to report it (from the menu; Help -> Send Bug Report).
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
242 If you have not yet configured Emacs for mail, then when you press
e368bec025a6 Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents: 101819
diff changeset
243 C-c C-c to send the report, it will ask you to paste the text of the
102238
df4c10114523 * nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents: 102217
diff changeset
244 report into your mail client. If the bug is related to subprocesses,
df4c10114523 * nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents: 102217
diff changeset
245 also specify which shell you are using (e.g., include the values of
df4c10114523 * nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents: 102217
diff changeset
246 `shell-file-name' and `explicit-shell-file-name' in your message).
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
247
50661
e2a7895c7934 Remove personal email address.
Andrew Innes <andrewi@gnu.org>
parents: 42926
diff changeset
248 Enjoy!
79967
297013ef0ae4 Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents: 79142
diff changeset
249
297013ef0ae4 Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents: 79142
diff changeset
250
297013ef0ae4 Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents: 79142
diff changeset
251 This file is part of GNU Emacs.
297013ef0ae4 Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents: 79142
diff changeset
252
94830
21e11734e56b Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 79982
diff changeset
253 GNU Emacs is free software: you can redistribute it and/or modify
79967
297013ef0ae4 Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents: 79142
diff changeset
254 it under the terms of the GNU General Public License as published by
94830
21e11734e56b Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 79982
diff changeset
255 the Free Software Foundation, either version 3 of the License, or
21e11734e56b Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 79982
diff changeset
256 (at your option) any later version.
79967
297013ef0ae4 Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents: 79142
diff changeset
257
297013ef0ae4 Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents: 79142
diff changeset
258 GNU Emacs is distributed in the hope that it will be useful,
297013ef0ae4 Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents: 79142
diff changeset
259 but WITHOUT ANY WARRANTY; without even the implied warranty of
297013ef0ae4 Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents: 79142
diff changeset
260 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
297013ef0ae4 Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents: 79142
diff changeset
261 GNU General Public License for more details.
297013ef0ae4 Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents: 79142
diff changeset
262
297013ef0ae4 Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents: 79142
diff changeset
263 You should have received a copy of the GNU General Public License
94830
21e11734e56b Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 79982
diff changeset
264 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.