home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / APPS / dm.lzh / dm.doc < prev    next >
Text File  |  1995-12-30  |  13KB  |  331 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                          ╔════════════════════════════╗
  15.                          ║                            ║
  16.                          ║         DiskMaster         ║
  17.                          ║                            ║
  18.                          ║         Version 1.1        ║
  19.                          ║                            ║
  20.                          ║       by Bob Devries       ║
  21.                          ║                            ║
  22.                          ╚════════════════════════════╝
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.      DiskMaster v1.1                          Saturday, 30th December, 1995
  69.  
  70.                                    DiskMaster                              
  71.                                  by Bob Devries                            
  72.      
  73.              DiskMaster  is  a  file  manipulation  utility I wrote for the
  74.      SECAD  AS-68K computer.  Since the user  base  for  this  computer  is
  75.      vanishingly  small,  I  could  not  wait for someone else to  write  a
  76.      programme like  this.   Since I knew that I could not be without it, I
  77.      decided that I should write it myself.
  78.      
  79.              This  first version will ONLY work on the  SECAD  AS-68K,  and
  80.      probably  only  on  one  with a sixteen colour EGA screen.  I  haven't
  81.      tried  it on anything else.   Future  versions  may  use  the  TermCap
  82.      Library, and I hope that an MM/1 version will come out, too.
  83.      
  84.              DiskMaster  is  loosely based on two programmes: DMTREE on the
  85.      Tandy Colour  Computer  (OS-9  Level  II),  and  XTREE  on the IBM PC.
  86.      Since  the  SECAD  AS-68K does not have  a  windowing  interface,  all
  87.      prompts have to re-draw the screen every time  it  is  altered.   This
  88.      makes for a little slowness in some parts.
  89.      
  90.             As from version  1.1, DiskMaster is capable of using the system
  91.      mouse.  It tries to open  the  device  '/mouse', and if successful, it
  92.      uses  it  in  parallel  with the keyboard functions.  Move the cursor,
  93.      using the mouse,  to  the  desired  file, and press the left button to
  94.      select it.  Then move to the desired  operation,  and  press  the left
  95.      button again.   To  move down into a directory, or back to the parent,
  96.      place  the  cursor over the desired directory,  and  press  the  right
  97.      button.  To  move  to  the  next page of filenames, move the cursor to
  98.      the double line under the  last  filename, and press the right button.
  99.      To  move  to  the  previous page,  move the cursor to the double  line
  100.      above the first filename, and press the right button.
  101.      
  102.             SYSTEM REQUIREMENTS
  103.      
  104.             For the commands in DiskMaster  to work, the following commands
  105.      must be in your CMDS directory, or in your PATH.
  106.      
  107.                       AR2, LHA, UNZIP, ZOO, UUDECODE, GZIP,                
  108.                             COPY, DELDIR, MOVE, ATTR.                      
  109.      
  110.      HOW TO USE DISKMASTER
  111.      
  112.             Starting DiskMaster from the  command  line  is  very easy, but
  113.      enough flexibility is built into the programme  to  give  some measure
  114.      of control.  Just type:
  115.      
  116.             DM
  117.      
  118.      and  press  ENTER,  and  DiskMaster will start using your current data
  119.      directory as its starting directory.  Or type:
  120.      
  121.             DM -d /h0
  122.      
  123.      if you wish to start in the root  directory  of  your hard drive.  Any
  124.      legal RBF path descriptor will work.
  125.      
  126.             If you type:
  127.      
  128.             DM -c
  129.      
  130.      DiskMaster will not clear  the  screen  on  exit, leaving you with the
  131.      filenames on the screen.  Type:
  132.  
  133.  
  134.      DiskMaster v1.1                          Saturday, 30th December, 1995
  135.  
  136.      
  137.             DM -?
  138.      
  139.      and you get:
  140.      
  141.      Usage: DiskMaster [-c] [-d<dir name>]
  142.             -c don't clear screen on exit
  143.             dir name is initial directory
  144.      
  145.             Easy?
  146.      
  147.             Now, once DiskMaster is loaded, you  will  see  a  blue screen,
  148.      with white borders, with the left two-thirds  of the screen devoted to
  149.      filenames in your  chosen directory, and the right one-third with file
  150.      descriptor  information.   At the bottom  of  the  window  frame,  the
  151.      current directory name is displayed.  At the bottom of  the  screen is
  152.      a line of the commands that are available.   The  up  and  down  arrow
  153.      keys, or the  backspace and space keys are used to move up and down in
  154.      the file list.  The Home  or  <CTRL>-Z key will move to the top of the
  155.      current screen, and  the  End or <CTRL>-V key to the bottom.  The PgUp
  156.      or <CTRL>-Z  key  will  take  you to the top of the previous page, and
  157.      the PgDn  or <CTRL>-V key will take you to the top of the next page of
  158.      files.  Commands are then used for each chosen file.  They are:
  159.      
  160.      Attr Copy Rename Del Newdir Makdir Move Tag List Unarc Help Quit Shell
  161.      
  162.      
  163.             Here is an explanation of each.
  164.      
  165.             ATTR   - This  command  will  change   the  attributes  of  the
  166.                      selected  file.   The  file's   attributes  are  first
  167.                      displayed,  followed  by a prompt to change them.  Use
  168.                      the  normal  ATTR  format  when   supplying   the  new
  169.                      attributes.   This  command  will not allow changes to
  170.                      the  directory  attribute.   Pressing  Enter or ESC at
  171.                      the  prompt  will abort  this  command.   If  multiple
  172.                      files are tagged, you will be  asked  if  you  want to
  173.                      confirm each attribute  change.  If  you answer 'y' or
  174.                      'Y', you will be asked 'Change  attributes of filename
  175.                      to ...'.   Pressing  'y'  or  'Y'  will  complete  the
  176.                      attribute change, pressing 'n' or  'N' or <ENTER> will
  177.                      skip that file.
  178.      
  179.             COPY   - This command will copy the selected  file  to wherever
  180.                      you want it to go.   This  may  be  a new filename, or
  181.                      another  directory  or  device,  a new filename  in  a
  182.                      different directory or device.   DiskMaster  checks to
  183.                      see if  the  file already exists, and asks if you want
  184.                      to overwrite  if  it  does.   It  checks to see if the
  185.                      destination  is  a directory, and if so, uses the copy
  186.                      -w= format.  Pressing ENTER or ESC at the prompt  will
  187.                      abort the command.   If multiple files are tagged, you
  188.                      will  be asked if you want to confirm each  copy,  and
  189.                      then if you want to overwrite the file if  it  exists.
  190.                      If  you choose 'Y' or 'y' for  the  confirm  question,
  191.                      you  will be asked at each  file,  'Copy  filename  to
  192.                      path  (y/N)'.   Press 'y' or 'Y' to complete the copy,
  193.                      or 'n' or 'N' or <ENTER> to skip that file.
  194.      
  195.             RENAME - This command will change the  name  of  the  currently
  196.                      selected file.  DiskMaster  will  check  to see if the
  197.                      new  filename  already  exists,  and   aborts  with  a
  198.  
  199.  
  200.      DiskMaster v1.1                          Saturday, 30th December, 1995
  201.  
  202.                      message  if  it  does.   Pressing  ENTER or ESC at the
  203.                      prompt will abort the command.
  204.      
  205.             DEL    - This command will delete the currently  selected file.
  206.                      You will be asked  if  you are sure before proceeding.
  207.                      This command will delete a directory id that  is  what
  208.                      is selected.  DiskMaster will  tell  you whether it is
  209.                      a  file  or  directory you are deleting.  Pressing any
  210.                      other key except 'Y' or 'y'  will  abort this command.
  211.                      If multiple files  are  tagged,  you  will be asked if
  212.                      you  want  to  confirm each deletion.   Then  it  will
  213.                      print  'Delete  filename  (y/N)'.  Pressing 'y' or 'Y'
  214.                      will  complete the delete,  pressing  'n'  or  'N'  or
  215.                      <ENTER> will skip that file.
  216.      
  217.             NEWDIR - This  command  will  allow you to  change  to  another
  218.                      directory, or to another disk.   Pressing ENTER or ESC
  219.                      will abort this command.
  220.      
  221.             MAKDIR - This  command  will  create  a  new  directory.    The
  222.                      directory will be created wherever  you tell it in the
  223.                      pathname.   If  you  just supply a name,  it  will  be
  224.                      created   in   the   current   directory.   DiskMaster
  225.                      automatically  converts  the  filename  to  UPPERCASE.
  226.                      Pressing ENTER  or  ESC  at the prompt will abort this
  227.                      command.
  228.      
  229.             MOVE   - This  command  will  move  the currently selected file
  230.                      into   another   directory   ON   THE   SAME   DEVICE.
  231.                      DiskMaster will check if the file  exists,  and  abort
  232.                      with  a  message  if  so.  If multiple files have been
  233.                      tagged, you will be asked if you  want to confirm each
  234.                      move, then when each  file  is  processed,  DiskMaster
  235.                      will ask 'Move filename to path  (y/N)'.  Pressing 'y'
  236.                      or 'Y'  will complete the command, pressing 'n' or 'N'
  237.                      or  <ENTER>  will  skip  that  file.  The OS-9 command
  238.                      MOVE, written by Lukas Zeller is used.  This  file  is
  239.                      available  from  the  EFFO  (European  Forum For OS-9)
  240.                      group,    and   also   from   the    Internet    site:
  241.                      Chestnut.cs.wisc.edu.
  242.      
  243.             TAG    - This   command   highlights   and  un-highlights   the
  244.                      selected   file  for  further  processing   by   those
  245.                      commands  that support multiple files.  Pressing CTRL-
  246.                      T  will  tag or untag ALL files.   If  there  are  any
  247.                      files tagged, they will be untagged.
  248.      
  249.             LIST   - This command  will  display  the  contents of an ASCII
  250.                      file  inside  the  borders  of   the  main  DiskMaster
  251.                      screen.   Nineteen lines will be displayed at a  time,
  252.                      press any key  or  the  left  mouse button to continue
  253.                      the  display,  or 'Q' or 'q' or ESC or the right mouse
  254.                      button to stop, and go back to the main screen.
  255.      
  256.             UNARC  - This   command  will  un-archive  a  files  with   the
  257.                      extensions .ar, .lha, .lzh,  .gz, .uue, .zip and .zoo.
  258.                      You  will  be  asked  where you want to un-archive the
  259.                      files to.  Supply the name of a device  or  directory,
  260.                      or  press  ENTER  to  select  the  current  directory.
  261.                      Pressing ESC at the prompt will abort this command.
  262.      
  263.             HELP   - This  command  will  bring  up  a  multiple page  help
  264.  
  265.  
  266.      DiskMaster v1.1                          Saturday, 30th December, 1995
  267.  
  268.                      screen.  Press any key to page through the  help file,
  269.                      or press 'Q', 'q', or ESC to abort.
  270.      
  271.             QUIT   - This  quits  DiskMaster,  and  returns  you  to  OS-9,
  272.                      restoring you to the directory you started from.
  273.      
  274.             SHELL  - This  command  will  clear  the screen and provide you
  275.                      with  a  shell  command  line prompt, with the current
  276.                      directory  the  same  as the directory  shown  on  the
  277.                      DiskMaster screen,  and  the prompt set to 'DM'.  Type
  278.                      'logout' to return to DiskMaster.
  279.      
  280.      ______________________________________________________________________
  281.      
  282.             LEGALS
  283.      
  284.              DiskMaster  is  SHAREWARE.  Please  pass  it  around  to  your
  285.      friends.   If  you  think  that  DiskMaster is worth something send me
  286.      something.   A  box  of disks is always  useful  (720K  3.5"  is  MOST
  287.      useful).
  288.      
  289.             THANKS
  290.      
  291.             DiskMaster would  have  been  much  more  difficult  to  create
  292.      without  Bob van der Poel's wonderful Ved and Vprint  for  OS-9/68000,
  293.      and  Carl  Kreider's 'alib.l' C library file.  Thanks also goes to Rob
  294.      Unsworth, for his  many  bug  reports  and suggestions, and to all the
  295.      people on the InterNet COCO list, for their answers to my questions.
  296.      
  297.                   Bob Devries
  298.      
  299.                   InterNet: bdevries@gil.ipswichcity.qld.gov.au
  300.                   Phone   : +61 7 32787209
  301.                   Address : 21 Virgo Street
  302.                          INALA, Qld. 4077
  303.                          Australia
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.