home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / com / bbs / atp07os2 / readme.os2 < prev    next >
Encoding:
Text File  |  1993-09-11  |  3.9 KB  |  112 lines
  1.  
  2. QUICK START  for IBM OS/2 2.x 
  3. -----------
  4.  
  5. 1) put the binary ATP.EXE anywhere in your path. Put EMX.DLL in your
  6.    LIBPATH. The included EMX.DLL is from EMX 0.8g. If you wish to run
  7.    ATP from the desktop, you should install it as a full screen
  8.    application. ATP will work in a window but it was designed to be
  9.    a full screen text mode application. See your OS/2 docs for info
  10.    on how to set an application to full screen.
  11.  
  12. 2) set the environment variable ATP to point to where you want ATP
  13.    message bases to reside (add this to your config.sys and reboot).
  14.    For example:
  15.  
  16.    set ATP=c:\foobar\qwks
  17.  
  18. 3) put the configuration file `atprc' in your ATP directory pointed to
  19.    by the environment variable which you set in step (2) above. Edit
  20.    the `atprc' file to your personal taste and circumstances.
  21.  
  22. 4) put the taglines file "taglines.atp" in your ATP directory.
  23.  
  24. 5) edit the following entries in your atprc :
  25.    
  26.     a) user = Your Name
  27.  
  28.     b) editor = your_editor
  29.  
  30.     c) mail = \your\mail\path\for\new\QWK\packets
  31.  
  32.     d) reply = \your\reply\path\for\outgoing\rep\packets
  33.  
  34.  
  35. 6) enter `atp' at the prompt to start atp.
  36.  
  37. 7) at ATP's prompt enter `load bbsname.qwk' to view your first packet.
  38.  
  39. 8) type `help' for help, `q' for quit.
  40.  
  41. 9) read the docs!
  42.  
  43. 10) read the docs!!
  44.  
  45. OS/2 TIPS
  46. ---------
  47.  
  48. ATP is a full screen text-mode application for OS/2. If you wish
  49. to run ATP from the desktop, be sure to set ATP to full screen
  50. mode using OS/2.
  51.  
  52. Please read the docs to get the most out of ATP. ATP functions like
  53. a mini-shell and allows you to enter many common system commands from
  54. the command line. It is very powerful and allows you to navigate QWK
  55. message bases with a couple key strokes. But you will have to read
  56. the docs ...
  57.  
  58. Note that your COMSPEC variable must point to a command interpreter
  59. which must be compatible with CMD.EXE at the switch level (i.e. it must
  60. accept options introduced by the foreslash instead of the Unix style
  61. dash: /c instead of -c). If your COMSPEC points to BASH.EXE you might
  62. experience problems. There is a workaround if you need BASH or KSH to
  63. be your secondary shell; send me e-mail if you need info. Note that 
  64. BASH as your *primary* shell will work fine with ATP.
  65.  
  66. Your choice of editor is important. Many "ports" of Unix editors to OS/2
  67. lack the ability to reference a file by absolute path (including drive
  68. letter). This is because those who "ported" these softwares overlooked
  69. the fact that OS/2 (and DOSish operating systems in general) require a
  70. drive letter in an absolute path designator. One nice Unix style editor
  71. that does work well with ATP for OS/2 is ELVIS 1.7.  
  72.  
  73. Note: the 1989 version of PKzip for OS/2 has many known bugs. Please
  74. don't use it. The freeware ZIPs from Info-Zip are *highly* recommended
  75. instead. 
  76.  
  77. COMPILING ATP
  78. -------------
  79.  
  80. ATP.EXE for OS/2 2.x was compiled using EMX 0.8g (which is based
  81. on GCC 2.4.5)  under OS/2 2.1 and linked with a modified
  82. Salz/Tumlee editline library. The file "makefile.os2" should work
  83. with either DMAKE or GNU MAKE when used with EMX. Remember that
  84. these makes will require you to use a command line of the form:
  85.    
  86.                 make -f makefile.os2
  87.  
  88. This "-f" switch is to insure that make selects the correct makefile
  89. for the build. If you need a current version of GNU make for OS/2,
  90. send me e-mail for information on my port of GNU make for OS/2.
  91.  
  92. CONTACT INFO
  93. ------------
  94.  
  95. Comments and bug reports welcome.
  96.  
  97. thanks,
  98.  
  99. Thomas McWilliams (KI4N)
  100. P.O. Box 7545
  101. Arlington, VA  22207
  102. USA
  103.  
  104. email: Internet:  thomas.mcwilliams@f615.n109.z1.fidonet.org
  105.        Fido    :  netmail to 1:109/615
  106.  
  107. I can also be found in the RIME, FIDO, and SmartNet Unix and
  108. Offline conferences, and I usually monitor comp.os.linux.* .  You
  109. may also leave me a message at Enlightened BBS (703) 370-9528 or
  110. Brodmann's Place BBS (301) 843-5732.
  111.  
  112.