README
1 Hello folks !
2
3
4This is libmikmod, version 3.3.11, a portable sound library for Unix.
5Check out the file 'NEWS' for more history information.
6
7
8>> BUILDING LIBMIKMOD
9---------------------
10
11- If you're not building libmikmod for Windows, then you're lost in the
12 sources. Go up one directory, and read the main README file.
13
14So, you're on an angry fruit salad Windows system, aren't you ? With
15those so cute icons and an overflowed system tray ?
16
17Currently, libmikmod can be build under Windows with the Microsoft
18compiler, lcc-win32 and MinGW (I suppose that the Watcom compiler and Metrowerks
19Codewarrior could be used as well).
20
21You'll need the DirectX SDK (if not included with the compiler) to
22compile the DirectSound driver; version 5 or better is required. The
23standard Win32 SDK is enough for the winmm driver.
24
25Oh, I almost forgot: you need long filenames to compile libmikmod, but
26that should not be a problem nowadays.
27
28
29-- Instructions for Microsoft Compiler
30
31Use one of the project files to build a dll and an import library: MSVC6
32for the old Visual C 6, or VS2005 for Visual Studio 2005 and newer.
33To make your library ready to use, copy the file 'mikmod.h' to your
34compiler include directory, and 'mikmod.lib` to your compiler libraries
35directory. You also have to put 'libmikmod.dll' somewhere in your PATH.
36
37HTML documentation of the library, for programmers, is located in the
38doc directory.
39
40-- Instructions for lcc-win32
41
42Use Makefile.lcc
43
44-- Instructions for MingGW
45
46Use Makefile.mingw
47
48>> THANKS
49---------
50
51I would like to thank everyone who contributed to libmikmod. Their names
52are in the AUTHORS file for the significative contributions, but some
53other names can be found in the NEWS file. Thanks a lot ! Keeping
54libmikmod alive wouldn't be much fun without you.
55
56
57>> LICENSE
58----------
59
60The libmikmod sound library is covered by the GNU Library General Public
61License as published by the Free Software Fundation (you'll find it in
62the file COPYING.LIB); either version 2 of the licence, or (at your
63option) any later version.
64
65The GNU Lesser General Public License, version 2.1, in file
66COPYING.LESSER, can be considered as a later version of the LGPL, and is
67strongly recommended for people who will embed libmikmod in their
68application as a shared library.
69
70Parts of the library (in playercode/mdulaw.c) are derived from the files
71libst.h and raw.c from an old version of the sox (SOund eXchange)
72package written by Lance Norskog and Jef Poskanzer. The following
73copyright notice applies to these parts:
74
75 Copyright (C) 1989 by Jef Poskanzer.
76
77 Permission to use, copy, modify, and distribute this software and its
78 documentation for any purpose and without fee is hereby granted, provided
79 that the above copyright notice appear in all copies and that both that
80 copyright notice and this permission notice appear in supporting
81 documentation. This software is provided "as is" without express or
82 implied warranty.
83
84Note that none of these parts are used in the Win32 version of the
85libmikmod library.
86
87
88>> CONTACT AND DOWNLOAD INFO
89----------------------------
90
91libmikmod home page is located at SourceForge:
92
93 http://mikmod.sourceforge.net/
94 http://sourceforge.net/projects/mikmod/
95
96There's a mailing list (mikmod-public) for discussing the development
97of MikMod (new features, bugs, ideas...) Look for more information on
98the web site.
99
100
101>> LAST NOTES
102-------------
103
104I hope you'll enjoy using this version of libmikmod as well as I enjoyed
105debugging and improving it.
106
107-- Miod Vallat, 01/24/2002
108 miod@mikmod.org
109