initial commit of dosbox 0.74

AUTHORS

+The DOSBox Team
+---------------
+
+Sjoerd v.d. Berg <harekiet>
+Peter Veenstra <qbix79>
+Ulf Wohlers <finsterr>
+Tommy Frssman <fanskapet>
+Dean Beeler <canadacow>
+Sebastian Strohhcker <c2woody>
+Ralf Grillenberger <h-a-l-9000>
+
+nick_without_<> @ users.sourceforge.net

INSTALL

+Things needed for compilation.
+
+SDL 
+    The Simple DirectMedia Library available at http://www.libsdl.org
+    The dll distributed with the windows version of DOSBox is slightly
+    modified. You can find the changes in the sourcepackage of DOSBox
+    (src/platform/sdl-win32.diff). If you want the patched sourcetree
+    send us an email. (see README)
+    Licensed under LGPL
+    Note that only version 1.2 and its subversions (1.2.8, 1.2.13 etc.)
+    are currently supported.
+
+Curses (optional)
+    If you want to enable the debugger you need a curses library.
+    ncurses should be installed on just about every unix distro.
+    For win32 get pdcurses at http://pdcurses.sourceforge.net
+    License: Open source
+
+Libpng (optional)
+    Needed for the screenshots.
+    For win32 get libpng from http://gnuwin32.sourceforge.net/packages.html
+    See http://www.libpng.org/pub/png/ for more details.
+    License: Open Source
+
+Zlib (optional)
+    Needed by libpng.
+    For win32 get libz (rename to zlib) from http://gnuwin32.sourceforge.net/packages.html
+    See http://www.zlib.net for more details.
+    License: Open Source
+
+SDL_Net (optional)
+    For modem/ipx support. Get it from http://www.libsdl.org/projects/SDL_net/
+    Licensed under LGPL
+
+SDL_Sound 
+    For compressed audio on diskimages. (optional)
+    This is for cue/bin cdrom images with compressed (mp3/ogg) audio tracks.
+    Get it from http://icculus.org/SDL_sound
+    Licenced under LGPL
+
+ALSA_Headers
+    (optional)
+    for Alsa support under linux. Part of the linux kernel sources
+    Licensed under LGPL
+
+If you want compile from the CVS under a unix system, you'll also need 
+automake (>=1.6), autoconf(>=2.50). Should be available at http://www.gnu.org
+
+For building on unix systems.
+If you are building from the cvs run ./autogen.sh first before doing the following.
+
+1. ./configure
+2. make
+
+In step 1 you could add the following switches:
+--enable-debug 
+        enables the internal debugger. --enable-debug=heavy enables even more 
+        debug options. DOSBox should then be run from a xterm and when the sdl-
+        window is active press alt-pause to enter the debugger.
+
+--enable-core-inline
+        enables some memory increasing inlines. This greatly increases 
+        compiletime for maybe a increase in speed.
+
+--disable-fpu
+        disables the emulated fpu. Although the fpu emulation code isn't 
+        finished and isn't entirely accurate it's advised to leave it on. 
+
+--disable-fpu-x86
+        disables the assembly fpu core. Although relatively new the x86 fpu 
+        core has more accuracy then the regular fpu core. 
+
+--disable-dynamic-x86
+        disables the dynamic x86 specific cpu core. Although it might be 
+        be a bit unstable, it can greatly improve the speed of dosbox on x86 
+        hosts.
+        Please note that this option on x86 will result in a different
+        dynamic/recompiling cpu core being compiled then the default.
+        For more information see the option --disable-dynrec
+
+--disable-dynrec
+        disables the recompiling cpu core. Currently x86 and x86_64 only.
+        You can activate this core on x86 by disabling the dynamic-x86 core.
+
+--disable-dynamic-core
+        disables all dynamic cores. (same effect as 
+        --disable-dynamic-x86 --disable-dynrec)
+
+--disable-opengl
+        disables OpenGL-support (output mode that can be selected in the
+        DOSBox configuration file).
+
+--disable-unaligned-memory
+        disables unaligned memory access.
+
+Check the src subdir for the binary.
+
+NOTE: If capslock and numlock appear to be broken. open
+src/ints/bios_keyboard.cpp and go to line 30 and read there how to fix it.
+
+
+Build instructions for VC++6 
+Don't use VC++ 6: it creates faulty code in core_normal.cpp
+Later Visual Studio versions work fine (vs2003/.net, vs2005, vs2008)

