From 1eac5c516c127ce707d8a9348026284f63b94e88 Mon Sep 17 00:00:00 2001 From: Peter Veenstra Date: Tue, 12 Nov 2019 17:54:55 +0000 Subject: [PATCH] Update INSTALL file (modified version of patch #283 by dreamer_) Imported-from: https://svn.code.sf.net/p/dosbox/code-0/dosbox/trunk@4286 --- INSTALL | 90 ++++++++++++++++++++++++++++++--------------------------- 1 file changed, 48 insertions(+), 42 deletions(-) diff --git a/INSTALL b/INSTALL index 3fa05e9d..3792db5e 100644 --- a/INSTALL +++ b/INSTALL @@ -1,91 +1,97 @@ -Things needed for compilation. +Things needed for compilation: -SDL - The Simple DirectMedia Library available at http://www.libsdl.org +SDL + The Simple DirectMedia Library available at https://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. + License: LGPLv2+ 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 + For win32 get pdcurses at https://pdcurses.org/ + License: Public Domain 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 + License: zlib/libpng 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 + See https://www.zlib.net/ for more details. + License: zlib SDL_Net (optional) - For modem/ipx support. Get it from http://www.libsdl.org/projects/SDL_net/ - Licensed under LGPL + For modem/ipx support. + Get it from https://www.libsdl.org/projects/SDL_net/release-1.2.html + License: LGPLv2+ -SDL_Sound - For compressed audio on diskimages. (optional) +SDL_Sound (optional) + For compressed audio on diskimages (cue sheets) support. This is for cue/bin cdrom images with compressed (mp3/ogg) audio tracks. Get it from http://icculus.org/SDL_sound - Licenced under LGPL + Licence: LGPLv2+ -ALSA_Headers - (optional) +ALSA_Headers (optional) for Alsa support under linux. Part of the linux kernel sources - Licensed under LGPL + License: LGPLv2+ -If you want compile from developer sources (SVN) under a unix system, you'll also need -automake (>=1.6), autoconf(>=2.50). Should be available at http://www.gnu.org +If you want compile from developer sources (SVN) under a unix system, you'll +also need automake (>=1.6) and autoconf(>=2.50). +Should be available at https://www.gnu.org/software/ For building on unix systems. -If you are building from developer sources run ./autogen.sh first before doing the following. +If you are building from developer sources run ./autogen.sh first before doing +the following: -1. ./configure -2. make + $ ./configure + $ 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. +You can also run "./configure --help" for extra features to enable/disable. +Some of them are: ---enable-core-inline - enables some memory increasing inlines. This greatly increases - compiletime for maybe a increase in speed. +--enable-debug + enables the internal debugger. --enable-debug=heavy enables even more + debug options. To use the debugger, DOSBox should be run from an xterm + and when the sdl-window is active press alt-pause to enter the + debugger. + +--disable-core-inline + disables some memory increasing inlines. This speeds up compilation, + but may result in a slower dosbox. --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. + 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 --disable-fpu-x64 - disables the assembly fpu core. Although relatively new, the x86/x64 fpu - core has more accuracy then the regular fpu core. + disables the assembly fpu core. Although relatively new, the x86/x64 + 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 + disables the dynamic x86/x64 specific cpu core. Although it might be + be a bit unstable, it can greatly improve the speed of dosbox on x86 + and x64 hosts. + Please note that this option on x86/x64 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. + disables the recompiling cpu core. Currently x86/x64 and arm only. + You can activate this core on x86/x64 by disabling the dynamic-x86 + core. --disable-dynamic-core - disables all dynamic cores. (same effect as - --disable-dynamic-x86 --disable-dynrec) + disables all dynamic cores (same effect as --disable-dynamic-x86 + or --disable-dynrec). --disable-opengl disables OpenGL-support (output mode that can be selected in the