Blame - README - wine - Git at Google

blob: 25be8f4fc88d9f3e2b93caf14da347831e09f913 [file] [log] [blame]

Alexandre Julliard	3a5816f	1994-12-27 14:11:53 +0000	[diff] [blame]	1	1. INTRODUCTION
Alexandre Julliard	2c25c3e	1993-06-29 16:33:12 +0000	[diff] [blame]	2
Alexandre Julliard	3a5816f	1994-12-27 14:11:53 +0000	[diff] [blame]	3	Wine is a program that allows running MS-Windows programs under X11.
				4	It consists of a program loader, that loads and executes an
				5	MS-Windows binary, and of an emulation library that translates Windows
				6	API calls to their Unix/X11 equivalent.
Alexandre Julliard	8d24ae6	1994-04-05 21:42:43 +0000	[diff] [blame]	7
Alexandre Julliard	3a5816f	1994-12-27 14:11:53 +0000	[diff] [blame]	8	Wine is free software. See the file LICENSE for the details.
				9	Basically, you can do anything with it, except claim that you wrote it.
Alexandre Julliard	1f57929	1994-05-25 16:25:21 +0000	[diff] [blame]	10
Alexandre Julliard	3a5816f	1994-12-27 14:11:53 +0000	[diff] [blame]	11
				12	2. COMPILATION
Alexandre Julliard	401710d	1993-09-04 10:09:32 +0000	[diff] [blame]	13
Alexandre Julliard	a69b88b	1998-03-15 20:29:56 +0000	[diff] [blame]	14	To compile the emulator, you must have one of:
Alexandre Julliard	f41aeca	1993-09-14 16:47:10 +0000	[diff] [blame]	15
Alexandre Julliard	fb9a919	1994-03-01 19:48:04 +0000	[diff] [blame]	16	Linux version 0.99.13 or above
				17	NetBSD-current
				18	FreeBSD-current or FreeBSD 1.1
Alexandre Julliard	d37eb36	1997-07-20 16:23:21 +0000	[diff] [blame]	19	OpenBSD/i386 2.1 or later
Alexandre Julliard	a69b88b	1998-03-15 20:29:56 +0000	[diff] [blame]	20	Solaris x86 2.5 or later
Alexandre Julliard	f41aeca	1993-09-14 16:47:10 +0000	[diff] [blame]	21
Alexandre Julliard	6abb89c	1995-03-02 17:33:47 +0000	[diff] [blame]	22	You also need to have libXpm installed on your system. The sources for
				23	it are probably available on the ftp site where you got Wine. They can
				24	also be found on ftp.x.org and all its mirror sites.
				25
Alexandre Julliard	a69b88b	1998-03-15 20:29:56 +0000	[diff] [blame]	26	On x86 Systems gcc >= 2.7.0 is required. You will probably need flex too.
				27
Alexandre Julliard	ff8331e	1995-09-18 11:19:54 +0000	[diff] [blame]	28	To build Wine, first do a "./configure" and then a "make depend; make".
Alexandre Julliard	a0b2b1d	1997-11-16 17:38:29 +0000	[diff] [blame]	29	This will build the library "libwine.a" and the program "wine".
Alexandre Julliard	401710d	1993-09-04 10:09:32 +0000	[diff] [blame]	30
Alexandre Julliard	a0b2b1d	1997-11-16 17:38:29 +0000	[diff] [blame]	31	The program "wine" will load and run Windows executables.
				32	The library "libwine.a" can be used to compile and link Windows source
				33	code under Unix. If you have an ELF compiler, you can use
				34	"./configure --enable-dll" to build a shared library instead.
Alexandre Julliard	e2bfa4c	1996-05-16 18:21:06 +0000	[diff] [blame]	35
Alexandre Julliard	3a5816f	1994-12-27 14:11:53 +0000	[diff] [blame]	36	To upgrade to a new release by using a patch file, first cd to the
				37	top-level directory of the release (the one containing this README
				38	file). Then do a "make clean", and patch the release with:
				39
				40	gunzip -c patch-file \| patch -p1
				41
				42	where "patch-file" is the name of the patch file (something like
Alexandre Julliard	ff8331e	1995-09-18 11:19:54 +0000	[diff] [blame]	43	Wine-yymmdd.diff.gz). You can then re-run "./configure", and then
				44	run "make depend; make".
Alexandre Julliard	8d24ae6	1994-04-05 21:42:43 +0000	[diff] [blame]	45
				46
Alexandre Julliard	3a5816f	1994-12-27 14:11:53 +0000	[diff] [blame]	47	3. SETUP
Alexandre Julliard	8d24ae6	1994-04-05 21:42:43 +0000	[diff] [blame]	48
Alexandre Julliard	7e56f68	1996-01-31 19:02:28 +0000	[diff] [blame]	49	Once Wine has been built correctly, you can do "make install"; this
				50	will install the wine executable and the man page.
				51
Alexandre Julliard	8d24ae6	1994-04-05 21:42:43 +0000	[diff] [blame]	52	Wine requires you to have a file /usr/local/etc/wine.conf (you can
				53	supply a different name when configuring wine) or a file called .winerc
