home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / APPS / dm14.lzh / dm.doc < prev    next >
Text File  |  1996-08-30  |  14KB  |  331 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                          ╔════════════════════════════╗
  15.                          ║                            ║
  16.                          ║         DiskMaster         ║
  17.                          ║                            ║
  18.                          ║         Version 1.4        ║
  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.4                              Friday, 30th August, 1996
  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.             As from version 1.2, there is an  MM/1  version  of DiskMaster,
  103.      and mouse support was added in version 1.3.
  104.      
  105.             SYSTEM REQUIREMENTS
  106.      
  107.              For the commands in DiskMaster to work, the following commands
  108.      must be in your CMDS directory, or in your PATH.
  109.      
  110.                       AR2, LHA, UNZIP, ZOO, UUDECODE, GZIP,                
  111.                             COPY, DELDIR, MOVE, ATTR.                      
  112.      
  113.      HOW TO USE DISKMASTER
  114.      
  115.             Starting  DiskMaster  from  the  command line is very easy, but
  116.      enough flexibility is built into the programme  to  give  some measure
  117.      of control.  Just type:
  118.      
  119.             DM
  120.      
  121.      and press ENTER, and DiskMaster will start  using  your  current  data
  122.      directory as its starting directory.  Or type:
  123.      
  124.             DM -d /h0
  125.      
  126.      if you wish  to  start  in the root directory of your hard drive.  Any
  127.      legal RBF path descriptor will work.
  128.      
  129.             If you type:
  130.      
  131.             DM -c
  132.  
  133.  
  134.      DiskMaster v1.4                              Friday, 30th August, 1996
  135.  
  136.      
  137.      DiskMaster  will not clear the screen on exit, leaving  you  with  the
  138.      filenames on the screen.  Type:
  139.      
  140.             DM -?
  141.      
  142.      and you get:
  143.      
  144.      Usage: DiskMaster [-c] [-d<dir name>]
  145.             -c don't clear screen on exit
  146.             dir name is initial directory
  147.      
  148.             Easy?
  149.      
  150.              Now,  once  DiskMaster  is loaded, you will see a blue screen,
  151.      with white borders,  with the left two-thirds of the screen devoted to
  152.      filenames in your chosen directory, and the right one-third  with file
  153.      descriptor information.   At  the  bottom  of  the  window  frame, the
  154.      current directory  name  is displayed.  At the bottom of the screen is
  155.      a line  of  the  commands  that  are available.  The UP and DOWN ARROW
  156.      keys are used to  move  up  and  down  in  the file list.  The HOME or
  157.      <CTRL>-Z key will move to the top of the current screen,  and  the END
  158.      or <CTRL>-V key to the bottom.   The  PgUp  or  <CTRL>-Z key will take
  159.      you  to  the  top  of  the previous page, and the PgDn or <CTRL>-V key
  160.      will  take  you  to the top of the next page of files.  The  BACKSPACE
  161.      and  SPACE  keys will move  to  the  start  and  end  of  the  current
  162.      directory.  Commands are then used for each chosen file.  They are:
  163.      
  164.      Attr Copy Rename Del Newdir Makdir Move Tag List Unarc Help Quit Shell
  165.      
  166.      
  167.             Here is an explanation of each.
  168.      
  169.             ATTR   - This  command  will   change  the  attributes  of  the
  170.                      selected  file.    The  file's  attributes  are  first
  171.                      displayed,  followed  by a prompt to change them.  Use
  172.                      the  normal  ATTR   format   when  supplying  the  new
  173.                      attributes.  This command  will  not  allow changes to
  174.                      the directory  attribute.   Pressing  Enter  or ESC at
  175.                      the  prompt  will  abort  this command.   If  multiple
  176.                      files  are  tagged, you will be asked if you  want  to
  177.                      confirm each attribute change.  If  you  answer 'y' or
  178.                      'Y', you will  be asked 'Change attributes of filename
  179.                      to  ...'.   Pressing  'y'  or  'Y'  will complete  the
  180.                      attribute change, pressing  'n' or 'N' or <ENTER> will
  181.                      skip that file.
  182.      
  183.             COPY   - This command will  copy  the selected file to wherever
  184.                      you want it to go.   This  may  be  a new filename, or
  185.                      another  directory  or  device,  a  new  filename in a
  186.                      different directory  or  device.  DiskMaster checks to
  187.                      see  if  the file already exists, and asks if you want
  188.                      to  overwrite  if it does.  It checks to  see  if  the
  189.                      destination is a directory, and if so, uses  the  copy
  190.                      -w= format.   Pressing ENTER or ESC at the prompt will
  191.                      abort the command.  If multiple  files are tagged, you
  192.                      will be asked if you want to confirm  each  copy,  and
  193.                      then if you want to overwrite the  file  if it exists.
  194.                      If you choose 'Y'  or  'y'  for  the confirm question,
  195.                      you will be  asked  at  each  file,  'Copy filename to
  196.                      path  (y/N)'.   Press 'y' or 'Y' to complete the copy,
  197.                      or 'n' or 'N' or <ENTER> to skip that file.
  198.  
  199.  
  200.      DiskMaster v1.4                              Friday, 30th August, 1996
  201.  
  202.      
  203.             RENAME - This  command  will  change  the name of the currently
  204.                      selected file.  DiskMaster  will  check  to see if the
  205.                      new  filename  already   exists,  and  aborts  with  a
  206.                      message if it does.   Pressing  ENTER  or  ESC  at the
  207.                      prompt will abort the command.
  208.      
  209.             DEL    - This command will delete the currently selected  file.
  210.                      You will be asked if you  are  sure before proceeding.
  211.                      This  command  will delete a directory id that is what
  212.                      is selected.  DiskMaster will tell you  whether  it is
  213.                      a file or  directory  you  are deleting.  Pressing any
  214.                      other key except 'Y' or 'y' will abort  this  command.
  215.                      If multiple files are tagged,  you  will  be  asked if
  216.                      you  want  to  confirm  each  deletion.   Then it will
  217.                      print 'Delete  filename  (y/N)'.  Pressing  'y' or 'Y'
  218.                      will  complete  the delete, pressing  'n'  or  'N'  or
  219.                      <ENTER> will skip that file.
  220.      
  221.             NEWDIR - This  command  will  allow you to  change  to  another
  222.                      directory, or to another disk.  Pressing ENTER  or ESC
  223.                      will abort this command.
  224.      
  225.             MAKDIR - This   command  will  create  a  new  directory.   The
  226.                      directory will be created wherever you tell  it in the
  227.                      pathname.  If you  just  supply  a  name,  it  will be
  228.                      created   in   the   current   directory.   DiskMaster
  229.                      automatically  converts  the  filename  to  UPPERCASE.
  230.                      Pressing  ENTER  or  ESC at the prompt will abort this
  231.                      command.
  232.      
  233.             MOVE   - This  command  will  move the currently selected  file
  234.                      into   another   directory   ON   THE   SAME   DEVICE.
  235.                      DiskMaster  will  check  if the file exists, and abort
  236.                      with  a  message  if so.  If multiple files have  been
  237.                      tagged, you  will be asked if you want to confirm each
  238.                      move,  then  when  each  file is processed, DiskMaster
  239.                      will ask 'Move filename  to path (y/N)'.  Pressing 'y'
  240.                      or 'Y' will complete the command, pressing 'n'  or 'N'
  241.                      or <ENTER> will skip  that  file.   The  OS-9  command
  242.                      MOVE,  written  by Lukas Zeller is used.  This file is
  243.                      available from the  EFFO  (European  Forum  For  OS-9)
  244.                      group,   and   also   from    the    Internet    site:
  245.                      os9archive.rtsi.com.
  246.      
  247.             TAG    - This   command   highlights   and   un-highlights  the
  248.                      selected   file  for  further  processing   by   those
  249.                      commands that support multiple files.   Pressing CTRL-
  250.                      T  will  tag  or  untag  ALL  files.  If there are any
  251.                      files tagged, they will be untagged.
  252.      
  253.             LIST   - This command will display  the  contents  of  an ASCII
  254.                      file  inside  the  borders  of   the  main  DiskMaster
  255.                      screen.   Nineteen  lines will be displayed at a time,
  256.                      press  any  key  or  the left mouse button to continue
  257.                      the  display, or 'Q' or 'q' or ESC or the right  mouse
  258.                      button to stop, and go back to  the  main  screen.  If
  259.                      the   highlighted  file  is  an  archive  and  has  an
  260.                      extension  of  .lzh, .lha, .arc, .zoo, .ar,  .zip,  or
  261.                      .gz, this  command  will  list  the  contents  of  the
  262.                      archive.
  263.      
  264.  
  265.  
  266.      DiskMaster v1.4                              Friday, 30th August, 1996
  267.  
  268.             UNARC  - This  command   will   un-archive  a  files  with  the
  269.                      extensions .ar, .lha, .lzh, .gz,  .uue, .zip and .zoo.
  270.                      You  will be asked where you want  to  un-archive  the
  271.                      files to.  Supply  the  name of a device or directory,
  272.                      or  press  ENTER  to  select  the  current  directory.
  273.                      Pressing ESC at the prompt will abort this command.
  274.      
  275.             HELP   - This command  will  bring  up  a  multiple  page  help
  276.                      screen.  Press  any key to page through the help file,
  277.                      or press 'Q', 'q', or ESC to abort.
  278.      
  279.             QUIT   - This  quits  DiskMaster,  and  returns  you  to  OS-9,
  280.                      restoring you to the directory you started from.
  281.      
  282.             SHELL  - This command will  clear  the  screen  and provide you
  283.                      with  a shell command line prompt,  with  the  current
  284.                      directory the same  as  the  directory  shown  on  the
  285.                      DiskMaster screen, and the prompt set  to  'DM'.  Type
  286.                      'logout' to return to DiskMaster.
  287.      
  288.      ______________________________________________________________________
  289.      
  290.             LEGALS
  291.      
  292.             DiskMaster  is  SHAREWARE.   Please  pass  it  around  to  your
  293.      friends.  If you think that DiskMaster  is  worth  something  send  me
  294.      something.   A  box  of disks is always  useful  (720K  3.5"  is  MOST
  295.      useful).
  296.      
  297.             THANKS
  298.      
  299.              DiskMaster  would have been  much  more  difficult  to  create
  300.      without Bob van  der  Poel's  wonderful Ved and Vprint for OS-9/68000,
  301.      and Carl Kreider's  'alib.l'  C library file.  Thanks also goes to Rob
  302.      Unsworth, for his many bug reports  and  suggestions,  and  to all the
  303.      people on the InterNet COCO list, for their answers to my questions.
  304.      
  305.                   Bob Devries
  306.      
  307.                   InterNet: bdevries@gil.ipswichcity.qld.gov.au
  308.                   Phone   : +61 7 32787209
  309.                   Address : 21 Virgo Street
  310.                          INALA, Qld. 4077
  311.                          Australia
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.