home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / newc_dev / mmdir.lha / MmDir.doc < prev   
Text File  |  1992-10-27  |  4KB  |  114 lines
  1.  
  2. NAME
  3.   MmDir - Make multiple directories.  WB2.02 and above only.
  4.  
  5.  
  6. SYNOPSIS
  7.   MmDir NAME/M
  8.  
  9.  
  10. DESCRIPTION
  11.   MmDir takes one or more  directory  and  path names, and attempts to
  12. create a directory structure for this  path.   It will make all of the
  13. directories necessary to give the specified  path and directory. Ie it
  14. will make a whole directory structure in one go.
  15.  
  16.  
  17. OPTIONS
  18.   NAME/M     This  is  a  list  of  directories/paths.   Each  one  is
  19. considered separately and will be  taken  as  if  the command had been
  20. used multiple times.  This is an  example of WB2.0's multiple argument
  21. parsing.  At least  one  argument  must  be  specified  else  an error
  22. message is displayed.  Like  most  commands,   entering "MmDir ?" will
  23. give this template.
  24.  
  25.  
  26. EXAMPLES
  27.   Here are several examples of using MmDir...
  28.  
  29.         MmDir ram:OneDir
  30.  
  31.   This will make  the   single   directory   in   ram:  (assuming that
  32. ram: exists, and there is enough memory  free)   and works exactly the
  33. same as the MakeDir command.
  34.  
  35.  
  36.         MmDir ram:OneDir/TwoDir/ThreeDir
  37.  
  38.   This will make  the  directory  structure  as  given  (with the same
  39. assumptions as before.) This  is   the   main  advantage of MmDir over
  40. MakeDir.
  41.  
  42.  
  43.         MmDir ram:Prefs/Env-archive/Sys df0:Prefs/Env-Archive/Sys
  44.               ram:T ram:CLIPS
  45.  
  46.   This will make all  of  the  directories  given (same assumptions as
  47. before) and is an example of multiple arguments.
  48.  
  49.  
  50.         MmDir ram:f:e ram:e/f ram:e/f
  51.  
  52.   The first argument "ram:f:e"  will  give   an   error,  as  it is an
  53. invalid  name.  The  second  argument  will   create   the   directory
  54. "ram:e/f" and the third will give the error "Directory already exists:
  55. ram:e/f" since the previous argument has just created it.
  56.  
  57.  
  58. FILES
  59.   MmDir     - the program
  60.   MmDir.doc - this documentation file
  61.  
  62.  
  63. NOTES
  64.   This command has a WB2.0 version string which can be viewed using
  65.  
  66.         version MmDir FULL
  67.  
  68.  
  69. BUGS
  70.   If a large directory structure is being created, it is possible that
  71. the disk will run out of space  part way through creating it.  In this
  72. case, the program  will  give  an  error,  but  will  leave the partly
  73. created directory in place.  This may  or  may  not be desirable - One
  74. person's bug is another one's feature!
  75.  
  76.  
  77. AUTHORS
  78.   V1.0 written jointly between James McDonald and Mark McPherson
  79.         Original code.  2nd July 1992
  80.   V1.1 Written from scratch by Mark McPherson
  81.         Code structure changed  to use  include  files and program was
  82.         made to be more like other WB2 commands.  3rd July 1992
  83.   V1.2 Updated from V1.1 by Mark McPherson
  84.         Now uses the stack for most operations.  This reduces the code
  85.         size considerably.  4th July 1992
  86.  
  87.   All versions were written in assembly lanuage using Devpac V3.02.
  88.  
  89.  
  90. SEE ALSO
  91.   MakeDir
  92.  
  93.  
  94.  
  95. DISTRIBUTION
  96.   All code is copyright (C) 1992 Mark McPherson and James McDonald. It
  97. is freely distributable and  can  be  copied  freely.   It  may not be
  98. modified, sold or included in  any  commercial distribution without my
  99. written  permission.   I  also  ask  that  this   documentation   file
  100. accompanies the main program.  The  authors take no responsibility for
  101. any loss or damage that may arise from using this program.
  102.  
  103. I can be contacted on the Internet at:      msm@ukc.ac.uk
  104. where I will be glad to help with this program and any other matter to
  105. do with the Amiga (If I can of course!)
  106.  
  107. Note that I don't want to write  a  WB1.3 version since I believe that
  108. WB2.0 is the way  forward  (and  writing  for  WB1.3  is somewhat more
  109. difficult!).  If you haven't already upgraded - DO SO!
  110.  
  111.  
  112.  
  113. Written and (C) 4th July 1992 by Mark McPherson.
  114.