home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / disks / disk458.lzh / ATCopy / Docs / Manual < prev    next >
Text File  |  1991-02-15  |  11KB  |  225 lines
  1.           ATCopy2.2    (c) Copyright 1991 by Peter Vorwerk    ATCopy2.2
  2.  
  3.           Bugfixing to version 2.1: 
  4.           
  5.           In version 2.1 the conversion of national chars won't
  6.           work properly. In fact they wont't work at all. Now this
  7.           bug has been fixed.
  8.           
  9.           New in version 2.2:
  10.  
  11.           The options and the PC path now could be changed by
  12.           gadgets. These gadgets will show the defaults you
  13.           have specified by CLI. If you click one gadget twice it
  14.           will turn off. ATTENTION: By a refreshing error the string
  15.           gadget for the PC path seems to have no cursor after you
  16.           had clicked it. But it will be active! The options means
  17.           exactly the same as in the programs AREAD and AWRITE on
  18.           the XT/AT board.
  19.  
  20.           If you specify an not existing drawer on the
  21.           XT/AT side it will be gererated first. But at
  22.           least the parend of this must already exists.
  23.  
  24.           In this version the program will show an Alert, if you try
  25.           to write to an write-protect or an full diskette. May be
  26.           this will change in a new version.
  27.  
  28.           The new patch program will work with both new
  29.           vesions of ATCopy.
  30.  
  31.           With the program 'Patch_Option' you can modify
  32.           the 'default' option. This can be done by
  33.  
  34.           Patch_Option ATCopy opt [path]
  35.           
  36.           With this program you can modify ATCopy2.2 to
  37.           work with your own defaults if you don't select
  38.           some by CLI or WB.
  39.           
  40.           The ORGINAL manual for the new requester is
  41.           included. Please read this manual, espacialy for
  42.           EXTENDET SELECT MODE. This mode is supported.
  43.  
  44.           This filerequester ist (c) 1990 by Khalid Aldoseri.
  45.           
  46.           Thanks to Oliver Denzler for the new icon.
  47.           
  48.           Also thanks to all those sending bugreports, improvements
  49.           or money. This helped me to update the program.
  50.           
  51.           Know Bug: If you call the program from workbench, you will
  52.           lose 24 Bytes of memory. If you use the CLI, this won't
  53.           happen. I can't fix this bug.
  54.  
  55.           The included program Demo_of_ATCopy3.0 should be created
  56.           in this manner. If you miss some utilities or if you have
  57.           any improvements, please write me a short note.
  58.  
  59.           -------------------------------------------------------------
  60.  
  61.           New in version 2.1:
  62.  
  63.           Now you will find two versions of the program
  64.           ATCopy2.1. These two versions differ only in the
  65.           messages. One will print these in english and
  66.           the other in german.
  67.     
  68.           In the new  version 2.1 the  length of  a file will no longer
  69.           change if you use the OPT B option.  This caused some trouble
  70.           if you use compressed files.  Thangs to  Jeff Christensen for
  71.           reporting this bug.
  72.  
  73.           -------------------------------------------------------------
  74.  
  75.           The program  ATCopy2.0 is  an update for the version 1.0. But
  76.           this new version is SHAREWARE instead of PD. If you find this
  77.           program  useful  and  use  it  regular,  please send $10 ( or
  78.           DM 10 ) to the follow address.
  79.  
  80.                     Peter Vorwerk
  81.                     Jägerstr. 3-5
  82.  
  83.                     (W) 3000 Hannover 1
  84.                     Germany
  85.  
  86.           The program may be distributed for non-profit only  ( a price
  87.           of more  than $7  per diskette  is surely no more a self cost
  88.           price ! ) and this manual is  also copied.  ( You are allowed
  89.           to copy  only the program without the manual to your harddisk
  90.           or your workdisk, but you are not permitted to distribute the
  91.           software in this form! ) If you want to include this software
  92.           in an other library,  than in  the one  of Fred  Fish, please
  93.           contact me frist.
  94.  
  95.           Surely everyone,  who have an Amiga with an XT/AT Board ( the
  96.           older SideCar works well  too ), knows  it is  principle pos-
  97.           sible to copy files between the two computers. But the way to
  98.           do this is not very comfortable.  In the  new version  of the
  99.           Janus.library  ( 2.63  respectively  33.1 ) you can use wild-
  100.           cards, but only in one  direction  ( form  the  XT/AT  to the
  101.           Amiga ). Let's  say you  want to  copy several files from the
  102.           Amiga to the XT/AT, you have to copy each file seperatly. The
  103.           first relase  of ATCopy  produced a scriptfile with the sepe-
  104.           rate commands. Now we skip this step and  translate the files
  105.           direct through  the socalled Dual-Ported-RAM. The program has
  106.           an icon and can be startet from the  workbench. If  you start
  107.           the program  without any  parameters, the files will be asked
  108.           for interactiv by the well known  ARP-Filerequester. From the
  109.           CLI you  are able  to specify  beside the filenames two other
  110.           parameters.
  111.  
  112.                USAGE: ATCopy Files...,TO/K,OPT/K
  113.  
  114.           Files...  means a list of filenames, the keyword
  115.  
  116.           TO        specify the PC-path  ( for  example  <TO  A:> means
  117.                     that all  files are  send to the floppy A: . If you
  118.                     don't specify the keyword  TO,  the  files  will be
  119.                     send  to  the  current  PC-path. )  and  after  the
  120.                     keyword
  121.  
  122.           OPT       you can specify one ( and only one ) of  the follow
  123.                     options.
  124.  
  125.                B    Translate  the  files  binary  ( no  conversion  of
  126.                     characters  and  CR's  will  not  be  translated in
  127.                     CRLF's. )
  128.  
  129.                CR   Translate the  files with conversion of characters,
  130.                     but also CR's will not be translated in CRLF'.
  131.  
  132.                NC   Translate  the  files  binary  and  CR's   will  be
  133.                     translated in CRLF's.
  134.  
  135.           The keywords TO and/or OPT MUST be typed! You can't type '/B'
  136.           to transfer files binary. Please note also, that you are not
  137.           able to type files after any option. The PC path is an option
  138.           too. So if you type:
  139.           
  140.               ATCopy file1 TO C: OPT B file2
  141.           
  142.           only 'file1' will be copied to c: binary, but not 'file2'.
  143.  
  144.           If you don't specify the keyword OPT the files will be trans-
  145.           lated by full conversion. This means both conversion of char-
  146.           acters and CR's will be translated in CRLF's. This is the way
  147.           the new programs AREAD  and  AWRITE  works.  These  files are
  148.           distributed by Commodore with the XT/AT Board. If you use the
  149.           program  ATCopy  from  the  workbench  you  can't  ( at  this
  150.           time ? ) use  the keywords  TO and  OPT. The  program use the
  151.           standards ( current directory and full conversion ).
  152.  
  153.           INSTALLATION
  154.  
  155.           On the diskette you will find a subdirectory  called PC. This
  156.           directory   contain   three   programs   AT.EXE,  XT.EXE  and
  157.           PCCOPY.EXE. At least two of this programs you must copy by 
  158.  
  159.                AREAD DF0:ATCopy/PC/name.EXE A:name.EXE /B
  160.  
  161.           to  the  XT/AT.  In  each  case  you  will  need  the program
  162.           PCCOPY.EXE and  it depends  on your  board the file XT.EXE or
  163.           AT.EXE ( who had thought this ? ). The program  PCCOPY.EXE is
  164.           memoryresident and  need start  only once, for example in the
  165.           AUTOEXEC.BAT ( this is the  Startup-Sequence of  the XT/AT ).
  166.           The  programs  XT.EXE  and  AT.EXE  are  called  by the Amiga
  167.           program ATCopy. Therefore it is necessary  that at  this time
  168.           no program  is running.  You are  in the CLI of the XT/AT and
  169.           you are able to start a new program.  This limitation  is not
  170.           very well,  but I don't know how to start a PC-Interrupt from
  171.           my own Amiga-program or how to start a  program at  the XT/AT
  172.           by a  hotkey let's say ALT-2. If someone knows details on one
  173.           of these questions, please write me a short note. I  think it
  174.           could be an other way of pay the SHAREWARE.
  175.  
  176.           The usage  from the  Amiga is already descripted above and so
  177.           it's not necessary to repeat it again.
  178.  
  179.           NOTE:     The  program  needs  the   ARP.library  ( at  least
  180.                     version 39. ).
  181.  
  182.           Please  notice  that  on  an  XT/AT  you  can't  use  all the
  183.           characters in filenames that are available for the  Amiga. In
  184.           fact the  space, nationalcharacters  or the  sqare braces are
  185.           not supported.  Please  notice  that  also  there  are strict
  186.           limitations in  the lenght of the filename and the extension.
  187.           Only one extension with 3 characters and 8  characters before
  188.           the  dot  "."  are  allowed. You can't use filenames starting
  189.           with a dot. so ".info" is no legal filename and the two names
  190.           "DemoDatei.info" and  "DEMODATE.INF" specify the same file on
  191.           an XT/AT ! 
  192.  
  193.           Everyone who had paid the SHAREWARE will get updates as quick
  194.           as possible and  even can get  the soure if  he/she want  it.
  195.           Please give me a short description of your enviroment. I need
  196.           this because if the program wont work in a special enviroment
  197.           it is easyer for  me to send  the new version first to  these
  198.           people who have this special enviroment.
  199.  
  200.           Bugreports or improvements are welcome.
  201.  
  202.           I hope  that the  translation from  the Amiga to the XT/AT is
  203.           easyer using this program.
  204.  
  205.           My program  use  parts  of  the  ARP.library  ( especialy the
  206.           Filerequester and  the routine  GADS ). Without  this help it
  207.           had been ( nearly )  inpossible  to  write  the  program. I'm
  208.           sorry,  but  the  informations  by the Janus.library are very
  209.           rarely. Therefore it can be  that  the  program  ATCopy don't
  210.           work in  all parts  on all configurations. ( I have tested it
  211.           on my own Amiga 2000 with AT Board and on an Amiga  1000 with
  212.           SideCar. I don't had access to an XT Board. )
  213.  
  214.           P.S. There  is  one  more  limitation by starting the program
  215.                from the workbench. You can't specify more than one TOOL
  216.                by "SHIFT Left Mouse". The first TOOL will work with all
  217.                the PROJECTS  you had  specified and  the reminder TOOLS
  218.                will be skiped.
  219.  
  220.                Solution: Don't specify any files by "SHIFT Left Mouse".
  221.                          The program will ask you for each file  by the
  222.                          ARP-Filerequester.
  223.  
  224.           Please excuse my bad english, but my schooltime is long ago.
  225.