Debian Codegraph @

os2/README

raw
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]