Alexandre Julliard	3a5816f	1994-12-27 14:11:53 +0000	[diff] [blame]	54	in your home directory.
Alexandre Julliard	8d24ae6	1994-04-05 21:42:43 +0000	[diff] [blame]	55
Alexandre Julliard	7e56f68	1996-01-31 19:02:28 +0000	[diff] [blame]	56	The format of this file is explained in the man page. The file
				57	wine.ini contains a config file example.
Alexandre Julliard	8d24ae6	1994-04-05 21:42:43 +0000	[diff] [blame]	58
				59
Alexandre Julliard	3a5816f	1994-12-27 14:11:53 +0000	[diff] [blame]	60	4. RUNNING PROGRAMS
Alexandre Julliard	8d24ae6	1994-04-05 21:42:43 +0000	[diff] [blame]	61
Alexandre Julliard	3a5816f	1994-12-27 14:11:53 +0000	[diff] [blame]	62	When invoking Wine, you must specify the entire path to the executable,
Alexandre Julliard	8d24ae6	1994-04-05 21:42:43 +0000	[diff] [blame]	63	or a filename only.
Alexandre Julliard	f41aeca	1993-09-14 16:47:10 +0000	[diff] [blame]	64
Alexandre Julliard	5f721f8	1994-01-04 20:14:34 +0000	[diff] [blame]	65	For example: to run Windows' solitaire:
				66
Alexandre Julliard	8d24ae6	1994-04-05 21:42:43 +0000	[diff] [blame]	67	wine sol (using the searchpath to locate the file)
				68	wine sol.exe
Alexandre Julliard	5f721f8	1994-01-04 20:14:34 +0000	[diff] [blame]	69
				70	wine c:\\windows\\sol.exe (using a dosfilename)
				71
				72	wine /usr/windows/sol.exe (using a unixfilename)
Alexandre Julliard	f41aeca	1993-09-14 16:47:10 +0000	[diff] [blame]	73
Alexandre Julliard	3a5816f	1994-12-27 14:11:53 +0000	[diff] [blame]	74	Note: the path of the file will also be added to the path when
Alexandre Julliard	5819953	1994-04-21 01:20:00 +0000	[diff] [blame]	75	a full name is supplied on the commandline.
				76
Alexandre Julliard	f41aeca	1993-09-14 16:47:10 +0000	[diff] [blame]	77	Have a nice game of solitaire, but be careful. Emulation isn't perfect.
Alexandre Julliard	3a5816f	1994-12-27 14:11:53 +0000	[diff] [blame]	78	So, occasionally it may crash.
Alexandre Julliard	f41aeca	1993-09-14 16:47:10 +0000	[diff] [blame]	79
Alexandre Julliard	23946ad	1997-06-16 17:43:53 +0000	[diff] [blame]	80	UPDATE: Windows 95 components are known to cause more crashes compared
				81	to the equivalent Windows 3.1 libraries.
				82
Alexandre Julliard	8d24ae6	1994-04-05 21:42:43 +0000	[diff] [blame]	83
Alexandre Julliard	3a5816f	1994-12-27 14:11:53 +0000	[diff] [blame]	84	5. GETTING MORE INFORMATION
Alexandre Julliard	8d24ae6	1994-04-05 21:42:43 +0000	[diff] [blame]	85
Alexandre Julliard	46ea8b3	1998-05-03 19:01:20 +0000	[diff] [blame^]	86	Usenet: The best place to get help or to report bugs is the Usenet newsgroup
				87	comp.emulators.ms-windows.wine. The Wine FAQ is posted there every
				88	month.
				89
				90	WWW: Please browse old messages on http://www.dejanews.com to check whether
				91	your problem is already fixed before posting a bug report to the
				92	newsgroup.
				93
				94	A great deal of information about Wine is available from WineHQ at
				95	http://www.winehq.com. Untested patches against the current
				96	release are available at http://www.winehq.com/patches.
				97
				98
				99	FAQ: The Wine FAQ is located at http://home.pacbell.net/dagar/wine.html.
				100
Alexandre Julliard	8d24ae6	1994-04-05 21:42:43 +0000	[diff] [blame]	101
Alexandre Julliard	ff8331e	1995-09-18 11:19:54 +0000	[diff] [blame]	102	If you add something, or fix a bug, please send a patch ('diff -u'
Alexandre Julliard	0c126c7	1996-02-18 18:44:41 +0000	[diff] [blame]	103	format preferred) to julliard@lrc.epfl.ch for inclusion in the next
Alexandre Julliard	ff8331e	1995-09-18 11:19:54 +0000	[diff] [blame]	104	release.
Alexandre Julliard	8d24ae6	1994-04-05 21:42:43 +0000	[diff] [blame]	105
Alexandre Julliard	3a5816f	1994-12-27 14:11:53 +0000	[diff] [blame]	106	--
				107	Alexandre Julliard
Alexandre Julliard	ff8331e	1995-09-18 11:19:54 +0000	[diff] [blame]	108	julliard@lrc.epfl.ch