| 1 |
Hello folks ! |
| 2 |
|
| 3 |
|
| 4 |
This is libmikmod, version 3.3.13, a portable sound library for Unix. |
| 5 |
Check out the file 'NEWS' for more history information. |
| 6 |
|
| 7 |
|
| 8 |
>> BUILDING LIBMIKMOD |
| 9 |
--------------------- |
| 10 |
|
| 11 |
- If you're not building libmikmod for OS/2, then you're lost in the |
| 12 |
sources. Go up one directory, and read the main README file. |
| 13 |
|
| 14 |
So you're on a good old OS/2 system, aren't you ? With a customized |
| 15 |
Object Desktop or some equivalent tool collection ? |
| 16 |
|
| 17 |
I hope you've installed REXX support during the system installation. If |
| 18 |
you didn't, you lose. Run 'selective install' from the system setup |
| 19 |
folder, install REXX support, check it works, and come back here. |
| 20 |
|
| 21 |
Currently, libmikmod can be build under OS/2 only with the Watcom compiler |
| 22 |
(tested with OpenWatcom 1.9) or with the EMX compiler (not tested). You'll |
| 23 |
need the MMPM/2 toolkit (included in all the Warp toolkits) to compile the |
| 24 |
MMPM/2 driver. The Warp4 toolkit is required if you want to build the DART |
| 25 |
driver, too. |
| 26 |
|
| 27 |
You need long filenames to compile libmikmod, so you'll have to compile it |
| 28 |
on an HPFS drive, or an ext2fs drive, or a network drive where you can |
| 29 |
use decent-size filenames. |
| 30 |
|
| 31 |
For EMX, run: |
| 32 |
make -f Makefile.emx dll |
| 33 |
|
| 34 |
For Watcom, run: |
| 35 |
wmake -f Makefile.wat |
| 36 |
|
| 37 |
and you'll get your mikmod3.dll and its import lib in this directory. |
| 38 |
Edit the makefiles in case you need to customize the build options, or |
| 39 |
you want to make a static library, and/or want to learn any details. |
| 40 |
|
| 41 |
If the build fails, I'd like to hear from you to correct the problem. |
| 42 |
|
| 43 |
To make you library ready to use, copy the file '..\include\mikmod.h' |
| 44 |
to your compiler include directory, and 'mikmod.lib' to your compiler |
| 45 |
library directory. If you built a DLL, put the DLL (mikmod3.dll) in a |
| 46 |
directory which appears in your LIBPATH. |
| 47 |
|
| 48 |
HTML documentation of the library, for programmers, is located in the |
| 49 |
doc directory. |
| 50 |
|
| 51 |
|
| 52 |
>> THANKS |
| 53 |
--------- |
| 54 |
|
| 55 |
I would like to thank everyone who contributed to libmikmod. Their names |
| 56 |
are in the AUTHORS file for the significative contributions, but some |
| 57 |
other names can be found in the NEWS file. Thanks a lot ! Keeping |
| 58 |
libmikmod alive wouldn't be much fun without you. |
| 59 |
|
| 60 |
|
| 61 |
>> LICENSE |
| 62 |
---------- |
| 63 |
|
| 64 |
The libmikmod sound library is covered by the GNU Library General Public |
| 65 |
License as published by the Free Software Fundation (you'll find it in |
| 66 |
the file COPYING.LIB); either version 2 of the licence, or (at your |
| 67 |
option) any later version. |
| 68 |
|
| 69 |
The GNU Lesser General Public License, version 2.1, in file |
| 70 |
COPYING.LESSER, can be considered as a later version of the LGPL, and is |
| 71 |
strongly recommended for people who will embed libmikmod in their |
| 72 |
application as a shared library. |
| 73 |
|
| 74 |
Parts of the library (in playercode/mdulaw.c) are derived from the files |
| 75 |
libst.h and raw.c from an old version of the sox (SOund eXchange) |
| 76 |
package written by Lance Norskog and Jef Poskanzer. The following |
| 77 |
copyright notice applies to these parts: |
| 78 |
|
| 79 |
Copyright (C) 1989 by Jef Poskanzer. |
| 80 |
|
| 81 |
Permission to use, copy, modify, and distribute this software and its |
| 82 |
documentation for any purpose and without fee is hereby granted, provided |
| 83 |
that the above copyright notice appear in all copies and that both that |
| 84 |
copyright notice and this permission notice appear in supporting |
| 85 |
documentation. This software is provided "as is" without express or |
| 86 |
implied warranty. |
| 87 |
|
| 88 |
Note that none of these parts are used in the OS/2 version of the |
| 89 |
libmikmod library. |
| 90 |
|
| 91 |
|
| 92 |
>> CONTACT AND DOWNLOAD INFO |
| 93 |
---------------------------- |
| 94 |
|
| 95 |
libmikmod home page is located at SourceForge: |
| 96 |
|
| 97 |
http://mikmod.sourceforge.net/ |
| 98 |
http://sourceforge.net/projects/mikmod/ |
| 99 |
|
| 100 |
There's a mailing list (mikmod-public) for discussing the development |
| 101 |
of MikMod (new features, bugs, ideas...) Look for more information on |
| 102 |
the web site. |
| 103 |
|
| 104 |
|
| 105 |
>> LAST NOTES |
| 106 |
------------- |
| 107 |
|
| 108 |
I hope you'll enjoy using this version of libmikmod as well as I enjoyed |
| 109 |
debugging and improving it. |
| 110 |
|
| 111 |
-- Miod Vallat, 01/24/2002 |
| 112 |
[email protected] |