home *** CD-ROM | disk | FTP | other *** search
/ Informática Multimedia: Special Games (Alt) / INFESPGAMES.iso / os2 / backgam / source / installa < prev    next >
Encoding:
Text File  |  1992-09-13  |  8.8 KB  |  225 lines
  1.                    TINYFUGUE INSTALLATION FILE
  2.                    ---------------------------
  3.  
  4. Installing TinyFugue is quite easy on most systems:  simply type "make
  5. install".  However, it is designed to handle many different system and
  6. terminal types and public installation, so you may have to make some
  7. minor changes to the Makefile.
  8.  
  9.  
  10. File Locations
  11. --------------
  12.  
  13. The default file locations are based on the HOME variable.  Some versions
  14. of make do not import HOME from the environment.  If, after installing,
  15. TF tries to load "/.tfrc", you probably have one of these versions of make.
  16. The solution is to define HOME yourself in the Makefile, like this:
  17.     HOME = /my/home/directory
  18.  
  19. The Makefile defines the names of the tf executable file (EXE), the
  20. helpfile (HELPFILE), the default macro file (TFLIBRARY), and the manual
  21. page (MANPAGE).  These should be full path names.  The default
  22. directories for these are your home directory; public locations are
  23. also suggested, if you want to allow other users to run TF.  Setting
  24. the MANPAGE or HELPFILE filenames to blank will disable installation of
  25. that file.
  26.  
  27. IMPORTANT:  If you move or change the name of the macro library after
  28. installing, you must edit the TFLIBRARY line in the Makefile, and run
  29. "make install" again.  If you move or change the name of the helpfile
  30. after installing, you can either edit the HELPFILE line in the Makefile
  31. and "make install" again, or you can just change the HELPFILE macro in
  32. the macro library.
  33.  
  34.  
  35. Public Installation
  36. -------------------
  37.  
  38. A set of file locations in /usr/local is suggested in the Makefile.
  39. Uncomment these lines, and comment out the single-user defaults.
  40. "make install" will then put all files in their proper location with
  41. the proper permissions.
  42.  
  43.  
  44. Make Options
  45. ------------
  46. If you're not sure which to use, use "make install".
  47.  
  48. make install    Compile tf, (optionally) compile the Connector, build the
  49.                 help index, build macro library, and put all files in their
  50.                 proper locations.
  51. make uninstall  Remove tf, Connector, help file and index, and macro library.
  52. make clean      Remove object files and other junk from source directory.
  53. make tf         Compile tf.
  54. make TFCONNECT  Compile and install Connector.
  55. make TFLIBRARY  Build and install standard macro library.
  56. make HELP       Build and install helpfiles.
  57.  
  58.  
  59. Modifications
  60. -------------
  61.  
  62. If you make any modifications to the source (other than the Makefile),
  63. please add your name or other identification to the version[] variable
  64. in main.c (primarily to avoid confusion).  I ask that any redistributions
  65. contain my name, all the files from the orginal distribution, and the
  66. location of the original source.
  67.  
  68.  
  69. System types
  70. ------------
  71.  
  72. Also see the section on Nonblocking Connections.
  73.  
  74. BSD 4.2 or 4.3-derived systems:  No modifications necessary.
  75.  
  76. Dual-universe with SysV termio:  add -DSYSVTTY to the FLAGS line in 
  77.    the Makefile.
  78.  
  79. SysV with WINS:  add -DSYSVTTY and -DWINS to the FLAGS line in the
  80.    Makefile.  Also add '-lnet -lnsl_s' to the LIBRARIES line, in
  81.    that order.
  82.  
  83. Apollo DomainOS, using cc:  add -U__STDC__ to the FLAGS line.
  84.  
  85.  
  86. Termcap
  87. -------
  88.  
  89. Fugue's Makefile is originally configured to run with the termcap 
  90. library.  If your termcap library is buggy, you have two 
  91. alternatives:
  92.  
  93. 1. You can erase the -DTERMCAP and -ltermcap from the FLAGS and 
  94.    LIBRARIES lines respectively in the Makefile.  Fugue will then 
  95.    operate without hilites, without visual mode as an option.
  96.  
  97. 2. You can erase the -DTERMCAP and -ltermcap as above, and then 
  98.    add -DHARDCODE to the FLAGS line.  This will cause tf to 
  99.    emulate a 25x80 VT-100 or ANSI terminal.
  100.  
  101.    You can change the default lines and columns by changing the
  102.    #DEFINEs in output.c near the top of the file.  It is recommended
  103.    that you check the attributes_on() and attributes_off() functions
  104.    inside the HARDCODE code block of termcap functions to see if the
  105.    strings they output are ones that will work they way you want them
  106.    to with your particular terminal emulation.  The ones currently used
  107.    are "<ESC>[4m" for underline, "<ESC>[7m" for reverse, "<ESC>[5m" for
  108.    flashing, "<ESC>[1m" for hilite, and "<ESC>[m" for attributes off.
  109.  
  110.    If you are not using VT-100 or ANSI and wish to hardcode your 
  111.    terminal sequences, simply go into the HARDCODE code block of 
  112.    termcap functions and change the sequences to ones that will 
  113.    work.  Two things to note:
  114.  
  115.    A. The upper-left corner of the screen for VT-100 and ANSI is 
  116.       (1,1).  If your terminal type uses (0,0), make sure to 
  117.       decrement the x and y arguments in the sprintf() call in xy().
  118.  
  119.    B. Not all terminal emulations have the capability to set the
  120.       scroll area.  If you cannot do this, have the scroll()
  121.       macro do nothing, and in the HARDCODE code block in init_term()
  122.       set have_scroll = 0 instead of 1.
  123.  
  124.  
  125. Screen size
  126. -----------
  127.  
  128. TF initially determines the screen size using the termcap capabilities
  129. or the defaults in output.c.  It also attempts to read the window size
  130. from the tty at startup and whenever you change your window size,
  131. although it may fail to do this if the window size in the tty hasn't
  132. been set or is not supported by your system.
  133.  
  134.  
  135. Mail checking
  136. -------------
  137.  
  138. Tinyfugue defaults to checking mail every sixty seconds.  This comes
  139. from the -DMAILDELAY=60 on the Makefile FLAGS line.  You can get rid
  140. of mail checking by eliminating this option, or modify the delay by
  141. changing that number.
  142.  
  143. TinyFugue checks the MAIL environment variable for the name of the mail
  144. file (MAIL is usually set in sh, but not csh).  If MAIL is not set, it
  145. will look for a file with your user name in MAILDIR, defined in tf.h.
  146. Some dual-universe systems may use "/usr/mail" instead of
  147. "/usr/spool/mail" as the mail path.  If this is the case, replace:
  148.     #define MAILDIR "/usr/spool/mail/"
  149. with:
  150.     #define MAILDIR "/usr/mail/"
  151. in the file tf.h.  Remember the trailing '/'.  Other mail paths can
  152. obviously also be used.  If the path is incorrect, TF will not complain
  153. but mail checking will not occur.
  154.  
  155.  
  156. LP-MUDs
  157. -------
  158.  
  159. With /lp on, Tinyfugue's method of dealing with LP prompts is to
  160. attempt to recognize them using a delay of 1/4 second, and treat
  161. prompts and input as a cohesive block, so they are refreshed together
  162. in non-visual mode and both appear in the input window in visual mode.
  163.  
  164. The delay can be changed by putting -DLP_SWAIT=<seconds> and 
  165. -DLP_UWAIT=<microseconds> (default is 0 and 250000 respectively; 
  166. you need define only the one or other you want to change) on the 
  167. FLAGS line of the Makefile.
  168.  
  169. Delay recognition will not always work; the more the delay, the 
  170. more annoying the wait between receiving the prompt and displaying 
  171. it will be, and the more the chance of the prompt being 
  172. concatenated onto the next socket line will be.  You can have 
  173. prompts by the old method by putting -DOLD_LPPROMPTS on the FLAGS 
  174. line of the Makefile.  This is not as aesthetic as the default 
  175. method and tends to allow prompts to run together with regular 
  176. socket input, but will not cause the quirks that result when TF 
  177. confuses a partial line with a prompt.
  178.  
  179.  
  180. Nonblocking Connections
  181. -----------------------
  182.  
  183. On some systems, TF can be compiled to perform nonblocking connections
  184. to worlds.  That is, if a new /world command does not complete right
  185. away because of net lag, TF will continue trying in the background,
  186. allowing you to do other things.  It does this by running the connect()
  187. in a child process.  Nonblocking connect can be very nice on fast
  188. forking systems, but on slower machines can be annoying.  TF requires
  189. either socketpair() and sendmsg() (found in 4.3 BSD and most "modern"
  190. systems); OR pipe() with file descriptor passing, and the I_SENDFD and
  191. I_RECVFD ioctl() calls (found in System V Revision 4, but not SVR3).
  192. To install this option, you must make these changes to the Makefile:
  193. add either -DCONNECT_BSD or -DCONNECT_SVR4 to the CONNECT line, and
  194. define TFCONNECT as the full path of the connection server
  195. (/usr/local/bin/tf.connect is recomended).
  196.  
  197.  
  198. Miscellaneous
  199. -------------
  200.  
  201. If your compiler is complaining about doubly declaring or defining
  202. strstr, remove the -D_STRSTR from the FLAGS line.
  203.  
  204. If you want TF to snarf blank lines (display them locally, but not 
  205. send them to the remote) add -DSNARF_BLANKS.
  206.  
  207. If you want to be able to specify multiple-word arguments using " and '
  208. quotes (for world fields and macro arguments), add -DQUOTED_ARGS to
  209. the FLAGS line.
  210.  
  211. A "refresh" is a redisplaying of your input in non-visual mode after
  212. being overwritten by a socket line.  If you want to change the time it
  213. takes for refreshes to occur after socket lines , you can do
  214. -DREFRESH_TIME=<x>, where <x> is a number in microseconds (defaults to
  215. 250000, or 1/4 second).
  216.  
  217. If you don't want TF to catch coredumps, add -DNO_COREHANDLERS.
  218.  
  219. If your compiler is non-ANSI but does support ANSI-style prototypes, you
  220. can add -DPROTOTYPES to the FLAGS line.
  221.  
  222. You can reduce the executable size slightly by using "strip tf"
  223. after compiling.
  224.  
  225.