home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / wps / com / zoc / readme.doc < prev    next >
Text File  |  1994-02-24  |  11KB  |  330 lines
  1.  
  2. =NEWS====================================================================
  3.  
  4.    * Visa-, Euro- and Master-Card accepted (see Help, Registration)
  5.    * see VERSIONS.DOC for all [NEW] features!
  6.    * kermit now supports server mode
  7.    * see below for installation information
  8.    * CAUTION! the LEDs cause heavy system usage when downloading (I
  9.      added a third state where LEDs are enabled, but off during 
  10.      file transfers)
  11.  
  12. =========================================================================
  13.  
  14.    !!!   To encourage you not to skip this text, it contains    !!!
  15.    !!!   information of how to get rid of it (when shown after  !!!
  16.    !!!   program start).                                        !!!
  17.     
  18. =========================================================================
  19.  
  20.    CONTENTS 
  21.  
  22.        1. ABOUT THIS VERSION
  23.        2. DISTRIBUTION, COPYRIGHT
  24.        3. INSTALLATION/REINSTALLATION
  25.        4. ZOC PRIMER
  26.        5. TAP_GIF.EXE
  27.        6. PIPCISB.DLL/PIPKERM.DLL
  28.        7. PHONE BOOK CONVERTERS, ZOC RELATED FILES
  29.        8. DEVELOPER INFORMATION
  30.        9. A FEW REQUESTS TO THE OS/2 COMMUNITY
  31.  
  32.    (changes marked with [*]): 
  33.  
  34. -----------------------------------------------------------------------
  35.  
  36.  
  37.  
  38. -----------------------------------------------------------------------
  39.     1. ABOUT THIS VERSION
  40. -----------------------------------------------------------------------
  41.  
  42.     Compared to earlier versions 1.0 you will find some improvements
  43.     (check VERSIONS.DOC) and I hope that I got rid of most of the bugs.
  44.  
  45.     I don't like uncertain announcements, but people keep asking
  46.     for release dates of later versions.  All I say is that there will
  47.     be a V1.3 (maybe around April) and V2.0 will come somewhen in the 
  48.     3rd or 4th quarter of 1994 (beta versions (V1.9x) might pop up 
  49.     earlier).
  50.  
  51.  
  52. -----------------------------------------------------------------------
  53.     2. DISTRIBUTION, COPYRIGHT
  54. -----------------------------------------------------------------------
  55.  
  56.     ZOC is shareware, (C) by Markus Schmidt, 1994
  57.  
  58.     You may use and test this software for 30 days, then you have
  59.     to register or remove it from your system.
  60.  
  61.     No warranty of any kind can be given for damage caused through 
  62.     ZOC directly or indirectly. 
  63.  
  64.     ZOC may be distributed freely via telecommunication, shareware
  65.     dealers or as a free add on for hard- or software products in form
  66.     of an unmodified ZIP archive, or as unzipped files in an single 
  67.     directory with the name ZOC and with no file added, removed or 
  68.     modified.
  69.  
  70.     The following restrictions apply to distribution.
  71.  
  72.      * ZOC must not be used in an army environment or for purposes 
  73.        that are related to military or arms production.
  74.  
  75.      * ZOC must not be sold as shareware for more than $5/DM 7
  76.        (that includes shipping). If you purchased ZOC from a dealer
  77.        paying more (or get knowledge of such a dealer), notify him 
  78.        of this regulation.
  79.  
  80.      * ZOC must not be bundled with any Microsoft(+) product.
  81.  
  82.  
  83.  
  84.  
  85. -----------------------------------------------------------------------
  86.     3. INSTALLATION/REINSTALLATION
  87. -----------------------------------------------------------------------
  88.  
  89.     Unpacking the ZIP file:
  90.     -----------------------
  91.  
  92.     If you use PKUNZIP, you need to unpack the ZIP file with the -d
  93.     option. This should create a directory structure like this.
  94.  
  95.         .\ZOC\OPTIONS
  96.         .\ZOC\SCRIPT
  97.         .\ZOC\LOG
  98.         .\ZOC\UPLOAD
  99.         .\ZOC\DOWNLOAD
  100.  
  101.     If you get a new version of ZOC and want to install it over
  102.     your existing one, you should not overwrite the following
  103.     files (most unpackers will prompt you for permission to 
  104.     overwrite a file):
  105.  
  106.         .\ZOC\PHONEBK          (your phone book)
  107.         .\ZOC\OPTIONS\*        (your option files)
  108.  
  109.     All other files should be replaced (maybe except .\SCRIPT\XDIAL
  110.     and .\SCRIPT\QUEDIAL if you changed them manually).
  111.  
  112.  
  113.  
  114.  
  115. -----------------------------------------------------------------------
  116.     4. ZOC PRIMER
  117. -----------------------------------------------------------------------
  118.  
  119.     There are a few things you should know about ZOC before you
  120.     begin. These things are also described in the help file, but you
  121.     might run into problems before you find them there.
  122.  
  123.  
  124.     Registration/Orders:
  125.     --------------------
  126.  
  127.     If you need any information about ordering and registration see
  128.     Help for Registration in the help menu of ZOC. 
  129.  
  130.     Here's a quick summary:
  131.  
  132.     As you already might know, ZOC is a shareware program. During
  133.     the beta phase I had some lively discussions about 'crippling' (how
  134.     I hate that word) shareware. Early versions of ZOC had a restriction
  135.     in the ZModem download that was removed as a result of these dis-
  136.     cussions. Now the order form is shown after download.
  137.  
  138.     If you want to register, just fill out the order form and send me a 
  139.     hardcopy. You find my address and prices in the helpfile. 
  140.  
  141.     Even in times in which the world is called a 'global village' it is
  142.     quite a bit hard to transfer money from the United States to Germany.
  143.     Methods of payment are described in the helpfile - the easiest way 
  144.     to register is using the Compuserve shareware registration feature
  145.     (which, of course, requires that you have a Compuserve account).
  146.     It is also described in the helpfile.
  147.  
  148.  
  149.  
  150.     If you have problems:
  151.     ---------------------
  152.  
  153.     Everything important is in the helpfile. Select 'contents' from
  154.     the help menu or press the help button in the dialog windows.
  155.  
  156.     Also check the 'common problems' section before contacting me.
  157.  
  158.  
  159.  
  160.     Starting ZOC:
  161.     -------------
  162.  
  163.     ZOC needs a parameter to tell it which com port to use (check the
  164.     help file for a more detailed discussion of these parameters). 
  165.  
  166.       ZOC [/M] [/U] [/S:<script>] [/W:<width>] [/H:<height>] [COMx]
  167.  
  168.     If you do not want to enter the com parameter every time you start 
  169.     ZOC you can set an evironment variable in your CONFIG.SYS or 
  170.     STARTUP.CMD
  171.  
  172.       SET ZOCDEVICE=COMx 
  173.  
  174.     If no com port is given via parameter or environment variable,
  175.     ZOC scans for a free com port and uses the first available port. 
  176.  
  177.  
  178.  
  179.     Startup files:
  180.     --------------
  181.  
  182.     When ZOC is started it searches two files for automatic processing:
  183.  
  184.         .\OPTIONS\STANDARD    (default options file)
  185.         .\SCRIPT\STARTUP      (sort of autoexec script)
  186.  
  187.  
  188.  
  189.     Changes, new features:
  190.     ----------------------
  191.  
  192.     If you get a new version of ZOC look into the VERSIONS.DOC file
  193.     for new features, changes and fixed bugs. Especially looking at
  194.     the new features might show you functions that you might otherwise 
  195.     miss because the description is buried somewhere in the helpfile
  196.     (and no one reads the entire helpfile each time a new version 
  197.     appears).
  198.  
  199.  
  200.  
  201.     Startup window:
  202.     ---------------
  203.  
  204.     Getting rid of this window is easy. Go to the command prompt and
  205.     rename or delete the README.DOC file.
  206.  
  207.  
  208.  
  209.  
  210. -----------------------------------------------------------------------
  211.     5. TAP_GIF.EXE
  212. -----------------------------------------------------------------------
  213.  
  214.     TAP_GIF.EXE is an online gif viewer for downloads. It was written
  215.     by a friend of mine, using the developer interface (see below) of 
  216.     ZOC. 
  217.     It can be started manually before, or automatically at the begin 
  218.     of a GIF download (even if downloaded via external protocol (see 
  219.     PIPCISB.DLL)).
  220.  
  221.     It is quite self explanatory. If you have questions about it,
  222.     write to M.GOEMMEL@MSN.RMI.DE
  223.  
  224.  
  225.  
  226.  
  227. -----------------------------------------------------------------------
  228.     6. PIPCISB.DLL/PIPKERM.DLL
  229. -----------------------------------------------------------------------
  230.  
  231.     ZOC contains an interface for implementation of sophisticated 
  232.     external file transfer protocols. Two such protocols are bundled 
  233.     with the ZOC package:
  234.  
  235.         PIPCIS.DLL     (an implementation of the Compuserve B+ protocol
  236.                         written by M.Goemmel).
  237.  
  238.         PIPKERM.DLL    (an implementation of the Kermit Protocol
  239.                         written by M.Goemmel).
  240.  
  241.     If you have questions about them, write to M.GOEMMEL@MSN.RMI.DE
  242.  
  243.  
  244.  
  245.  
  246. -----------------------------------------------------------------------
  247.     7. Phone book converters/ZOC related files
  248. -----------------------------------------------------------------------
  249.  
  250.     There already is a phone book converter (from Telix and Telemate)
  251.     to ZOC (ZOCBKxxx.ZIP).
  252.  
  253.     Others will show up and the ZOCDEV.ZIP (developer info) file contains
  254.     a skeleton C source for such a converter.
  255.  
  256.     The converter and other ZOC related files will be made available
  257.     on the support bbs (see below) and on Compuserve.
  258.  
  259.  
  260.  
  261. -----------------------------------------------------------------------
  262.     8. Developer infomation
  263. -----------------------------------------------------------------------
  264.  
  265.     If you are interested in developing add ins for ZOC you should
  266.     try to find a version of ZOCDEV.ZIP (e. g. from Compuserve).
  267.  
  268.     This file contains everything (including sample source code) needed
  269.     for developing TAPs (file transfer add ons) or PIPs (file transfer
  270.     protocols).
  271.  
  272.     If you plan to implement the terminal side of PIPs or TAPs, you
  273.     can request the source code used for servicing these from me. It
  274.     would be a big step forward if the OS/2 family would had a 
  275.     standard for external protocols (like XPR for the Amiga world).
  276.  
  277.  
  278.  
  279. -----------------------------------------------------------------------
  280.     9. A few requests to the OS/2 community
  281. -----------------------------------------------------------------------
  282.  
  283.     There are a few things that I would like to ask you for:
  284.  
  285.     1. Please distribute this program. I upload current versions only
  286.        to Compuserve and not everyone does have an account there.
  287.  
  288.     2. If you find spelling errors or odd sentences, please send me
  289.        a mail. English is not my native languange.
  290.  
  291.     3. Are you interested in promoting the PIP/TAP interface and
  292.        do you want to play the 'host of truth' for them?
  293.        OS/2 needs a sophisticated standard for external protocols
  294.        (that does not mean that PIP/TAP already provides this).
  295.     
  296.  
  297.  
  298. -----------------------------------------------------------------------
  299.     I HOPE YOU ENJOY USING ZOC
  300. -----------------------------------------------------------------------
  301.  
  302.     Yours,
  303.  
  304.         Markus Schmidt
  305.  
  306.  
  307.  
  308.     Markus Schmidt
  309.     Waagstr. 4
  310.     90762 Fuerth
  311.     - Germany -
  312.  
  313.     Internet: M.Schmidt@msn.rmi.DE
  314.     Compuserve: 100101,3256
  315.  
  316.     Tel. + 49 911 7499380
  317.  
  318.     FAX. + 49 911 7499380 or
  319.          + 49 911 319 3618 (use this number only, if you have problems 
  320.                             sending to the other fax machine!)
  321.  
  322.     Support BBS: + 49 911 9933662 (login as ZOC)
  323.  
  324.     Please check the help file (Contacting the Author, Common Problems)
  325.     before sending me e-mail.
  326.  
  327. -----------------------------------------------------------------------
  328.  
  329.  (+) Microsoft is a trademark of Microsoft, Inc.
  330.