home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / emulate / amyxfer.lzh / AMYXFER.DOC next >
Text File  |  1990-08-01  |  6KB  |  127 lines
  1. AMYXFER.EXE 1.1 - a PC-side transfer utility for the BridgeBoard
  2. ------------------------------------------------------------
  3. Written by Greg Browne 8/1/90
  4.  
  5. WHAT ------
  6.  
  7.   The PC-side of a pair of matched utilities for simplifying file transfer
  8.   to and from the bridgeboard.  Simply semi-automates the AREAD and AWRITE
  9.   stuff on the PC side.
  10.  
  11.   AMYXFER.EXE is a PC "sort-of" directory utility which grabs the file
  12.   RAM:PCDLIST.BBD from the AMIGA side and allows you to display directories
  13.   and mark and transfer files back and forth from any path on the PC to
  14.   the given path in the PCDLIST.BBD file.  This program works with the
  15.   DOS "SHELL" statement and errors are simply the DOS messages displayed
  16.   in a relatively harmless area of the screen.  It automatically redraws
  17.   the screen if it gets messed up.
  18.  
  19. EXPECTATIONS ------
  20.  
  21.   AMYXFER expects the programs AREAD and AWRITE to be available somewhere
  22.   in your PATH statement.  It does not use any configuration files.  It
  23.   also expects the program RAM:PCDLIST.BBD to be on the AMIGA side for it
  24.   to read at startup.  If this file is NOT found, the program will just
  25.   set the AMIGA path to RAM: and only be capable of AWRITEing to there
  26.   from the PC.
  27.  
  28.   NOTE that this program uses the /B option ONLY.  If you want all that
  29.   <CR><LF> conversion, use something else.
  30.  
  31. OPERATION --------
  32.  
  33.   To start, simply type the program name (you may change it if you like).
  34.  
  35.   The program may be started with one optional "tail" argument to tell it
  36.   to use MONOCHROME colors (default is COLOR).  If you are running the
  37.   mono PC screen, you MUST do this to see highlights.  Color is much
  38.   prettier.
  39.  
  40.   AMYXFER [MONO]
  41.  
  42.   There are 5 "windows" of interest.
  43.    1)  The upper left window always displays a file directory.  Whether it
  44.        is the DOS or AMY directory will be shown along the top border.
  45.    2)  The upper right window shows a summary of the commands.  They are
  46.        described more fully under "COMMANDS" below.
  47.    3)  The upper filepath window displays the current AMIGA output or
  48.        import path.
  49.    4)  The lower filepath window displays the current DOS output or
  50.        import path.
  51.    5)  The bottom-most window is the status/info/error/etc display area.
  52.  
  53.   TO TERMINATE THE PROGRAM, SIMPLY PRESS THE <ESC> KEY.
  54.  
  55. DIRECTORY WINDOW ----------
  56.  
  57.  +-[ TYPE OF DIR SHOWING ]-------------------------------------+
  58.  | <PARENT>                               <DIR> filedate ftime |
  59.  | <subdirnames in brackets>              <DIR> filedate ftime |
  60.  | <subdirnames in brackets>              <DIR> filedate ftime |
  61.  | filenames_alphabetically             f-sizes filedate ftime |
  62.  | filenames_alphabetically             1234567 12/31/89 05:45 |
  63.  | etc.                                 1234567 07/28/90 17:40 |
  64.  +-[ x items ]-------------------------------------------------+
  65.  
  66.   NOTES
  67.     Highlighted item is the one which will be acted on.
  68.     <UP and DOWN arrow> keys move highlight through files.
  69.     <PGUP/PGDN/HOME/END> are useful - experiment.
  70.     <ENTER> key on a subdir selects and reads that subdir.
  71.     <ENTER> key on a <PARENT> moves back a level in the tree.
  72.     <ENTER> key on a filename alternately selects/unselects it.
  73.             First & last column has a diamond in it if file is selected
  74.     <COMMANDS> are active also.
  75.  
  76. CAUTIONS --------
  77.  
  78.   The program will attempt to fit the filenames from the AMIGA into a
  79.   format usable for DOS.  i.e.  it will take the first 8 letters of the
  80.   main name and add the first 3 after any "." which may cause duplicate
  81.   names if you aren't careful about your naming conventions.
  82.  
  83. COMMANDS --------
  84.  
  85.   S) Switch DIRS  - Switch the display to the other path. i.e. IF DOS is
  86.                     displayed, get the AMIGA display, and vice versa.
  87.  
  88.   1) Show AMY DIR - Display the current AMIGA path directory content in
  89.                     the directory window.
  90.  
  91.   2) Show DOS DIR - Display the current DOS path directory content in
  92.                     the directory window.
  93.  
  94.   3) Read AMY LIST- Read the RAM:PCDLIST.BBD over from the AMIGA side and
  95.                     set the paths and directory content.  This is to allow
  96.                     you to flip over to the AMIGA side and re-do the PCDir
  97.                     listing, then flip back and activate it without leaving
  98.                     the AMYXFER program.
  99.  
  100.   4) Read DOS DRV - Get the next key from the keyboard (A-P) and attempt
  101.                     to read the related DOS drive (at root level).  If the
  102.                     drive is not available, nothing will be done.
  103.  
  104.   5) Mark ALL     - Mark all files as "selected".
  105.  
  106.   6) Unmark ALL   - UN-mark all files so none are "selected".
  107.  
  108.   7) Copy         - Copy the currently marked files from the display.
  109.  
  110.                        IF an AMY dir is displayed, the marked files will
  111.                        be AREAD from the AMIGA to the currently displayed
  112.                        DOS path.
  113.  
  114.                        IF a DOS dir is displayed, the marked files will
  115.                        be AWRITE'ed to the current AMIGA path from DOS.
  116.  
  117.   <CR> Mark/Unmark/
  118.         (or ChDIR)- Toggle selection of files, or move into directories
  119.                     depending on what is highlighted.
  120.  
  121.   <ESC> Quit      - Obvious.
  122.  
  123. ------- MODIFICATIONS --------
  124. v1.0 8/1/90  Original
  125. v1.1 8/1/90  OOPS! Window didn't hold position on errors and RAM: printed
  126.              in wrong place when PCDLIST.BBD was not found.
  127.