Makefile.am

+# Main Makefile for DOSBox
+
+EXTRA_DIST = autogen.sh
+SUBDIRS = src include docs visualc_net

THANKS

+We would like to thank:
+
+
+Vlad R. of the vdmsound project for excellent sound blaster info.
+Tatsuyuki Satoh of the Mame Team for making an excellent FM emulator.
+Jarek Burczynski for the new OPL3 emulator.
+Ken Silverman for his work on an OPL2 emulator.
+
+The Bochs and DOSemu projects which I used for information.
+FreeDOS for ideas in making my shell.
+
+Pierre-Yves Gérardy for hosting the old Beta Board.
+Colin Snover for hosting our forum.
+
+Sourceforge for hosting our homepage and other development tools.
+Mirek Luza, for his moderation of the forums.
+eL_Pusher, DosFreak and MiniMax for their moderation of VOGONS forum.
+
+crazyc, gulikoza, M-HT for their work on the dynrec core.
+
+Jantien for the version management.
+Shawn, Johannes and Marcus for creating the MAC OS X version.
+Jochen for creating the OS/2 version.
+Ido Beeri for the icon.
+ripsaw8080 for his hard debugging work.
+GOG Team for the splash screen.
+All the people who submitted a bug.
+The Beta Testers.
+

autogen.sh

+#!/bin/sh
+
+echo "Generating build information using aclocal, autoheader, automake and autoconf"
+echo "This may take a while ..."
+
+# Regenerate configuration files.
+
+aclocal
+autoheader
+automake --include-deps --add-missing --copy 
+autoconf
+
+echo "Now you are ready to run ./configure."
+echo "You can also run  ./configure --help for extra features to enable/disable."

config.h.in

