home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / newc_dev / mmdir13.lha / MmDir.doc < prev   
Text File  |  1993-05-17  |  4KB  |  126 lines
  1.  
  2. NAME
  3.   MmDir - Make multiple directories.  WB2.0 and above only.
  4.  
  5.  
  6. SYSNOPSIS
  7.   MmDir NAME/M, I=ICON/S
  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.   It will also let 
  15. you create icons for all of the directories that you create.
  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.
  23.  
  24.   I=ICON/S     This  is  a  switch  for the  addition of  icons to the
  25. directories  made.   With  this switch  on, the  default icon  for the 
  26. drawer shall be added to each directory made.
  27.  
  28. Like most commands, entering MmDir ? will give the template.
  29.  
  30. EXAMPLES
  31.   Here are several examples of using MmDir...
  32.  
  33.     MmDir ram:OneDir
  34.  
  35.   This will make  the  single  directory  in  ram:  (assuming  it ram: 
  36. exists, and there is enough memory  free)   and works exactly the same 
  37. as the MakeDir command.
  38.  
  39.  
  40.     MmDir ram:OneDir/TwoDir/ThreeDir Info
  41.  
  42.   This will make  the  directory  structure  as  given  (with the same 
  43. assumptions as before) and this  is  the  main advantage of MmDir over 
  44. MakeDir.   Also, the  program will  create icons for all  three of the
  45. directories.
  46.  
  47.     MmDir ram:Prefs/Env-archive/Sys df0:Prefs/Env-Archive/Sys
  48.           ram:T ram:CLIPS
  49.  
  50.   This will make all  of  the  directories  given (same assumptions as 
  51. before) and is an example of multiple arguments.
  52.  
  53.  
  54.     MmDir ram:f:e ram:e/f ram:e/f I
  55.  
  56.   The first argument ram:f:e will give  an  error, as it is an invalid 
  57. name. The second argument will  create  the  directory ram:e/f and the 
  58. third will give the error Directory already exists:  ram:e/f since the 
  59. previous argument has just  created it. Icons will be  created for the
  60. directories e and f.
  61.  
  62. FILES
  63.   MmDir     - the program
  64.   MmDir.doc - this documentation file
  65.  
  66.  
  67. NOTES
  68.   This command has a WB2.04 version string which can be viewed using
  69.     version MmDir FULL
  70.  
  71.  
  72. BUGS
  73.   If a large directory structure is being created, it is possible that 
  74. the disk will run out of space  part way through creating it.  In this 
  75. case, the program  will  give  an  error,  but  will  leave the partly 
  76. created directory in place.  This may  or  may  not be desirable - One 
  77. person's bug is another one's feature!
  78.  
  79.  
  80. AUTHORS
  81.   V1.0 written jointly between James McDonald and Mark McPherson
  82.     Original code.  2nd July 1992
  83.   V1.1 Written from scratch by Mark McPherson
  84.     Code structure changed  to use  include  files and program was
  85.     made to be more like other WB2 commands.  3rd July 1992
  86.   V1.2 Updated from V1.1 by Mark McPherson
  87.     Now uses the stack for most operations.  This reduces the code
  88.     size considerably.  4th July 1992
  89.   V1.3 Updated from V1.2 by James McDonald
  90.       Added a few code optimisations, and also added the Icon
  91.       option for creation of icons with directories.  14th June 1993
  92.  
  93.  
  94.   All versions were written in assembly lanuage using Devpac V3.02.
  95.  
  96.  
  97. SEE ALSO
  98.   MakeDir
  99.  
  100.  
  101.  
  102. DISTRIBUTION
  103.   All code is copyright 1992 Mark McPherson and James McDonald.  It is 
  104. freely distributable and can be copied freely.  It may not be modified 
  105. and I ask that this  documentation  file accompanies the main program. 
  106. It must not  be  sold  or  included  on  any  disk  that  will be sold 
  107. commercially, without my permission  (Mark  McPherson).  Commodore has 
  108. this permission already.  Please send any comments, bug reports, ideas 
  109. for enhancements etc to me at:
  110.  
  111.     Mark McPherson
  112.     54 Wrestwood Road
  113.     Bexhill-On-Sea
  114.     East Sussex
  115.     England
  116.     TN40 2LL
  117.  
  118. or Internet:   msm@ukc.ac.uk
  119.  
  120. Note that I don't want to write a  WB1.3 version, but I will if enough 
  121. people ask. (ie more than 1!)
  122.  
  123.  
  124.  
  125. Written and (C) 14th June 1993 by Mark McPherson and James McDonald.
  126.