README
1 OS/2 - README
2 -------------
3
4REQUIREMENTS TO RUN
5-------------------
61...OS/2 3.0 with installed Internet Access Kit or OS/2 2.x with installed
7 TCP/IP Basis Kit
82...a compiled tinyfugue-version
93...enough space on your hard-disk
104...an installed emx-runtime-package version 0.9a + emxfix6 or higher
11
12REQUIREMENTS TO COMPILE
13-----------------------
141...OS/2 3.0 with installed Internet Access Kit or OS/2 2.x with installed
15 TCP/IP Basis Kit
162...the tinyfugue-sources
173...more space on your harddisk-partition
184...an installed emx-gcc-system
19
20INSTALL
21-------
221...install the emx-runtime-package (follow the instructions in emxrt.doc)
23 you can get emxrt.zip from anonymous ftp.uni-stuttgart.de:
24 /pub/systems/os2/emx-0.9a
25 You should set these environment-variables:
26 TERMCAP...fullpath of your termcap file (e.g. "F:\EMX\ETC\TERMCAP.DAT")
27 TERM......name of your terminal defined in termcap.dat(e.g."ansi-color-3")
28 (In case you don't know: Try "help set" from an os/2-shell. Environment-
29 variables are set in your config.sys or by the OS/2-Command 'SET')
302...unzip the tinyfugue-package with "unzip -a...". You can delete src/*,
31 if you don't want to compile tinyfugue
323...set the followig environment-variables:
33 HOME......your home directory. (.tfrc or tfrc will be searched there)
34 TFLIBDIR..the full pathname of your tf-lib directory
354...setup your .tfrc-file (you can use "tfrc" for FAT-systems). Here is mine
36 as an example:
37
38 ;; turn on visual mode
39 /visual on
40 ;; turn on more-prompt
41 /more on
42 ;; wait for key after processing /sh
43 /shpause on
44 ;; change working directory to my log-dir
45 /lcd e:\tfdata
46 ;; load worlds from $(HOME)/tiny.world
47 /loadworld
48 ;; macros can be redefined
49 /redef on
50 ;; german-redefining for easier acces of /-key
51 ;;; #-key is now /
52 /def -ib'#' = /input /
53 ;;; alt-# is now #
54 /def -ib'^@+' =/input #
55 ;; load library map.tf from tf-lib
56 /load map.tf
57
58OS/2-KEYS
59---------
60Some unix-keys have special meanings within os/2 (e.g. ctrl-P == PrintScreen
61within an os/2-fullscreen-session), the os/2-version of tinyfugue comes with a
62different key-binding. The used keys are listed in os2/keys.doc.
63
64FILE tf-keys.cmd
65----------------
66Utility which let you press some keys and shows you the correct tinyfugue
67key-macro-string for redefining these keys.
68
69PROBLEMS
70--------
71Triple-check that you are using the correct emx-runtime-dll. Emx always uses
72the first emx.dll that can be found in your LIBPATH, so if you have an
73outdated emx.dll in a forgotten directory mentioned in LIBPATH...
74
75To check it, do this:
761) start an os/2-shell
772) enter "emxrev". You should get something like this:
78 EMX : revision = 36
79 ^--- this means: emxfix06
80
81 If you'll get a lower number, you are using an outdated emx.dll.
82
83BUGS
84----
85please report bugs of the os/2-version to
86
87A.Sahlbach internet:asa@stardiv.de or
88 fidonet: Andreas Sahlbach 2:241/540.11
89
90COMPILE
91-------
921...Install the emx-gcc-system.
932...You need a make-program for compiling. Currently
94 dmake (gnu-version v.3.8, can be found on hobbes) and
95 nmake (IBM-Toolkit 2.x)
96 make (GnuMake v.3.73)
97 are supported.
983...From the tinyfugue-directory start os2make.cmd from an os/2-cmd-shell. The
99 script will try to find one of the above make-programs and will produce a
100 proper makefile and config.h-file in the src-directory and start the
101 recompiling-process. You can give os2make some additional parameters:
102 "VIDEO=ANSI" will produce the ansi-scrolling-version (default)
103 "VIDEO=TERMCAP" will produce the termcap-version without scrolling.
104 "DEBUG=ON" will produce one of the above with debug-info. The
105 scrolling-version needs an IPMD-style debugger. The
106 termcap-version can be debugged with gdb.
107 "USAGE" for makefile-help
108 "CLEAN" to remove object-files after linking.
109
110