16/adplug/libbinio/INSTALL.dos

   1 Note
   2 ----
   3 These are generic installation instructions.
   4
   5 These instructions assume that Watcom is the default compiler of this software
   6 package. If this software supports additional compilers, aside from Watcom, it
   7 is very likely that this build system is not the default. In this case, it may
   8 well be possible that some files have different names than assumed in these
   9 instructions. Please consult the software ditribution's documentation for more
  10 information on this topic.
  11
  12 Configuration
  13 -------------
  14 Before you can compile anything, create a file called CONFIG.MIF in the
  15 distribution's base directory. It is best to copy the template below out of
  16 this file and modify it to fit your setup.
  17
  18 In most cases, you just want to change the installation target directories
  19 "bindir", "includedir" and "libdir" to your standard binary, header and
  20 library directories. If you want to install the software manually and don't
  21 want to set any other options, you can just leave the whole file blank.
  22
  23 There are numerous possibilities to configure other aspects of the
  24 distribution using the CONFIG.MIF file. You can redefine any variable of the
  25 distribution's original Makefile, any standard wmake variable (CFLAGS, LDFLAGS
  26 and the like) or specify another system type using the SYSTEM variable.
  27
  28 Installation
  29 ------------
  30 After configuration, run "wmake" to build the software.
  31
  32 If you like to automatically install the software, run "wmake install".
  33
  34 For manual installation, you have to consult the software distribution's
  35 documentation for information.
  36
  37 After the installation, you can run "wmake clean" to delete any files created
  38 during compilation.
  39
  40 If you must, you can even run "wmake distclean" to clean up any additionally
  41 created files and bring back your source directory into the same state it was
  42 after unpacking the distribution archive.
  43
  44 Uninstallation
  45 --------------
  46 You can automatically delete all installed files by running "wmake uninstall".
  47 Note that any files created after installation are being left on the device.
  48
  49 Debugging
  50 ---------
  51 To enable debugging using the Watcom debugger, add the following line to your
  52 CONFIG.MIF file:
  53
  54 debug = yes
  55
  56 This will recompile all source files with source-level debugging enabled and
  57 instructs the linker to include debugging information. Be careful with the
  58 SYSTEM setting in your CONFIG.MIF file, though. Only some extenders are
  59 supported by the Watcom debugger. Some distributions may have defined a
  60 non-compatible extender by default, which you must override by specifying
  61 your own.
  62
  63 CONFIG.MIF Template
  64 -------------------
  65 # Makefile configuration file
  66 # Lines starting with a '#' are comments.
  67 # Variables in capital letters are distribution-specific. Be careful when
  68 # changing any of these!
  69
  70 # If debug is set to "yes", the compiler and linker are instructed to
  71 # include debug information with the compiled objects and executables.
  72 # Default: no
  73 # This example enables debugging.
  74 #debug = yes
  75
  76 # "bindir" is the target directory for binary (.exe) files.
  77 # Default: current directory
  78 #bindir = c:\bin
  79
  80 # "includedir" is the target directory for header (.h) files.
  81 # Default: current directory
  82 #includedir = c:\include
  83
  84 # "libdir" is the target directory for library (.lib) files.
  85 # Default: current directory
  86 #libdir = c:\lib
  87
  88 # SYSTEM defines the target system.
  89 # Default: (distribution specified)
  90 #SYSTEM =
  91
  92 # CFLAGS defines any parameters that should be passed to the C compiler.
  93 # Default: (distribution specified)
  94 #CFLAGS +=
  95
  96 # CXXFLAGS defines any parameters that should be passed to the C++ compiler.
  97 # Default: (distribution specified)
  98 #CXXFLAGS +=
  99
 100 # CPPFLAGS defines preprocessing directives passed to the C/C++ compilers.
 101 # Default: (distribution specified)
 102 #CPPFLAGS +=
 103
 104 # LDFLAGS defines any parameters passed to the linker.
 105 # Default: (distribution specified)
 106 #LDFLAGS +=
 107
 108 # LIBFLAGS defines any parameters passed to the library manager.
 109 # Default: (distribution specified)
 110 #LIBFLAGS +=
 111
 112 # ZIPFLAGS defines any parameters passed to the archive manager.
 113 # Default: (distribution specified)
 114 #ZIPFLAGS =