+/* config.h.in.  Generated from configure.in by autoheader.  */
+
+
+/*
+ *  Copyright (C) 2002-2010  The DOSBox Team
+ *
+ *  This program is free software; you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation; either version 2 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU Library General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program; if not, write to the Free Software
+ *  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+ */
+
+
+/* Define if building universal (internal helper macro) */
+#undef AC_APPLE_UNIVERSAL_BUILD
+
+/* Compiling on BSD */
+#undef BSD
+
+/* Determines if the compilers supports always_inline attribute. */
+#undef C_ATTRIBUTE_ALWAYS_INLINE
+
+/* Determines if the compilers supports fastcall attribute. */
+#undef C_ATTRIBUTE_FASTCALL
+
+/* Define to 1 to use inlined memory functions in cpu core */
+#undef C_CORE_INLINE
+
+/* Define to 1 to enable internal debugger, requires libcurses */
+#undef C_DEBUG
+
+/* Define to 1 if you want serial passthrough support (Win32, Posix and OS/2).
+   */
+#undef C_DIRECTSERIAL
+
+/* Define to 1 to use x86 dynamic cpu core */
+#undef C_DYNAMIC_X86
+
+/* Define to 1 to use recompiling cpu core. Can not be used together with the
+   dynamic-x86 core */
+#undef C_DYNREC
+
+/* Define to 1 to enable floating point emulation */
+#undef C_FPU
+
+/* Define to 1 to use a x86 assembly fpu core */
+#undef C_FPU_X86
+
+/* Determines if the compilers supports attributes for structures. */
+#undef C_HAS_ATTRIBUTE
+
+/* Determines if the compilers supports __builtin_expect for branch
+   prediction. */
+#undef C_HAS_BUILTIN_EXPECT
+
+/* Define to 1 if you have the mprotect function */
+#undef C_HAVE_MPROTECT
+
+/* Define to 1 to enable heavy debugging, also have to enable C_DEBUG */
+#undef C_HEAVY_DEBUG
+
+/* Define to 1 to enable IPX over Internet networking, requires SDL_net */
+#undef C_IPX
+
+/* Define to 1 to enable internal modem support, requires SDL_net */
+#undef C_MODEM
+
+/* Define to 1 to use opengl display output support */
+#undef C_OPENGL
+
+/* Define to 1 to enable SDL_sound support */
+#undef C_SDL_SOUND
+
+/* Define to 1 if you have setpriority support */
+#undef C_SET_PRIORITY
+
+/* Define to 1 to enable screenshots, requires libpng */
+#undef C_SSHOT
+
+/* The type of cpu this target has */
+#undef C_TARGETCPU
+
+/* Define to 1 to use a unaligned memory access */
+#undef C_UNALIGNED_MEMORY
+
+/* define to 1 if you have XKBlib.h and X11 lib */
+#undef C_X11_XKB
+
+/* libm doesn't include powf */
+#undef DB_HAVE_NO_POWF
+
+/* struct dirent has d_type */
+#undef DIRENT_HAS_D_TYPE
+
+/* environ can be included */
+#undef ENVIRON_INCLUDED
+
+/* environ can be linked */
+#undef ENVIRON_LINKED
+
+/* Define to 1 to use ALSA for MIDI */
+#undef HAVE_ALSA
+
+/* Define to 1 if you have the <ddraw.h> header file. */
+#undef HAVE_DDRAW_H
+
+/* Define to 1 if you have the <inttypes.h> header file. */
+#undef HAVE_INTTYPES_H
+
+/* Define to 1 if you have the `asound' library (-lasound). */
+#undef HAVE_LIBASOUND
+
+/* Define to 1 if you have the <memory.h> header file. */
+#undef HAVE_MEMORY_H
+
+/* Define to 1 if you have the <netinet/in.h> header file. */
+#undef HAVE_NETINET_IN_H
+
+/* Define to 1 if you have the <pwd.h> header file. */
+#undef HAVE_PWD_H
+
+/* Define to 1 if you have the <stdint.h> header file. */
+#undef HAVE_STDINT_H
+
+/* Define to 1 if you have the <stdlib.h> header file. */
+#undef HAVE_STDLIB_H
+
+/* Define to 1 if you have the <strings.h> header file. */
+#undef HAVE_STRINGS_H
+
+/* Define to 1 if you have the <string.h> header file. */
+#undef HAVE_STRING_H
+
+/* Define to 1 if you have the <sys/socket.h> header file. */
+#undef HAVE_SYS_SOCKET_H
+
+/* Define to 1 if you have the <sys/stat.h> header file. */
+#undef HAVE_SYS_STAT_H
+
+/* Define to 1 if you have the <sys/types.h> header file. */
+#undef HAVE_SYS_TYPES_H
+
+/* Define to 1 if you have the <unistd.h> header file. */
+#undef HAVE_UNISTD_H
+
+/* Compiling on GNU/Linux */
+#undef LINUX
+
+/* Compiling on Mac OS X */
+#undef MACOSX
+
+/* Compiling on OS/2 EMX */
+#undef OS2
+
+/* Name of package */
+#undef PACKAGE
+
+/* Define to the address where bug reports for this package should be sent. */
+#undef PACKAGE_BUGREPORT
+
+/* Define to the full name of this package. */
+#undef PACKAGE_NAME
+
+/* Define to the full name and version of this package. */
+#undef PACKAGE_STRING
+
+/* Define to the one symbol short name of this package. */
+#undef PACKAGE_TARNAME
+
+/* Define to the home page for this package. */
+#undef PACKAGE_URL
+
+/* Define to the version of this package. */
+#undef PACKAGE_VERSION
+
+/* The size of `int *', as computed by sizeof. */
+#undef SIZEOF_INT_P
+
+/* The size of `unsigned char', as computed by sizeof. */
+#undef SIZEOF_UNSIGNED_CHAR
+
+/* The size of `unsigned int', as computed by sizeof. */
+#undef SIZEOF_UNSIGNED_INT
+
+/* The size of `unsigned long', as computed by sizeof. */
+#undef SIZEOF_UNSIGNED_LONG
+
+/* The size of `unsigned long long', as computed by sizeof. */
+#undef SIZEOF_UNSIGNED_LONG_LONG
+
+/* The size of `unsigned short', as computed by sizeof. */
+#undef SIZEOF_UNSIGNED_SHORT
+
+/* Define to 1 if you have the ANSI C header files. */
+#undef STDC_HEADERS
+
+/* Define to 1 if your <sys/time.h> declares `struct tm'. */
+#undef TM_IN_SYS_TIME
+
+/* Version number of package */
+#undef VERSION
+
+/* Define WORDS_BIGENDIAN to 1 if your processor stores words with the most
+   significant byte first (like Motorola and SPARC, unlike Intel). */
+#if defined AC_APPLE_UNIVERSAL_BUILD
+# if defined __BIG_ENDIAN__
+#  define WORDS_BIGENDIAN 1
+# endif
+#else
+# ifndef WORDS_BIGENDIAN
+#  undef WORDS_BIGENDIAN
+# endif
+#endif
+
+/* Define to empty if `const' does not conform to ANSI C. */
+#undef const
+
+/* Define to `__inline__' or `__inline' if that's what the C compiler
+   calls it, or to nothing if 'inline' is not supported under any name.  */
+#ifndef __cplusplus
+#undef inline
+#endif
+
+/* Define to `unsigned int' if <sys/types.h> does not define. */
+#undef size_t
+
+/* Define to `int` if you don't have socklen_t */
+#undef socklen_t
+
+#if C_ATTRIBUTE_ALWAYS_INLINE
+#define INLINE inline __attribute__((always_inline))
+#else
+#define INLINE inline
+#endif
+
+#if C_ATTRIBUTE_FASTCALL
+#define DB_FASTCALL __attribute__((fastcall))
+#else
+#define DB_FASTCALL
+#endif
+
+#if C_HAS_ATTRIBUTE
+#define GCC_ATTRIBUTE(x) __attribute__ ((x))
+#else
+#define GCC_ATTRIBUTE(x) /* attribute not supported */
+#endif
+
+#if C_HAS_BUILTIN_EXPECT
+#define GCC_UNLIKELY(x) __builtin_expect((x),0)
+#define GCC_LIKELY(x) __builtin_expect((x),1)
+#else
+#define GCC_UNLIKELY(x) (x)
+#define GCC_LIKELY(x) (x)
+#endif
+
+
+typedef         double     Real64;
+
+#if SIZEOF_UNSIGNED_CHAR != 1
+#  error "sizeof (unsigned char) != 1"
+#else
+  typedef unsigned char Bit8u;
+  typedef   signed char Bit8s;
+#endif
+
+#if SIZEOF_UNSIGNED_SHORT != 2
+#  error "sizeof (unsigned short) != 2"
+#else
+  typedef unsigned short Bit16u;
+  typedef   signed short Bit16s;
+#endif
+
+#if SIZEOF_UNSIGNED_INT == 4
+  typedef unsigned int Bit32u;
+  typedef   signed int Bit32s;
+#elif SIZEOF_UNSIGNED_LONG == 4
+  typedef unsigned long Bit32u;
+  typedef   signed long Bit32s;
+#else
+#  error "can't find sizeof(type) of 4 bytes!"
+#endif
+
+#if SIZEOF_UNSIGNED_LONG == 8
+  typedef unsigned long Bit64u;
+  typedef   signed long Bit64s;
+#elif SIZEOF_UNSIGNED_LONG_LONG == 8
+  typedef unsigned long long Bit64u;
+  typedef   signed long long Bit64s;
+#else
+#  error "can't find data type of 8 bytes"
+#endif
+
+#if SIZEOF_INT_P == 4
+  typedef Bit32u Bitu;
+  typedef Bit32s Bits;
+#else
+  typedef Bit64u Bitu;
+  typedef Bit64s Bits;
+#endif
+
+

