mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-29 00:31:01 -08:00
Code Issues Projects Releases Wiki Activity

Remove ever expanding versions of Windows. Shorten FAQ URL. Remove

Browse source 
mention of obsolete lock directory.  Windows distribution now bin and
barebin only.  Add note about SVG support.  Remove old tar and gzip
problem workarounds.  Use new (22.x) -Q option.  Report all bugs through
bug tracker.
This commit is contained in:
Jason Rumney 2009-02-23 13:17:21 +00:00
parent 9b0587538e
commit 3deb93c663
2 changed files with 73 additions and 72 deletions
Download patch file Download diff file Expand all files Collapse all files

14
admin/ChangeLog
View file

@ -1,3 +1,17 @@
2009-02-23 Jason Rumney <jasonr@gnu.org>
* nt/README-ftp-server: Update for 23.0.91
* nt/README.W32: Remove ever expanding versions of
Windows. Shorten FAQ URL. Remove mention of obsolete lock
directory. Windows distribution now bin and barebin only. Add
note about SVG support. Remove old tar and gzip problem
workarounds. Use new (22.x) -Q option. Report all bugs through
bug tracker.
* nt/README-UNDUMP.W32: Modify for barebin distribution, as
undumped distribution no longer exists.
2009-02-05 Yu-ji Hosokawa <yu-ji@hoso.net> (tiny change)
* nt/README.W32: Fix typo. (Bug#2207)

131
admin/nt/README.W32
View file

@ -4,62 +4,61 @@ See the end of the file for license conditions.
Emacs for Windows
This README file describes how to set up and run a precompiled version
of GNU Emacs for Windows NT/2000/XP and Windows 95/98/Me. This
distribution can be found on the ftp.gnu.org server and its mirrors:
This README file describes how to set up and run a precompiled
version of GNU Emacs for Windows. This distribution can be found on
the ftp.gnu.org server and its mirrors:
ftp://ftp.gnu.org/gnu/emacs/windows/
This server contains other distributions, including the full Emacs
source distribution and the lisp source distribution, as well as older
releases of Emacs for Windows.
source distribution and a barebin distribution which can be installed
over it, as well as older releases of Emacs for Windows.
Answers to frequently asked questions, and further information about
this port of GNU Emacs and related software packages can be found via
http:
http://www.gnu.org/software/emacs/windows/ntemacs.html
http://www.gnu.org/software/emacs/windows/
* Preliminaries
Along with this file should be six subdirectories (bin, etc, info,
lisp, lock, site-lisp). Depending on which distribution you have
installed, the lisp subdirectory might contain both the lisp source
(*.el) and compiled lisp files (*.elc), or just the compiled lisp
files. If you don't have the lisp source files, you can obtain them
by downloading the lisp source distribution or the full source
distribution from the ftp site mentioned above.
Along with this file should be five subdirectories (bin, etc, info,
lisp, site-lisp). If you have downloaded the barebin distribution,
then it will contain only the bin directory and the built in
documentation in etc/DOC-X, the rest of the subdirectories are in
the src distribution, which the barebin distribution is designed to
be used with.
* Setting up Emacs
To install Emacs, simply unpack all the files into a directory of your
choice, but note that you might encounter minor problems if there is a
space anywhere in the directory name. To complete the installation
process, you can optionally run the program addpm.exe in the bin
subdirectory. This will add some entries to the registry that tell
Emacs where to find its support files, and put an icon for Emacs in
the Start Menu under "Start -> Programs -> Gnu Emacs -> Emacs".
To install Emacs, simply unpack all the files into a directory of
your choice, but note that you might encounter minor problems if
there is a space anywhere in the directory name. To complete the
installation process, you can optionally run the program addpm.exe
in the bin subdirectory. This will put an icon for Emacs in the
Start Menu under "Start -> Programs -> Gnu Emacs".
Some users have reported that the Start Menu item is not created for
them. If this happens, just create your own shortcut to runemacs.exe,
eg. by dragging it on to the desktop or the Start button.
Note that running addpm is now an optional step; Emacs is able to
locate all of its files without needing the information to be set in
the environment or the registry, although such settings will still be
obeyed if present. This is convenient for running Emacs on a machine
which disallows registry changes, or on which software should not be
installed. For instance, you can now run Emacs directly from a CD
without copying or installing anything on the machine itself.
locate all of its files without needing any information to be set in
the environment or the registry, although such settings will still
be obeyed if present. This is convenient for running Emacs on a
machine which disallows registry changes, or on which software
should not be installed. For instance, you can now run Emacs
directly from a CD or USB flash drive without copying or installing
anything on the machine itself.
* Starting Emacs
To run Emacs, simply select Emacs from the Start Menu, or invoke
runemacs.exe directly from Explorer or a command prompt. This will
start Emacs in its default GUI mode, ready to use. If you have never
used Emacs before, you should follow the tutorial at this point
(select Emacs Tutorial from the Help menu), since Emacs is quite
different from ordinary Windows applications in many respects.
runemacs.exe directly from Explorer or from a command prompt. This
will start Emacs in its default GUI mode, ready to use. If you have
never used Emacs before, you should follow the tutorial at this
point (select Emacs Tutorial from the Help menu), since Emacs is
quite different from ordinary Windows applications in many respects.
If you want to use Emacs in tty or character mode within a command
window, you can start it by typing "emacs -nw" at the command prompt.
@ -108,7 +107,7 @@ See the end of the file for license conditions.
`Movemail' node of the Emacs manual.
+ digest-doc.exe, sorted-doc.exe - Tools for rebuilding the
built-in documentation.
built-in documentation.
* Image support
@ -138,18 +137,24 @@ See the end of the file for license conditions.
GIF: requires libungif or giflib 4.1 or later, which will be
called giflib4.dll, libungif4.dll or libungif.dll.
In addition, Emacs can be compiled to support SVG. This precompiled
distribution has not been compiled that way, since the SVG library
or one or more of its extensive dependencies appear to be
unreliable under Windows. See nt/INSTALL in the src distribution if
you wish to compile Emacs with SVG support.
* Uninstalling Emacs
If you should need to uninstall Emacs, simply delete all the files and
subdirectories from the directory where it was unpacked (Emacs does
not install or update any files in system directories or anywhere
else). If you ran the addpm.exe program to create the registry
entries and the Start menu icon, then you can remove the registry
entries using regedit. All of the settings are written under the
Software\GNU\Emacs key in HKEY_LOCAL_MACHINE, or if you didn't have
administrator privileges, the same key in HKEY_CURRENT_USER. Just
delete the Software\GNU\Emacs key.
If you should need to uninstall Emacs, simply delete all the files
and subdirectories from the directory where it was unpacked (Emacs
does not install or update any files in system directories or
anywhere else). If you ran the addpm.exe program to create the
registry entries and the Start menu icon, then you can remove the
registry entries using regedit. All of the settings are written
under the Software\GNU\Emacs key in HKEY_LOCAL_MACHINE, or if you
didn't have administrator privileges when you installed, the same
key in HKEY_CURRENT_USER. Just delete the whole Software\GNU\Emacs
key.
The Start menu entry can be removed by right-clicking on the Task bar
and selecting Properties, then using the Remove option on the Start
@ -162,12 +167,10 @@ See the end of the file for license conditions.
Unpacking the distributions
If you encounter trouble trying to run Emacs, there are a number of
possible causes. If you didn't use the versions of tar and gunzip (or
djtarnt) on the above ftp site, it is possible that the distribution
became corrupted while it was being unpacked. Check the following for
indications that the distribution was not corrupted:
possible causes. Check the following for indications that the
distribution was not corrupted by the tools used to unpack it:
* Be sure to disable the CR/LF translation or the executables will
* Be sure to disable CR/LF translation or the executables will
be unusable. Older versions of WinZipNT would enable this
translation by default. If you are using WinZipNT, disable it.
(I don't have WinZipNT myself, and I do not know the specific
@ -178,14 +181,6 @@ See the end of the file for license conditions.
truncated to abbrevli.elc, your distribution has been corrupted
while unpacking and Emacs will not start.
* Users have said that some utilities (WinZip again?) don't create
the lock subdirectory. You can create the lock directory by hand
(it is normally empty).
* Users have also reported that the gnu-win32 tar corrupts the
executables. Use the version of tar or djtarnt on the ftp.gnu.org
site instead.
If you believe you have unpacked the distributions correctly and are
still encountering problems, see the section on Further Information
below.
@ -203,7 +198,7 @@ See the end of the file for license conditions.
your favorite web browser to following the document (if you haven't
already):
http://www.gnu.org/software/emacs/windows/ntemacs.html
http://www.gnu.org/software/emacs/windows/
This document serves as an FAQ and a source for further information
about the Windows port and related software packages.
@ -240,24 +235,16 @@ See the end of the file for license conditions.
about it. First check the FAQ on the web page above to see if the bug
is already known and if there are any workarounds. Then check whether
the bug has something to do with code in your .emacs file, e.g. by
invoking Emacs with the "-q --no-site-file" options.
invoking Emacs with the "-Q" option.
If you decide that it is a bug in Emacs that might be specific to the
Windows port, send a message to the "help-emacs-windows@gnu.org"
mailing list describing the bug, the version of Emacs that you are
using, and the operating system that you are running on (Windows NT,
2000, 95, 98, etc. including service pack level if known). If the bug
is related to subprocesses, also specify which shell you are using
(e.g., include the values of `shell-file-name' and
`shell-explicit-file-name' in your message).
If you think the bug is not specific to the Windows port of Emacs,
then it is better to mail the bug report to "bug-gnu-emacs@gnu.org" so
that it will be seen by the right people. If Emacs has been set up to
send mail, you can use the command M-x report-emacs-bug to create and
send the bug report, but in some cases there is a function to report
bugs in a specific package; e.g. M-x gnus-bug for Gnus, M-x
c-submit-bug-report for C/C++/Java mode, etc.
If you decide that it is a bug in Emacs, use the built in bug
reporting facility to report it (from the menu; Help -> Send Bug Report).
If you have not yet configured Emacs for mail, then when you press
C-c C-c to send the report, it will ask you to paste the text of the
report into your mail client. If the bug is related to
subprocesses, also specify which shell you are using (e.g., include
the values of `shell-file-name' and `shell-explicit-file-name' in
your message).
Enjoy!