-*- mode:outline -*-

This file describes various problems that have been encountered in
running XEmacs on Windows 95, 98 and NT. It has been updated for
XEmacs 21.0.

This is the first release of XEmacs on Windows. In testing it has
proved to be extremely stable in general use (but see the gnus and
subprocess problems below), but not all features or packages work
correctly yet.

Use `C-c C-f' to move to the next equal level of outline, and
`C-c C-b' to move to previous equal level.  `C-h m' will give more
info about the Outline mode.

Also, Try finding the things you need using one of the search commands
XEmacs provides (e.g. `C-s').

General advice:
    Remember your .emacs file! ~\.emacs is your Emacs init file.  If
    you observe strange problems, invoke XEmacs with the `-q' option
    and see if you can repeat the problem.


* Problems with running XEmacs
==============================
** Conflicts with FSF NTEmacs

Depending on how it is installed, FSF NTEmacs may setup various EMACS*
variables in your environment. The presence of these variables may
cause XEmacs to fail at startup, cause you to see corrupted
doc-strings, or cause other random problems.

You should remove these variables from your environment. These
variables are not required to run FSF NTEmacs if you start it by
running emacs.bat.

** XEmacs can't find my .emacs file

XEmacs looks for your .emacs in your "home" directory. XEmacs decides
that your "home" directory is, in order of preference:
	
- The value of the HOME environment variable, if the variable exists.
- The value of the HOMEDRIVE and HOMEPATH environment variables, if
  these variables both exist.
- The directory that XEmacs was started from.

** XEmacs can't find any packages

XEmacs looks for your packages in subdirectories of a directory which
is set at compile-time, and defaults to C:\Program Files\XEmacs. The
variable configure-package-path holds the actual path that was
compiled into your copy of XEmacs.

The compile-time default location can be overridden by the
EMACSPACKAGEPATH environment variable or by the
SOFTWARE\GNU\XEmacs\EMACSPACKAGEPATH registry entry. You should check
that these variables, if they exist, point to the actual location of
your package tree.

** XEmacs sometimes crashes when using gnus

This is a known bug in this release of XEmacs on Windows.

If you want to use gnus anyway, you should minimize any possible data
loss by saving any modified buffers before you start and ensuring that
you haven't set gnus-use-dribble-file to nil or disabled the normal
XEmacs auto-save mechanism.

** XEmacs doesn't die when shutting down Windows 95 or 98

When shutting down Windows 95 or 98 you may see a dialog that says
  "xemacs / You must quit this program before you quit Windows".
It is safe to
  "Click OK to quit the program and Windows",
but you won't be offered a chance to save any modified XEmacs buffers.

* Look and feel
===============
** Key bindings

The C-z, C-x, C-c, and C-v keystrokes have traditional uses in both
emacs and Windows programs. XEmacs binds these keys to their
traditional emacs uses, and provides Windows 3.x style bindings for
the Cut, Copy and Paste functions.

	Function	XEmacs binding
	--------	--------------
	Undo		C-_
	Cut		Sh-Del
 	Copy		C-Insert
	Paste		Sh-Insert

You can rebind keys to make XEmacs more Windows-compatible; for
example, to bind C-z to undo:

       (global-set-key [(control z)] 'undo)

Rebindind C-x and C-c is trickier because by default these are prefix
keys in XEmacs. See the "Key Bindings" node in the XEmacs manual.

** Behavior of selected regions

Selected regions behave differently in XEmacs from typical Windows
programs. The pc-select package provides various functions to enable
the standard Windows behavior for selected regions (eg mark via
shift-arrow, self-inserting deletes region, etc).

** Limitations on the use of the AltGr key.

In some locale and OS combinations you can't generate M-AltGr-key or
C-M-AltGr-key sequences at all.

To generate C-AltGr-key or C-M-AltGr-key sequences you must use the
right-hand Control key and you must press it *after* AltGr.

These limitations arise from fundamental problems in the way that the
win32 API reports AltGr key events. There isn't anything that XEmacs
can do to work round these problems that it isn't already doing.

You may want to create alternative bindings if any of the standard
XEmacs bindings require you to use some combination of Control or Meta
and AltGr.


* Features not fully supported in this release
==============================================
** Limited support for subprocesses

Attempting to use call-process to run a 16bit program gives a
"Spawning child process: Exec format error". For example shell-command
fails under Windows 95 and 98 if you use command.com or any other
16bit program as your shell.

XEmacs may incorrectly quote your call-process command if it contains
double quotes, backslashes or spaces.

start-process and functions that rely on it are supported under Windows 95,
98 and NT. However, starting a 16bit program that requires keyboard input
may cause XEmacs to hang or crash under Windows 95 and 98, and will leave
the orphaned 16bit program consuming all available CPU time.

Sending signals to subprocesses started by call-process or by
start-process fails with a "Cannot send signal to process" error under
Windows 95 and 98. As a side effect of this, quitting XEmacs while it
is still running subprocesses causes it to crash under Windows 95 and
98.

** Changing fonts from the Options menu

The "Font" and "Size" entries on the Options menu don't work yet. This
will be fixed in a future release. In the meantime, you can either
change face fonts with customize or manually; for example:

    (set-face-font 'default "Lucida Console:Regular:10::Western")
    (set-face-font 'modeline "MS Sans Serif:Regular:10::Western")

Font weight and style and character set must be supplied in English as
above. Common weights and styles are "Regular", "Regular Italic",
"Bold" and "Bold Italic". Common character sets are "Western",
"Central European" and "OEM/DOS".

Windows 95 only comes with one fixed-width font that is suitable for
use by XEmacs, namely "Courier New".

** No MULE support

This release of XEmacs on Windows does not contain MULE support. MULE
support has not been a priority for the XEmacs on Windows developers.

** Printing

This release of XEmacs on Windows does not support printing natively.

You can use the lpr-command and lpr-switches variables to specify an
external print program.