docs/Makefile.am

+# Main Makefile for DOSBox
+
+man_MANS = dosbox.1 
+EXTRA_DIST = $(man_MANS) README.video PORTING
+
+
+
+

docs/PORTING

+Some notes about porting DOSBox to systems with certain restrictions,
+like handheld devices.
+
+General:
+  - depending on where you start off with the port, assure that the
+    config.h entries are correct/exhausting, like GCC_ATTRIBUTE is
+    required (struct packing) but is undefined if you base the port
+    on msvc sources which have a special config.h
+
+If memory is a constraint:
+  - in paging.h out-comment the USE_FULL_TLB define to enable special
+    TLB linking code that uses less memory
+    drawback: none (the code is not heavily tested though)
+    gain: reduces memory requirements about ~15mb
+  - in render.h lower the scaler integration:
+      #define RENDER_USE_ADVANCED_SCALERS 1
+    or
+      #define RENDER_USE_ADVANCED_SCALERS 0
+    drawback: complex scalers and the scaler cache are disabled,
+              be sure to test if this affects speed!
+              with define RENDER_USE_ADVANCED_SCALERS==0 most simple
+              scalers are disabled as well, some graphics modes won't
+              work due to reduced cache sizes
+    gain: ~2mb with RENDER_USE_ADVANCED_SCALERS==1
+          ~5mb with RENDER_USE_ADVANCED_SCALERS==0
+  - in dos_system.h reduce the drive cache entries:
+      #define MAX_OPENDIRS 256
+    drawback: some apps might not work with large directory trees
+    gain: ~1mb per mounted drive
+  - remove the GUS emulation (gus.cpp, especially GUSRam[1024*1024] )
+    drawback: no gravis ultrasound
+    gain: reduces memory requirements about 1mb
+  - reduce the size of the emulated graphics memory:
+    see the memory sizing in SVGA_Setup_*, especially the defaults
+    in vga_s3.cpp's SVGA_Setup_S3Trio
+    drawback: some graphics modes won't work then
+    gain: reduces memory requirements
+    TODO: fully check this, introduce hard limits
+
+If speed is a constraint:
+  - see if the simple core is faster, possibly remove the normal core
+    set the simple core as default
+    drawback: one game is known to not work with the simple core;
+              the simple core does only work for games which don't use paging
+              (when paging is requested the normal core is used automatically)
+    gain: the simple core should be somewhat faster
+    TODO: add possibility to easily remove the normal core, use fullcore fallback
+  - raise the default frameskip value
+    drawback: minor graphics smoothness loss for some games (video playback)
+    gain: reduces graphics load

