home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Spiele Shareware / os2games.iso / os2games / addons / pmics / readme < prev   
Encoding:
Text File  |  1994-12-14  |  8.0 KB  |  200 lines
  1.                 ==================================
  2.                 PMICS User Guide: version 1.0 BETA
  3.                 ==================================
  4.  
  5. ------------
  6. Introduction
  7. ------------
  8.  
  9. PMICS is an OS/2 interface for playing chess via Internet Chess Server
  10. (ICS).  It supports access either through a dialup shell account,
  11. available through your favourite internet service provider, or
  12. SLIP/PPP protocols such as included with the OS/2 WARP Internet
  13. Connection (and also by some internet providers).
  14.  
  15. PMICS comes with source (for what it's worth...) and is freely
  16. redistributable under the terms of the GNU General Public License.
  17. The author has no connection with the Free Software Foundation, so all
  18. bugs are his responsibility.  Comments are welcome at chow@netcom.com.
  19.  
  20. -----------------------
  21. About this beta version
  22. -----------------------
  23.  
  24. Two executables are included.  Use pmicstcp.exe if you have OS/2 Warp,
  25. and pmics.exe otherwise; you can delete the one you don't use.  Both
  26. versions support 'shell account' connections to ics, and pmicstcp.exe
  27. additionally enables TCP/IP connection using the SLIP support in Warp.
  28.  
  29. A note about bloat: The code uses the GUI class libraries in IBM
  30. C/Set++, which simplifies the logic but bloats the binary.  When
  31. packaging an application one can either include the class library
  32. DLLs, which come to 1.5MB plus the application (pmics is 180K), or
  33. bind them statically with the application which results in a 600K
  34. pmics.  So the static version looks like the lesser of two evils; in
  35. addition it loads faster.
  36.  
  37. The format of the options has changed since pmics091.  Options now
  38. have the form -option or -option=value with more intuitive names (you
  39. can use '/' instead of '-' and case is significant).  If you used
  40. pmics091, please read through the options section for the new syntax.
  41.  
  42. Fixes from the alpha version:
  43.  
  44. *  -xper and -yper options have been removed; the window now initializes
  45.    itself properly.
  46. *  autoflag won't call flag if you have run out of time, including when
  47.    both flags have fallen.
  48. *  reduced 'flashing' of the status display
  49. *  removed translation of CR->LF.  If the return key echoed '^J' on your
  50.    host this should be fixed.
  51. *  option "-bs=del" maps Backspace to ascii 127 instead of the
  52.    default ascii 8; "-cr=lf" to map Enter to ascii 10 instead of the
  53.    default ascii 13.  these functions can also be selected from the
  54.    Session... menu
  55. *  option -localecho enables a simple local echo facility; the default
  56.    is no local echo.  this may be especially helpful under tcp/ip if
  57.    you don't see your characters being echoed.  it can also be selected
  58.    from the Session... menu
  59.  
  60. Bugs:
  61.  
  62. *  Help menu items don't do anything
  63.  
  64. If you have C++/Set, there is an excellent book on using the UI class
  65. library published recently: "OS/2 C++ Class Library" by Leong, et al.
  66. VNR 1995 (ISBN 0-472-01795-2).
  67.  
  68. ----------------
  69. Installing PMICS
  70. ----------------
  71.  
  72. In addition to pmics.exe (pmicstcp.exe, if running os/2 warp), the
  73. file pmics.hlp must be copied to the working directory where you
  74. invoke pmics.  The other files are source and are not needed to
  75. run the program.
  76.  
  77.  
  78. -------------
  79. Running PMICS
  80. -------------
  81.  
  82. Typing "start pmics" will run the program in its own session.  By
  83. default it assumes there is a modem on the serial port which will be
  84. used to dial into a shell account.  It grabs the first openable COM
  85. port at 19200 baud.  If this auto-mode doesn't doesn't work for you,
  86. specify your COM port and baud rate explicitly with -port=n and
  87. -baud=nnnn, e.g.
  88.  
  89.         start pmics -port=2 -baud=2400
  90.  
  91. for COM2 at 2400 baud.  After the chessboard window comes up, connect
  92. to your host system by typing your modem's dial commands
  93. (e.g. ATDTnnnmmmm), then logging in and telnetting to ics.
  94.  
  95. To use TCP/IP (which requires OS/2 Warp and SLIP access), specify the
  96. -tcp, -tcphost and -tcpport options instead of -port, -baud and -dial:
  97.  
  98.         start pmics -tcp -tcphost chess.lm.com
  99.  
  100. If this is successful, pmics will start up with the ICS login page
  101. displayed.
  102.  
  103. Once you are connected to ICS enter the command "style 12" so that
  104. pmics can parse the game status messages.  If you are a registered
  105. user then ICS will remember the style setting next time you log onto
  106. the server and you don't need to specify it again.
  107.  
  108. If the window is not the right size, use the command line parameters
  109. -x=nnn and -y=nnn to override the default window dimensions (currently
  110. the whole desktop).  An invocation suitable for 1024x768 is:
  111.  
  112.    start pmics -medium -x=800 -y=768
  113.  
  114. These display options are orthogonal to the serial/tcp session
  115. options.  Once you determine the right options it may be convenient to
  116. encode them in a shell script or desktop icon.
  117.  
  118. Options summary:
  119.    -small             use small board and piece bitmaps (VGA).  default.
  120.    -medium            use medium board and piece bitmaps (SVGA)
  121.    -large             use giant board and piece bitmaps (1280x1024)
  122.    -port=n            specify COMn port to use.  default: autodetect
  123.    -baud=n            specify COM port baud rate.  default: 19200.
  124.    -dial=string       specify a modem init string.  this can be a dial
  125.                       command, e.g.: -dial=ATDT2614700
  126.                                      -dial="ATS11=40 DT2614700"
  127.    -x=n               specify X dimension of window in pixels
  128.    -y=n               specify Y dimension of window in pixels
  129.    -commfont=fontname specify font to use for the comm window.
  130.                       default: "System VIO"
  131.    -commfontsize=n    specify point size of comm font.  default: 14
  132.    -tcp               applies only to pmicstcp.exe, which requires OS/2 Warp.
  133.                       use tcp/ip instead of serial port
  134.    -tcphost           specifies hostname or ip address of ICS machine.
  135.                       e.g.: -tcphost=chess.lm.com
  136.                             -tcphost=192.231.221.16
  137.                       default: chess.lm.com
  138.    -tcpport           specifies port number of ICS machine.  default: 5000
  139.    -autoflag          enable autoflag (available as menubar option)
  140.    -bs=del            translate Backspace to ascii 127 instead of 8
  141.    -cr=lf             translate Enter to ascii 10 instead of 13
  142.    -localecho         enable local echo of characters typed in the comm window
  143.  
  144. -------------
  145. Playing chess
  146. -------------
  147.  
  148. Select a piece with the left mouse button and release the button over the
  149. target square.  Clicking the right button reissues the last move you made.
  150.  
  151. The Board menu has a Flip option to rotate the board 180 degrees.
  152. This is also mapped to the F3 function key.
  153.  
  154. PMICS recognizes challenge messages and pops up a dialog informing you
  155. of the match parameters.  This also works when PMICS is minimized.
  156.  
  157. You can change the font used for the terminal window using the Board
  158. menu.  You can grab the border separating the board and terminal
  159. windows and drag it to resize them.  The main use of this is to
  160. temporarily enlarge the terminal window, e.g. for viewing large chunks
  161. of text or intense chat mode.
  162.  
  163. If the displayed position or status gets scrozzled, press the refresh
  164. button.
  165.  
  166.  
  167. -----------
  168. Future work
  169. -----------
  170.  
  171. - better default board size; bypass help file not found
  172. - Various improvements: make pushbuttons customizable, provide separate
  173.   entry field for input
  174. - Hook up to gnuchess.  Need to do lots of tedious work in gnuchess
  175.   to communicate with separate process.  I guess pmchess has laid the
  176.   groundwork in this area.
  177. - I had a prototype working where gnuchess played on the ICS (under user
  178.   'fuzzy') through pmics, but need a faster machine to make this interesting.
  179.  
  180.  
  181.  
  182. --------------
  183. Update history
  184. --------------
  185. 94/12/12   1.00    (beta)
  186. 94/11/22   1.00    (alpha)
  187.  
  188.  
  189. ----------------
  190. Acknowledgements
  191. ----------------
  192.  
  193. PMICS was inspired by the excellent DOS interface, GIICS, written by
  194. Tony Acero.  The bitmaps for the pieces are taken from the GNU program xboard.
  195. Serial port IOCTL magic was adapted from the PD comm program comtalk.
  196.  
  197. Kevin Nomura
  198. chow@netcom.com
  199. 94/12/12
  200.