home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Exec 3 / CD_Magazyn_EXEC_nr_3.iso / Recent / comm / misc / AtoZ.readme < prev    next >
Text File  |  2000-07-13  |  6KB  |  150 lines
  1. Short:    Easy Amiga/Z88 file transfer. v2.0
  2. Author:   joe@nergles.cjb.net (Joe Mackay)
  3. Uploader: joe@nergles.cjb.net (Joe Mackay)
  4. Version:  2.0
  5. Type:     comm/misc
  6.  
  7.  
  8. AtoZ v2.0
  9. ----------
  10. (C) Joe Mackay 1998-2000
  11.  
  12. Introduction
  13. ------------
  14.   AtoZ is a utility to transfer files between the Amiga and the 
  15. Cambridge Z88 portable computer via an RS232 serial link. It currently 
  16. uses the Z88's inbuilt "imp-export" protocol, although others may be
  17. implemented in the future.
  18.  
  19. Disclaimer and Distribution
  20. ---------------------------
  21.   You use this software at your own risk. The author can accept no 
  22. responsibility for any data loss caused by this software.
  23.  
  24.   This program is **FREEWARE**, but remains copyright of Joe Mackay. No 
  25. part of the program may be altered or modified in any way. It may be 
  26. distributed at will, provided the archive is left in its original state, 
  27. and no more than a nominal copying fee is charged by PD libraries. Amiga
  28. magazines, if there are actually any left, may include this software
  29. freely on their coverdisks if they so wish. The author also grants
  30. permission for inclusion with Aminet CDs, and any Sinclair-related file
  31. collections such as NVG and WOS.
  32.  
  33.   This program uses Reqtools.library, which is included in the archive.
  34. Reqtools.library is copyright (C) Nico François and Magnus Holmgren.
  35.  
  36.   There, I've said it!
  37.  
  38. Features
  39. --------
  40. - Full CLI control, with file pattern matching
  41. - Font sensitive resizable GUI (Gadtools - no Mooey here!)
  42. - Can handle single or batch files
  43. - Optional conversion of CR<->LF
  44. - Selectable serial device, unit and baud rates
  45.  
  46. This is a complete rewrite. See the history below for some of the changes
  47. in this version.
  48.  
  49. Requirements
  50. ------------
  51.   Any Amiga with KS2 or higher. A Z88 would be nice as well :-)
  52.   Oh, and you'll need a suitably-wired RS232 cable.
  53.  
  54.   Known to have been tested on the following setups so far:
  55.  
  56.   A1200, 68030/882@50MHz, 34MB, OS3.1/5, standard serial port (serial.device)
  57.   A1200, 68020/882@28MHz,  6MB, OS3.0,   ditto
  58.  
  59. Known problems
  60. --------------
  61. - Transmitting to the Z88 at a higher baud rate than 9600 may result in 
  62.   a "Poor data received" error. This is probably a Z88 problem and I doubt
  63.   if it can be fixed.
  64.  
  65. - If the Z88 reports 'Poor data received', it tends to ignore the filename
  66.   of any files subsequently received, using the name of the last file instead.
  67.   As far as I can tell this is a bug in the Imp-Export popdown - just quit
  68.   and open it again.
  69.  
  70. - If you find that you can't close the transfer window, don't worry -
  71.   transmission still reacts to CTRL-C signals when using the GUI. This
  72.   shouldn't happen unless you're trying to send a very small file and the
  73.   Z88 isn't responding - I'll try and fix the problem for the next release.
  74.  
  75. To do
  76. -----
  77.   This release of AtoZ is still fairly basic. Planned improvements are:
  78.  
  79. - Allow directory trees to remain intact
  80. - ARexx support
  81. - Support for the PCLink II protocol
  82.  
  83.   Some other possible features:
  84.  
  85. - Implement a new protocol to allow remote browsing of directories at 
  86.   both ends
  87. - Pipedream conversion
  88. - Localisation?
  89.  
  90. Credits
  91. -------
  92. Thanks to...
  93.  
  94. - Dominic Morris for his feedback, bug reports and suggestions.
  95. - Simon N. Goodwin for contacting me about the general crappiness of
  96.   AtoZ and (somehow) inspiring me to work on it again.
  97. - Steve Smith for the AtoZ webpage.
  98. - Owen Birnie for offering me his MWB icon.
  99. - All the people behind the AFC classes and the EasyGUI system for Amiga E.
  100. - Clive Sinclair and Cambridge Computers for such a nifty portable
  101.   computer!
  102.  
  103.  
  104. History
  105. -------
  106. 2.0  (06/07/00) - Complete rewrite from scratch. Erm, sorry it took so
  107.                   long. University work (and a fair bit of laziness)
  108.                   meant this had to be shoved on the back burner for a
  109.                   while.
  110.                 - Added ability to select baud rate.
  111.                 - Added proper progress indicators and a transfer window.
  112.                 - Added wildcard pattern-matching.
  113.                 - Added file-transfer list.
  114.                 - End-of-batch signals are now always sent.
  115.                 - Sending binary files can be up to 4 times faster now.
  116.                   The Imp-Exp protocol insists that non-printable chars be
  117.                   sent as a longer sequence of characters - however, the Z88
  118.                   will happily accept the characters 0-31 on their own (apart
  119.                   from ESC). Of course, the Z88 will still send these chars
  120.                   as slowly as before.
  121.                 - Wrote a rather pointless Installer script.
  122.                 - Too many other major and minor internal changes to mention.
  123.                   Suffice to say they're Good Things (tm).
  124.  
  125. 1.21 (24/07/98) - Fixed small but immensely annoying bug where the
  126.                   prefs file wasn't being loaded.
  127.                 - Yes, I know the version numbering is wrong.
  128.  
  129. 1.2  (22/07/98) - Added the ability to free/allocate the serial device
  130.                   from within the program.
  131.                 - Switched to reqtools.library for better multiple file
  132.                   selection.
  133.                 - Added CLI control.
  134.                 - Added the ability to save the event history as a plain
  135.                   text file.
  136.                 - Fixed a silly bug from v1.1 where AtoZ wasn't recognising
  137.                   "end of batch" signals from the Z88.
  138.                 - Added hidden stress-relieving feature (see if you can find
  139.                   it!)
  140.  
  141. 1.1  (27/06/98) - Improved device handling, thus allowing support for
  142.                   third-party serial devices and (hopefully) increasing the
  143.                   transfer speed.
  144.                 - Data transfers can now be aborted.
  145.                 - Numerous internal changes.
  146.                 - Patronising @{amigaguide} documentation now included :-)
  147.                 - Not released due to an Aminet bodge :-(
  148.  
  149. 1.0  (23/05/98) - First release.
  150.