Find a file
Alexandre Julliard 9ea19e54cb Release 970101
Wed Jan  1 15:36:17 1997  Alexandre Julliard  <julliard@lrc.epfl.ch>

	* [controls/listbox.c]
	Use FindFirstFile/FindNextFile in LISTBOX_Directory.

	* [files/dos_fs.c]
	Rewrote FindFirstFile/FindNextFile to use DOSFS_FindNext().

	* [files/file.c] [files/directory.c]
	Use Win32 kernel objects and handles for file handles.
	Unified SearchPath() and OpenFile().

	* [loader/builtin.c]
	Moved to if1632/ directory.

	* [tools/build.c] [debugger/*] [miscemu/*]
	Win16 register functions now receive the same CONTEXT * structure
	as Win32 functions.

	* [include/sigcontext.h] [miscemu/instr.c]
	Added new macros to get register values from the SIGCONTEXT
	structure (only used for instruction emulation now).

	* [scheduler/process.c] [scheduler/thread.c] (New files)
	Allocate process and thread structures.

	* [scheduler/process.c] [win32/k32obj.c]
	Added Win32 kernel objects and handles management.

	* [loader/task.c]
	Create a Win32 process and thread for every Win16 task.

	* [misc/commdlg.c] [misc/shell.c] [windows/msgbox.c]
	Built-in resources are now in Win32 format. This also avoids
	16-bit callbacks for built-in dialogs.

	* [misc/lzexpand.c]
	Differentiate between 16-bit and 32-bit file handles.

	* [miscemu/int*.c]
	Moved all int emulation to msdos/ directory.

	* [msdos/*]
	New directory msdos/ contains all MS-DOS emulation code that can
	also be used for Winelib; this should enable Winelib apps to use
	DOS3Call and related functions.

	* [rc/winerc.c]
	A few bug fixes for Win32 resource format.

	* [windows/winpos.c]
	Hack in WINPOS_ReorderOwnerPopups() to avoid X crashed (still not
	right though).

Sun Dec 29 17:47:55 1996  O. Flebbe <flebbe@science-computing.uni-tuebingen.de>

	* [loader/pe_image.c]
	Make sure BSS of a PE_Image is zero.

Sat Dec 28 22:15:34 1996 Alex Korobka <alex@trantor.pharm.sunysb.edu>

	* [windows/scroll.c]
	ScrollWindowEx() rewrite, ScrollDC() fix.

	* [windows/nonclient.c] [controls/menu.c]
	Fixed Alt-Space crashes in dialogs.

	* [windows/event.c] [windows/message.c]
	Some changes in mouse message generation.

Thu Dec 26 09:25:24 1996  Philippe De Muyter  <phdm@info.ucl.ac.be>

	* [debugger/stabs.c]
	Dummy DEBUG_ReadExecutableDbgInfo provided for !__ELF__ case.

Tue Dec 24 00:59:05 MET 1996  Martin Buck <martin-2.buck@student.uni-ulm.de>

	* [windows/event.c]
	Changed XK_Page_{Up,Down} to XK_{Prior,Next} for X11R5
	compatibility.
1997-01-01 17:29:55 +00:00
controls Release 970101 1997-01-01 17:29:55 +00:00
debugger Release 970101 1997-01-01 17:29:55 +00:00
documentation Release 961117 1996-11-17 18:59:11 +00:00
files Release 970101 1997-01-01 17:29:55 +00:00
graphics Release 970101 1997-01-01 17:29:55 +00:00
if1632 Release 970101 1997-01-01 17:29:55 +00:00
include Release 970101 1997-01-01 17:29:55 +00:00
ipc Release 961013 1996-10-13 17:45:47 +00:00
library Release 970101 1997-01-01 17:29:55 +00:00
libtest Release 961023 1996-10-23 16:59:13 +00:00
loader Release 970101 1997-01-01 17:29:55 +00:00
memory Release 970101 1997-01-01 17:29:55 +00:00
misc Release 970101 1997-01-01 17:29:55 +00:00
miscemu Release 970101 1997-01-01 17:29:55 +00:00
msdos Release 970101 1997-01-01 17:29:55 +00:00
multimedia Release 970101 1997-01-01 17:29:55 +00:00
objects Release 970101 1997-01-01 17:29:55 +00:00
programs Release 970101 1997-01-01 17:29:55 +00:00
rc Release 970101 1997-01-01 17:29:55 +00:00
resources Release 970101 1997-01-01 17:29:55 +00:00
scheduler Release 970101 1997-01-01 17:29:55 +00:00
tools Release 970101 1997-01-01 17:29:55 +00:00
win32 Release 970101 1997-01-01 17:29:55 +00:00
windows Release 970101 1997-01-01 17:29:55 +00:00
ANNOUNCE Release 970101 1997-01-01 17:29:55 +00:00
BUGS Release 961222 1996-12-22 18:27:48 +00:00
ChangeLog Release 970101 1997-01-01 17:29:55 +00:00
configure Release 970101 1997-01-01 17:29:55 +00:00
configure.in Release 970101 1997-01-01 17:29:55 +00:00
DEVELOPERS-HINTS Release 960818 1996-08-18 16:21:52 +00:00
LICENSE Release 941017 1994-10-17 18:12:41 +00:00
Make.rules.in Release 961208 1996-12-08 19:25:27 +00:00
Makefile.in Release 970101 1997-01-01 17:29:55 +00:00
README Release 960516 1996-05-16 18:21:06 +00:00
RELEASE-NOTES Release 960309 1996-03-09 16:12:43 +00:00
WARRANTY Release 0.5 1994-01-04 20:14:34 +00:00
wine.ini Release 960818 1996-08-18 16:21:52 +00:00
wine.man Release 961201 1996-12-01 17:17:47 +00:00

1. INTRODUCTION

Wine is a program that allows running MS-Windows programs under X11.
It consists of a program loader, that loads and executes an
MS-Windows binary, and of an emulation library that translates Windows
API calls to their Unix/X11 equivalent.

Wine is free software. See the file LICENSE for the details.
Basically, you can do anything with it, except claim that you wrote it.


2. COMPILATION

You must have one of:

	Linux version 0.99.13 or above
	NetBSD-current
	FreeBSD-current or FreeBSD 1.1

You also need to have libXpm installed on your system. The sources for
it are probably available on the ftp site where you got Wine. They can
also be found on ftp.x.org and all its mirror sites.

To build Wine, first do a "./configure" and then a "make depend; make".
The executable "wine" will be built.  "wine" will load and run 16-bit
Windows executables.

To build Winelib, do a "./configure --with-library", and then a "make
depend; make". The library "winelib.a" will be built, allowing to
compile Windows source code under Unix. If you have an ELF compiler,
you can use "./configure --with-dll" instead to build a shared library.

To upgrade to a new release by using a patch file, first cd to the
top-level directory of the release (the one containing this README
file). Then do a "make clean", and patch the release with:

    gunzip -c patch-file | patch -p1

where "patch-file" is the name of the patch file (something like
Wine-yymmdd.diff.gz). You can then re-run "./configure", and then
run "make depend; make".


3. SETUP

Once Wine has been built correctly, you can do "make install"; this
will install the wine executable and the man page.

Wine requires you to have a file /usr/local/etc/wine.conf (you can
supply a different name when configuring wine) or a file called .winerc
in your home directory.

The format of this file is explained in the man page. The file
wine.ini contains a config file example.


4. RUNNING PROGRAMS

When invoking Wine, you must specify the entire path to the executable,
or a filename only.

For example: to run Windows' solitaire:

	wine sol		   (using the searchpath to locate the file)
	wine sol.exe

	wine c:\\windows\\sol.exe  (using a dosfilename)

	wine /usr/windows/sol.exe  (using a unixfilename)

Note: the path of the file will also be added to the path when
      a full name is supplied on the commandline.

Have a nice game of solitaire, but be careful.  Emulation isn't perfect.
So, occasionally it may crash.


5. GETTING MORE INFORMATION

The best place to get help or to report bugs is the Usenet newsgroup
comp.emulators.ms-windows.wine. The Wine FAQ is posted there every
month.

If you add something, or fix a bug, please send a patch ('diff -u'
format preferred) to julliard@lrc.epfl.ch for inclusion in the next
release.

--
Alexandre Julliard
julliard@lrc.epfl.ch