forked from kragen/myman
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathINSTALL
206 lines (156 loc) · 7.28 KB
/
INSTALL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
INSTALL - installation instructions for the MyMan video game
Copyright 2003, 2006-2009, Benjamin C. Wiley Sittler <[email protected]>
Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.
Website: http://myman.sourceforge.net/
NOTE: If you have a broken Bourne shell (Slowaris /bin/sh, for example)
you will need to substitute the path to a better shell (GNU
bash, ash, ksh, etc.) in the instructions below wherever we
refer to /bin/sh. See the end of this file for URLs for
recommended infrastructure software.
Installation from a Binary Distribution
---------------------------------------
To install MyMan from a binary distribution, first unpack the archive
(replacing VERSION with the actual myman version, and HOST with the
actual HOST type):
For compressed tarball (.tar.gz) binary distributions:
$ gunzip myman-VERSION-HOST.tar.gz &&
tar -xf myman-VERSION-HOST.tar &&
cd myman-VERSION-HOST
For ZIP archive (.zip) binary distributions:
$ unzip myman-VERSION-HOST.zip &&
cd myman-VERSION-HOST
For Mac OS X disk image (.dmg) binary distribtuions:
$ open myman-VERSION-HOST.dmg
(wait for disk image to be attached)
$ cd /Volumes/myman-VERSION-HOST
Then run the following command as `root':
# /bin/sh ./install.sh
If you would like to remove the installation files but leave behind
the uninstallation script, run the following command:
$ /bin/sh ./clean.sh
To uninstall later, run the following command as `root' from the same
myman-VERSION-HOST directory:
# /bin/sh ./uninstall.sh
Note that the binaries you install may depend on dynamically linked
libraries which will also need to be installed before myman will work.
On Linux systems you can generally determine which libraries are needed
by running 'ldd myman'; on Mac OS X systems use 'otool -L myman' instead.
Installation from Source
------------------------
While there is a `configure' script included, using it is not
mandatory -- most configuration is possible through edits to
`Makefile'.
Hopefully, a simple `make' will build you a working executable
containing all the included game variants and sizes, called simply
`myman'. If make fails, edit the makefile after reading this file, and
try again.
0. Prerequisites -- see the end of this for URLs:
(a) a working POSIX-style Bourne-compatible shell, e.g. bash, ash, or pdksh
---- substitute the full path to this shell for /bin/sh in each step below
(b) a working ANSI C compiler, e.g. gcc in the GNU Compiler Collection (GCC),
TinyCC (tcc), or Open Watcom (owcc)
---- configure this by changing the CC variable in Makefile; you can also
run myman.c directly using the Linux kernel's binfmt_c module and TinyCC;
a simple TinyCC build-and-run may be achieved on Win32 with:
tcc -DRAWCURSES -Iinc -Imygetopt \
src/utils.c src/logic.c mygetopt/mygetopt.c \
-luser32 -ladvapi32 \
-run src/myman.c
(c) a curses library, e.g. ncurses, old BSD curses, old VMS curses,
slang, PDCurses or XCurses; or libcaca, AA-lib, Twin,
LibGGI/LibGII, Allegro, newt, Carbon/Toolbox, FLTK, GTK,
Borland-style CONIO, Open Watcom-style graph.h <disp.h>, or the
Win32 Console/CONIO/TOS/AROS/VMS/*nix TTY APIs
(d) GNU Make
---- version 3.80 works; version 3.79.1 *will not work*!
(e) GNU coreutils (used: install and rmdir)
---- old fileutils, textutils and shellutils may work too but
aren't tested; set INSTALL and RMDIR if these are not the
first versions in your PATH
(f) GNU sed
---- version 4.1.5 works, and older ones probably do too; set SED
if GNU sed is not the first version in your PATH
(g) filesystem with support for long names, e.g. Linux kernel with ext2
---- old 8.3 char or 14 char name length limits *will not work*!
(h) optional: X Window System, e.g. XFree86 or X.Org
---- use the configure options --with-xterm, --with-rxvt, and/or --with-kterm
to install wrapper shell scripts
(i) optional: ctheme (useful for palette setup on Linux console)
---- use the configure option --with-ctheme to install myman.ct
(j) optional: netpbm (used for optional icon conversion)
1. Configure:
$ /bin/sh ./configure SHELL=/bin/sh <-- add any options here; see `--help'
NOTE: To save a copy of the current configuration:
$ cp config.status config.saved
and then if you later wish to restore that configuration:
$ /bin/sh config.saved
2. Build:
$ make
3. Install:
# make install <-- must be "root" for this part
4. Run:
$ myman
or (if enabled by --with-xterm)
$ xmyman <-- for X Window System
See README for detailed notes.
URLs for Recommended Infrastructure Software
--------------------------------------------
The MyMan video game is developed primarily on GNU/Linux, but other
platforms may work too provided the necessary infrastructure is in
place. The following URLs give pointers to the recommended
infrastructure software; keep in mind that other similar software may
work too, but is unlikely to have undergone much testing in
conjunction with the MyMan video game:
GNU bash http://ftp.gnu.org/pub/gnu/bash
GCC ftp://gcc.gnu.org/pub/gcc
GNU Make http://ftp.gnu.org/pub/gnu/make
GNU coreutils http://ftp.gnu.org/pub/gnu/coreutils
GNU sed http://ftp.gnu.org/pub/gnu/sed
netpbm http://netpbm.sourceforge.net/
Info-ZIP http://www.info-zip.org/pub/infozip/Zip.html
For ncurses output:
ncurses http://ftp.gnu.org/pub/gnu/ncurses
For other output drivers:
S-Lang http://www.s-lang.org/
PDCurses http://pdcurses.sourceforge.net/
libcaca http://sam.zoy.org/libcaca/
AA-lib http://aa-project.sourceforge.net/
Twin http://twin.sourceforce.net/
LibGGI/LibGII http://www.ggi-project.org/
Allegro http://www.talula.demon.co.uk/allegro/
GTK/GTK+ http://www.gtk.org/
CONIO http://conio.sourceforge.net/
FLTK http://www.fltk.org/
"TurboC CONIO" http://www.sandroid.org/TurboC/
graph.h http://www.openwatcom.org/
newt https://fedorahosted.org/newt/
For optional extras:
libiconv http://ftp.gnu.org/pub/gnu/libiconv
XFree86 ftp://ftp.xfree86.org/pub/XFree86/
ctheme http://sourceforge.net/project/?group_id=2640
TinyCC http://www.landley.net/code/tinycc/
For GNU/Linux hosting:
Debian http://www.debian.org/
Gentoo http://www.gentoo.org/
Mandriva http://www.mandriva.com/
Ubuntu http://www.ubuntu.com/
Linux kernel ftp://ftp.kernel.org/pub/linux/kernel/
For Win32 hosting:
MinGW http://www.mingw.org/
Wine http://www.winehq.org/
HX http://www.japheth.de/HX.html
For DOS hosting:
DJGPP http://www.delorie.com/djgpp/
FreeDOS http://www.freedos.org/
DOSBox http://dosbox.sourceforge.net/
For TOS hosting:
SpareMiNT http://sparemint.atariforge.net/sparemint/
AFROS http://aranym.org/afros.html
EmuTOS http://emutos.sourceforge.net/
ARAnyM http://aranym.org/
Hatari http://hatari.sourceforge.net/
For AROS hosting:
AROS http://aros.sourceforge.net/
QEMU http://bellard.org/qemu/