README

   1 Copyright  Robert J. Amstadt, 1993.  All code is provided without
   2 warranty.  All code is covered by the license contained in the file
   3 LICENSE unless explicitly stated in the individual source file.
   4
   5
   6
   7 1. COMPILATION:
   8
   9 You must have one of:
  10
  11         Linux version 0.99.13 or above
  12         NetBSD-current
  13         FreeBSD-current or FreeBSD 1.1
  14
  15 To build Wine, first do a "./Configure" and then a "make".  The
  16 executable "wine" will be built.  "wine" will load and run 16-bit
  17 Windows' executables.
  18
  19
  20
  21 2. SETUP:
  22
  23 Wine requires you to have a file /usr/local/etc/wine.conf (you can
  24 supply a different name when configuring wine) or a file called .winerc
  25 in your homedirectory.
  26
  27 The formatstyle of this config file is just like a windows .ini file.
  28
  29 Here's an explanation of each section:
  30
  31 * [drives]
  32
  33 format: <driveletter> = <rootdirectory>
  34 default: none
  35
  36 This section is used to specify the root directory of each `dos'drive
  37 as windows' applications require a dos/mswindows based diskdrive &
  38 directory scheme.
  39
  40 If you mounted you dos-partition as /dos and installed microsoft windows
  41 in c:\windows than you should specify c=/dos in the drives section.
  42
  43 * [wine]
  44
  45 format: windows = <directory>
  46 default: c:\windows
  47
  48 Used to specify an different windows directory.
  49
  50 format: system = <directory>
  51 default: c:\windows\system
  52
  53 Used to specify an different system directory.
  54
  55 format: temp = <directory>
  56 default: c:\temp
  57
  58 Used to specify a directory where windows applications can store temporary
  59 files.
  60
  61 format: path = <directories separated by semi-colons>
  62 default: c:\windows;c:\windows\system
  63
  64 Used to specify the path which will be used to find executables and DLL's.
  65
  66 format: systemresources = <filename>
  67 default: c:\temp
  68
  69 Used to specify the name of sysres.dll, a dll which is used by wine itself.
  70
  71 * [serialports]
  72
  73 format: com[12345678] = <devicename>
  74 default: none
  75
  76 Used to specify the devices which are used as com1 - com8.
  77
  78 * [parallelports]
  79
  80 format: lpt[12345678] = <devicename>
  81 default: none
  82
  83 Used to specify the devices which are used as lpt1 - lpt8.
  84
  85 * [spy]
  86
  87 format: file = <filename or CON when logging to stdout>
  88 default: none
  89
  90 used to specify the file which will be used as logfile.
  91
  92 format: exclude = <message names separated by semicolons>
  93 default: none
  94
  95 Used to specify which messages will be excluded from the logfile.
  96
  97 format: include = <message names separated by semicolons>
  98 default: none
  99
 100 Used to specify which messages will be included in the logfile.
 101
 102
 103
 104 3. RUNNING PROGRAMS
 105
 106 When invoking wine, you must specify the entire path to the executable,
 107 or a filename only.
 108
 109 For example: to run Windows' solitaire:
 110
 111         wine sol                   (using the searchpath to locate the file)
 112         wine sol.exe
 113
 114         wine c:\\windows\\sol.exe  (using a dosfilename)
 115
 116         wine /usr/windows/sol.exe  (using a unixfilename)
 117
 118 note: the path of the file will also be added to the path when
 119       a full name is supplied on the commandline.
 120
 121 Have a nice game of solitaire, but be careful.  Emulation isn't perfect.
 122 So, occassionally it will crash.
 123
 124
 125
 126 4. EXAMPLE CONFIGFILE
 127
 128 ----------------------------------------------------------------------------
 129 [drives]
 130 a=/mnt/fd0
 131 c=/dos
 132 d=~/Wine
 133
 134 [wine]
 135 windows=c:\windows
 136 system=c:\windows\system
 137 temp=c:\temp
 138 path=c:\windows;c:\windows\system;c:\winapps\word\;c:\winapps\pctools
 139 systemresources=./sysres.dll
 140
 141 [serialports]
 142 com1=/dev/cua1
 143 com2=/dev/cua1
 144
 145 [parallelports]
 146 lpt1=/dev/lp0
 147
 148 [spy]
 149 ;File=CON
 150 ;File=spy.log
 151 Exclude=WM_TIMER;WM_SETCURSOR;WM_MOUSEMOVE;WM_NCHITTEST;WM_NCACTIVATE;WM_GETDLGCODE;
 152 Include=WM_COMMAND;
 153
 154 ----------------------------------------------------------------------------
 155
 156
 157 5. BUILD:
 158
 159     The documentation for the build program is in the file build-spec.txt
 160
 161
 162 6. FINALE:
 163
 164 Good luck,
 165
 166         If you successfully add anything, please send me a copy.
 167
 168 Bob Amstadt
 169 bob@amscons.com
 170
 171
 172 7. WHAT'S NEW
 173
 174 WHAT'S NEW with Wine-940510: (see ChangeLog for details)
 175         - debugger improvements
 176         - mmsystem
 177         - ShellAbout() and AboutDlgProc()
 178         - and many many bug fixes!
 179
 180 WHAT'S NEW with Wine-940505: (see ChangeLog for details)
 181         - faster color_stretch()
 182         - SetSysMenu(), GetCursor(), GetDesktopWindow()
 183         - WSAGetXbyY() now non-blocking
 184         - and many many bug fixes!
 185
 186 WHAT'S NEW with Wine-940420: (see ChangeLog for details)
 187         - new property functions
 188         - new listbox and combo box functions
 189         - GrayString() and CallGrayStringProc()
 190         - and many many bug fixes!
 191
 192 WHAT'S NEW with Wine-940412: (see ChangeLog for details)
 193         - menuing improvements
 194         - drawing performance improvements
 195         - beginnings of hooks
 196         - MDI maximizing and tiling
 197         - improvements in winsock implementation
 198         - and many many bug fixes!
 199
 200 WHAT'S NEW with Wine-940405: (see ChangeLog for details)
 201         - Mouse activation of menus working again
 202         - GetprocAddress()
 203         - SetDIBitsToDevice()
 204         - FindWindow()
 205         - int 10hm 25h and 26h
 206         - in, inb, out, outb emulation
 207         - and many many bug fixes!
 208
 209 WHAT'S NEW with Wine-940329: (see ChangeLog for details)
 210         - MDI: child windows can be created, activated and cascaded.
 211         - -depth option
 212         - support for dithered brushes
 213         - GetNearestColor(), RealizeDefaultPalette(),
 214           GetSystemPaletteEntries(), and SelectPalette()
 215         - System colors read from WIN.INI
 216         - Keyboard menu manipulation (mouse is temporarily broken)
 217         - GetFreeSystemResources()
 218         - and many many bug fixes!
 219
 220 WHAT'S NEW with Wine-940322: (see ChangeLog for details)
 221         - Speed improvements in bitmaps and mouse messages
 222         - More MDI support.  More to come next week...
 223         - and many many bug fixes!
 224
 225 WHAT'S NEW with Wine-940315: (see ChangeLog for details)
 226         - Beginnings of MDI support.  More to come next week...
 227         - Stress DLL
 228         - and many many bug fixes!
 229
 230 WHAT'S NEW with Wine-940309: (see ChangeLog for details)
 231         - New "exclude" and "include" filters for spy feature.  See sample
 232           wine.ini for details.
 233         - -desktop and -name options (see ChangeLog)
 234         - GetFreeSpace() and CreateIcon()
 235         - and many many bug fixes!
 236
 237 WHAT'S NEW with Wine-940301: (see ChangeLog for details)
 238         - NEW Configure script to set compile time options!
 239         - Support for filesystems with short (less than 14 chars) filenames.
 240         - Clipboard functions!
 241         - and more...
 242
 243 WHAT'S NEW with Wine-940223: (see ChangeLog for details)
 244         - FreeBSD support
 245         - FloodFill()
 246         - Desktop window support
 247         - Menu fixes
 248         - and more...
 249
 250 WHAT'S NEW with Wine-940216: (see ChangeLog for details)
 251         - Many many bug fixes
 252         - Switched to using Imakefile's instead of Makefile's.
 253         - Lot's of changes for libwine.a
 254
 255 WHAT'S NEW with Wine-940209: (see ChangeLog for details)
 256         - Many many bug fixes
 257         - Minor directory structure reorganization
 258         - New GetModule*() functions.
 259         - WINSOCK DLL
 260         - First stab at Wine as a library
 261
 262 WHAT'S NEW with Wine-940201: (see ChangeLog for details)
 263         - Support for huge data structures.
 264         - FreeBSD support.
 265         - Many many bug fixes
 266
 267 WHAT'S NEW with version 0.8: (see ChangeLog for details)
 268         - Eliminated Xt-dependent code.  Thanks to Alexandre and Martin.
 269         - EnumWindows() and EnumChildWindows()
 270         - Activating and deactivating of windows.
 271         - More work on system menus.
 272
 273 WHAT'S NEW with version 0.7: (see ChangeLog for details)
 274         - Eliminated Xt-dependent code.  Thanks to Alexandre and Martin.
 275         - Other bug fixes.
 276         - IsWIndowEnabled() and EnableWindow() now implemented.
 277         - New command line options.
 278
 279 WHAT'S NEW with version 0.6: (see ChangeLog for details)
 280         - Working towards elimination of Xt-dependent code.  Thanks to
 281           Alexandre and Martin.
 282         - Other bug fixes.
 283         - I added a rudimentary spy facility which can be turned
 284           on from the wine.ini file.  See the sample wine.ini
 285           for details
 286
 287 WHAT'S NEW with version 0.5: (see ChangeLog for details)
 288         - Working towards elimination of Xt-dependent code.
 289         - StretchBlt()
 290         - GetClassName() & GetClassInfo()
 291         - Implemented loader relocation types 5 and 6.
 292
 293 WHAT'S NEW with version 0.4.14: (see ChangeLog for details)
 294         - Bug fixes and enhancements
 295         - Comm functions
 296         - Text caret functions
 297
 298 WHAT'S NEW with version 0.4.13: (see ChangeLog for details)
 299         - Bug fixes
 300         - GetCapture()
 301         - More keyboard handling
 302         - Polyline() and Polygon()
 303
 304 WHAT'S NEW with version 0.4.12: (see ChangeLog for details)
 305         - Bug fixes
 306         - New DOS file functions
 307         - Experimental Imakefiles
 308
 309 WHAT'S NEW with version 0.4.11: (see ChangeLog for details)
 310         - Bug fixes
 311         - New cursor functions
 312         - New file system handling
 313         - Atoms
 314
 315 WHAT'S NEW with version 0.4.10: (see ChangeLog for details)
 316         - Bug fixes
 317         - More scroll bar functions
 318         - More icon and cursor handling
 319
 320 WHAT'S NEW with version 0.4.9: (see ChangeLog for details)
 321         - Bug fixes
 322         - real MessageBox()
 323         - New resource functions
 324         - Icon functions
 325         - Selector manipulation functions
 326         - Catch()/Throw()
 327
 328 WHAT'S NEW with version 0.4.7: (see ChangeLog for details)
 329         - More dialog box functions
 330         - More DOS interrupts
 331         - NetBSD compatibility patches
 332
 333 WHAT'S NEW with version 0.4.5: (see ChangeLog for details)
 334         - Bug fixes
 335         - focus routines
 336         - dialog box functions
 337         - improvements to control windows
 338
 339 WHAT'S NEW with version 0.4.4: (see ChangeLog for details)
 340         - Bug fixes
 341         - New static control class
 342         - Preliminary listbox, combobox and scrollbar controls
 343         - System initialization file is now called "wine.ini", and
 344           may be located in the user's current directory, the
 345           user's home directory or any directory specified by
 346           the WINEPATH environment variable.
 347         - The loader now searches the directories specified by the
 348           WINEPATH environment variable for programs and DLLs.
 349         - Internal debugger now works on 386BSD.
 350
 351 WHAT'S NEW with version 0.4.3: (see ChangeLog for details)
 352         - Bug fixes
 353         - Resource loading now able to load DLL resources
 354         - Button control now based on GDI calls
 355         - Preliminary system color support
 356         - Miscellaneous window functions
 357         - Limited debugging facility (sometimes hangs)
 358
 359 WHAT'S NEW with version 0.4.2: (see ChangeLog for details)
 360         - Bug fixes
 361         - 32-bit callback functions allowed
 362         - .INI file handling
 363         - lstr* functions and ANSI<->OEM conversion functions.
 364
 365 WHAT'S NEW with version 0.4.1: (see ChangeLog for details)
 366         - Bug fixes
 367         - Memory usage changes.
 368
 369 WHAT'S NEW with version 0.4.0: (see ChangeLog for details)
 370         - Wine now compiles and runs under NetBSD.  Patches are
 371           required for NetBSD.
 372         - Wine stat patches included.  Add "-DWINESTAT" to the definition
 373           of COPTS in the main Makefile to activate.
 374         - Preliminary keyboard handling.
 375         - Button control window implemented.
 376         - many other new functions added.
 377
 378 WHAT'S NEW with version 0.3.1: (see ChangeLog for details)
 379         - LineDDA() completed
 380         - numerous bug fixes
 381         - INT 1Ah implemented
 382         - SOUND DLL implemented
 383         - More of WIN87EM DLL implemented
 384         - OpenFile() and friends implemented
 385
 386 WHAT'S NEW with version 0.3.0: (see ChangeLog for details)
 387         - Mouse capture
 388         - Text justification and underlining
 389         - Clipping
 390         - LoadBitmap() completed
 391         - Code generated by the Borland compiler should now work
 392
 393 WHAT'S NEW with version 0.2.8: (see ChangeLog for details)
 394         - Text functions from Alexandre
 395         - INT 21h from Eric
 396         - Menu improvements from David
 397         - Bug fixes and GetProcAddress() stub from me
 398
 399 WHAT'S NEW with version 0.2.7: (see ChangeLog for details)
 400     - sol.exe gets further.  I did some debugging and now solitaire
 401       stops when it tries to call GetTextExtent().  Any volunteers?
 402     - Many DC updates from Alexandre.
 403     - Menu updates to support underlining characters from David Metcalfe.
 404
 405 WHAT'S NEW with version 0.2.6: (see ChangeLog for details)
 406     - More region updates from Alexandre
 407
 408 WHAT'S NEW with version 0.2.5: (see ChangeLog for details)
 409     - Regions implemented by Alexandre
 410     - More menuing code from me
 411
 412 WHAT'S NEW with version 0.2.4: (see ChangeLog for details)
 413     - Many improvements to GDI from Alexandre
 414     - Many improvements to menu handling by me.
 415
 416 WHAT'S NEW with version 0.2.3: (see ChangeLog for details)
 417     - Bug fixes with SendMessage() and PostMessage()
 418     - Preliminary menu support
 419
 420 WHAT'S NEW with version 0.2.2: (see ChangeLog for details)
 421     - Misc bug fixes
 422     - More bitmap code
 423     - Timers
 424     - Memory DC's
 425
 426 WHAT'S NEW with version 0.2.1:
 427     - I have placed things into sub-directories.  The organization is
 428       not finalized.  I imagine that the directory structure will
 429       change as is necessary.  Files in the ./misc directory need
 430       to be split apart and placed in apropriate directories.
 431     - Tons of code from Alexandre.  He has constructed the framework
 432       for handling GDI objects.  He has also provided code for DCEs.
 433     - Local heap functions have been completed.
 434     - Bug fixes in global.c and win.c
 435     - New function GlobalQuickAlloc() combines GlobalAlloc() and
 436       GlobalLock() into a single function call.
 437     - New patch kit for Linux 0.99 pl11 kernel.  Thanks to Linus
 438       who has graciously included our patches into the ALPHA patch
 439       release cycle.
 440
 441 WHAT'S NEW with version 0.2.0:
 442     - Alexandre Julliard has provided a replacement for the Tcl code.
 443       The new code uses Xlib and Xt directly with no intervening
 444       interpretted language.  This should reduce the learning
 445       curve for casual hackers.
 446     - I changed all GLOBAL_ names to Global.
 447
 448 WHAT'S NEW with version 0.1.1:
 449     - I have completed global memory allocation, but I don't like it.
 450       It is not 100% compatible with Windows.  I need some more kernel
 451       modifications for 100% compatibility.
 452     - Alexandre Julliard has provided written better emulation for
 453       the Windows message queue.
 454
 455 WHAT'S NEW with version 0.1.0:
 456     - Latest patches from Alexandre Julliard.
 457     - minor bug fix in if1632.S
 458
 459 WHAT'S NEW with version 0.0.5:
 460     - Patches from Alexandre Julliard.  Some integration with Tcl.
 461     - Generic interface for callback procedures.  This will allow
 462       callbacks into DLLs.
 463     - MakeProcInstance() has been implemented but untested.
 464
 465 WHAT'S NEW with version 0.0.4:
 466     - Eric Youngdale modified wine.c and selector.c to allow loading
 467       of Windows DLLs.
 468     - Added global memory allocation routines (GlobalAlloc, GlobalFree,
 469       and GlobalLock)
 470     - Bitmap resource loading into global memory.
 471
 472 WHAT'S NEW with version 0.0.3:
 473     - Fixed bug with sector sizes.
 474     - Registers at program startup are now set correctly.
 475     - Segment fixups for relocatable-segment internal entry points.
 476     - Fixed bug in DOS PSP structure.
 477     - Some resource loading is done.
 478     - Added "return" ordinal type to build program.
 479     - Added comment capability to build program.
 480
 481 WHAT'S NEW with version 0.0.2:
 482
 483     - Again thanks to Eric Youngdale for some very useful comments.
 484     - The Windows startup code created by Micrsoft C 7.0 now runs
 485       to completion.
 486     - Added a new patch to the kernel to increase the usable size of
 487       the ldt to the full 32 entries currently allowed.
 488     - Imported name relocations are now supported.
 489     - Source code for my infamous test program is now included.
 490     - A handful of basic Windows functions are now emulated.  See
 491       "kernel.spec" for examples of how to use the build program.
 492
 493 WHAT'S NEW with version 0.0.1:
 494
 495     - Eric Youngdale contributed countless improvements in memory
 496       efficiency, bug fixes, and relocation.
 497     - The build program has been completed.  It now lets you specify
 498       how the main DLL entry point should interface to your emulation
 499       library routines.  A brief description of how to build these
 500       specifications is included in the file "build-spec.txt".
 501     - The code to dispatch builtin DLL calls is complete, but untested.