home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / diskutil / raminit / raminit.doc next >
Encoding:
Text File  |  1993-05-18  |  6.3 KB  |  139 lines
  1.  
  2.             OH YEAH!  RAMINIT  - RAMDISK INITIALISER v1.0
  3.             ---------------------------------------------
  4.  
  5.  
  6.         Introduction ("What Is It?")
  7.         ----------------------------
  8.  
  9.     RAMINIT is a short program that provides some of the file handling commands
  10. that a command shell might have.  It reads commands from a script file when  it
  11. is run. I wrote it to copy programs into a ramdisk on bootup, although it could
  12. be used for all sort of things.
  13.  
  14.  
  15.         Details ("How Do I Use It?")
  16.         ----------------------------
  17.  
  18.     When run,  RAMINIT looks for the  file  \auto\raminit.dat  on  the  current
  19. drive.  If you have a command shell,  you can run it as "RAMINIT <file>" for  a
  20. different script file, otherwise just put raminit.prg, and your own raminit.dat
  21. file into your auto folder.
  22.     RAMINIT then reads commands from this file, one per line. It recognises:
  23.             /<text>                 comment
  24.             quiet                   no more output except for errors
  25.             mkdir <dirname>         create directory
  26.             copy <files> <files>    copy file(s)
  27.             delete <files>            delete file(s)
  28.             lock <files>            sets read only bit for file(s)
  29.             hide <files>             "    hidden    "   "    "
  30.             system <files>           "    system    "   "    "
  31.             unlock <files>          \
  32.             unhide <files>           } (obvious!)
  33.             unsystem <files>        /
  34.  
  35. Unless 'quiet' is specified, RAMINIT tells you what it's doing, like:
  36.  
  37.         Creating directory M:\FILES
  38.         Copying A:\PROGRAM.PRG to M:\FILES\PROGRAM.PRG
  39.  
  40. and so on.  RAMINIT recognises all the common errors,   so  if  you've  made  a
  41. mistake in the script file,  or called a file by the wrong name,  it'll let you
  42. know (without crashing :).
  43.     All the commands work with wildcards as well as files: copy and delete work
  44. with directories as well, so
  45.  
  46.         delete dir
  47.  
  48. will delete all files in the directory 'dir', including subdirectories,  before
  49. deleting the directory itself.
  50.     The copy command is the bit I'm proud of :] It recognises all the  possible
  51. combinations for the filenames, so you can:
  52.  
  53.         copy directory newdirectory
  54.  
  55. which will create a new directory and copy all the files in the dirst directory
  56. into it, or
  57.  
  58.         copy wild* directory
  59.  
  60. and so on.  Just try it and see if it works!  There is one peculiarity here: if
  61. the destination file already exists, RAMINIT _won't_ give an error, and _won't_
  62. copy the file.  Remember,  it's supposed to be used to copy files to a ramdisk:
  63. if you have a reset-resident one, you don't want it re-copying files every time
  64. you do a warm boot.  If you want to be sure that a file is copied,   delete  it
  65. first.
  66.     The other  commands  set  or  unset  various  file  attributes.   The  lock
  67. (read-only) bit may be useful:  I can't think of a use for the others but  I've
  68. included them a) for completeness, and b) coz they're easy to do!
  69.  
  70.     RAMINIT is not terribly complex,  but it's quick and easy to use.  I use it
  71. all  the  time,   and  haven't  had  any  problems.   It   should   work   with
  72. ST/STE/TT/Falcon,  all TOS versions,  and all resolutions (it even looks ok  in
  73. low rez!) but it's been tested only on my STE.  If you have problems,   let  me
  74. know.
  75.  
  76.  
  77.         Availability ("The Begging Bit")
  78.         --------------------------------
  79.  
  80.     If you like this program, and use it a lot,  please send me some dosh!  Ok,
  81. so it's not incredibly complex,  but it's taken me a lot of time to  get  right
  82. (especially the logic for the copy command), and just think: if it saves you 10
  83. seconds every time you boot up,  how much time has it saved you in a year??   I
  84. leave it to your conscience how much.  I'm only a poor student at  the  moment,
  85. and so what's a small amount to you could mean a lot to me  :].   Even  if  you
  86. can't spare any cash,  please let me know if you use this program.  I'm open to
  87. suggestions -  if there's a new command you want to see,  if you have  problems
  88. with it, or have any other comments, please let me know and I'll see what I can
  89. do. Even just a postcard would be nice! Please!!!
  90.  
  91.     If you send me some money, I will probably let you have some other programs
  92. as well, and also any later version of this one (sending a disk would help).  I
  93. can also let you have the source code (written in Ian Lepore's Heat-And-Serve C
  94. v1.40 - thanx very much Ian! - but should work with any C compiler).
  95.     You can contact me:
  96.  
  97.     by Email (up to end of June 1993):      A.R.Giddings @ uk.ac.durham
  98.  
  99.     or by snail mail:                       Andrew Giddings
  100.                                             71 Tyrone Road
  101.                                             Thorpe Bay
  102.                                             Essex SS1 3HD
  103.                                             England
  104.  
  105.     Please give this program to your friends, BBS etc. - someone somewhere must
  106. be able to find a use for it!!  Just don't change it or  charge  for  it,   and
  107. please include this text file.
  108.     Watch out for other Oh Yeah!  utilities -  the Oh  Yeah!   DVORAK  KEYBOARD
  109. accessory is already available, coming soon is the Oh Yeah! TEXT FILE VIEWER.
  110.  
  111.  
  112.         Disclaimer ("It's Not My Fault")
  113.         --------------------------------
  114.  
  115.     I've had no problems at all with RAMINIT,   but  I'm  afraid  that  in  the
  116. (unlikely) event that you do, I am not responsible.  For example, if you happen
  117. to spontaneously combust whilst using RAMINIT, don't come complaining to me :]
  118.  
  119.  
  120.        Ooo    Hh   h       Y      Yy  Eeeeee      A      Hh    h         !
  121.       O   o   Hh   h        Y    Yy   Ee         Aaa     Hh    h        !!!
  122.      Oo   oo  Hh   h         Y  Yy    Ee        Aa  a    Hh    h        !!!
  123.      Oo   oo  Hh   h          YYy     Ee       Aa    a   Hh    h        !!!
  124.      Oo   oo  Hhhhhh          Yy      Eeeee   Aaaaaaaaa  Hhhhhhh         !
  125.      Oo   oo  Hh   h         Yy       Ee      Aa      a  Hh    h         !
  126.      Oo   oo  Hh   h        Yy        Ee      Aa      a  Hh    h         !
  127.       O   o   Hh   h       Yy         Ee      Aa      a  Hh    h
  128.        Ooo    Hh   h      Yy          Eeeeee  Aa      a  Hh    h         !
  129.  
  130.  
  131.          #include <quote>
  132.  
  133.          "It's not what you've got, it's how fast it's ready for action!"
  134.  
  135.  
  136. (c) Andrew Giddings MXMIII
  137.  
  138. 18/5/93
  139.