home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / newc_dev / assignx.lha / AssignX.Docs < prev    next >
Text File  |  1991-04-17  |  3KB  |  90 lines
  1.  
  2. AssignX V1.0
  3. by Steve Tibbett
  4.  
  5.  
  6. INTRODUCTION
  7.  
  8. This is a simple program suggested to me by Doug Walker a while ago.  
  9.  
  10. How many times have you seen a "Please insert volume <volume name>
  11. in any drive" requester, and just had to find a CLI and type 
  12. "Assign <Volume Name> Drive:Path" just to retry the requester and
  13. get on with this?
  14.  
  15. How many times have you typed "List DF9:" instead of "DF0:" only
  16. to had your machine ask you to insert volume DF9: a few times,
  17. before finally giving up?
  18.  
  19. Well no more.  8-)
  20.  
  21. REFERENCE
  22.  
  23. Whenever the system puts up a "Please insert volume" requester,
  24. AssignX will hop in and add two more options to the "Retry/Cancel"
  25. requester:
  26.  
  27. "Cancel Forever" will tell AssignX to not pop up this requester again
  28. for this entire session.  If you say LIST FRED: and FRED: does not
  29. exist, the requester will pop up.  If you select Cancel Forever and
  30. then say LIST FRED: again, it will be as if the requester had come up
  31. and you had hit CANCEL - the operation will be aborted.
  32.  
  33. "Assign" is what this program is all about.  In the LIST FRED: example,
  34. selecting ASSIGN will bring up the ASL File Requester and ask you to
  35. pick a file/directory to assign FRED: to.  
  36.  
  37. Note that in most cases you will only want to pick a directory with the
  38. file requester, not an actual file.  If you wanted to assign FRED: to
  39. RAM:FRED then you would pick RAM:FRED from the file requester, leave the
  40. Filename gadget empty, and click Okay.  
  41.  
  42. It's perfectly legal to assign something to a file instead of to a 
  43. directory - in the LIST FRED: case, if you were to aim the file requester
  44. at "S:Startup-Sequence" then LIST would show S:Startup-Sequence's
  45. information as if you had typed "List S:Startup-Sequence".  This can
  46. be useful at times, but is not often used.
  47.  
  48.  
  49. INSTALLATION
  50.  
  51. AssignX ONLY RUNS UNDER 2.0 and will simply exit under 1.3.  
  52.  
  53. Under 2.0, the best way to install AssignX is to drag it's icon into
  54. your WBStartup drawer and forget about it - that's all there is to it!
  55.  
  56. If you want to, you can call it as a CLI program - AssignX doesn't exit
  57. unless you manage to send it a Ctrl-C break signal, so you'll have
  58. to use RUN >NIL: <NIL: ASSIGNX if you want to put it in a script.
  59.  
  60.  
  61. THE SOURCE
  62.  
  63. AssignX's source is pretty simple, and is included for the suspicious
  64. or the curious to peer at.  It simply SetFunction()'s the EasyRequest()
  65. vector to point to my own routine, which examines the first argument
  66. that the es_FormatString is going to be fed through (es_FormatString
  67. is "%s%s%s" for the requester we're interested in), and if it matches
  68. "Please insert volume" then the requester will have the extra gadgets
  69. added to it.  The source won't be compilable without my library of
  70. routines that I use a lot, as I call two of my own routines -
  71. AslFileRequest() and EasyRequester(), which are just my ways of calling
  72. the ASL File Requester, or bringing up an EasyRequest(), without having
  73. to worry about intializing structures, etc.
  74.  
  75. The main program is in "AssignX.c" with a bit of ASM code in "asmbit.a".
  76.  
  77.  
  78. THE AUTHOR
  79.  
  80. I can be reached on People/Link (STEVEX), Bix (s.tibbett), or on my BBS
  81. at 613-731-3419.  If you're modemless and wish to talk to me, give me
  82. a call at 613-731-5316 in the evening.
  83.  
  84. AssignX is placed in the Public Domain.
  85.  
  86.  
  87.                     ...Steve
  88.  
  89.  
  90.