docs/README.video

+Starting with version 0.65, DOSBox allows you to create movies out of screen
+output.
+
+To record a movie, you have to press CTRL-ALT-F5.
+To stop/end the recording, you have to press CTRL-ALT-F5 again.
+
+To play the recorded movie, you need a movie player which can handle the
+ZMBV codec. MS Windows users can find this codec in the start menu entry of
+DOSBox. Users of Linux and other OSes should look for a movie player that
+uses the ffmpeg libary (you may need to update or ask your distribution to
+upgrade).
+
+FAQ:
+Q: During the display of the movies the sound is lagging.
+A: Check your display properties to see whether your refresh rate is set to
+at least 70 hz. Try playing the movie in virtualdub (http://virtualdub.sf.net)
+
+Q: Why does the resulting movie consist of multiple files?
+A: Each time the game changes resolution, DOSBox creates a new movie file,
+because a movie file can only contain one resolution.
+
+Q: Can I set the cycles higher than my PC can handle during recording?
+A: Yes. During recording, the game might play slowly and stuttering, but the
+resulting movie should play at the intended speed and have no stuttering.
+
+Q: CTRL-ALT-F5 switches to the console under linux.
+A: 1. Start DOSBox like this: dosbox -startmapper
+   2. Click on Video, click on Add
+   3. Press the key you want (for example scroll lock or printscreen)
+   4. Click exit.
+   5. You can make movies by pressing scroll lock or whichever key you 
+      selected.
+
+Q: The colours are wrong and I'm using 64 bit windows
+A: Look here: http://vogons.zetafleet.com/viewtopic.php?t=12133

include/Makefile.am

+noinst_HEADERS =  \
+bios.h \
+bios_disk.h \
+callback.h \
+cpu.h \
+cross.h \
+control.h \
+debug.h \
+dma.h \
+dos_inc.h \
+dos_system.h \
+dosbox.h \
+fpu.h \
+hardware.h \
+inout.h \
+joystick.h \
+ipx.h \
+ipxserver.h \
+keyboard.h \
+logging.h \
+mapper.h \
+mem.h \
+mixer.h \
+modules.h \
+mouse.h \
+paging.h \
+pic.h \
+programs.h \
+render.h \
+regs.h \
+render.h \
+serialport.h \
+setup.h \
+shell.h \
+support.h \
+timer.h \
+vga.h \
+video.h
+

include/bios.h

+/*
+ *  Copyright (C) 2002-2010  The DOSBox Team
+ *