home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 1 / GoldFishApril1994_CD2.img / d4xx / d487 / assignx / assignx.docs < prev    next >
Text File  |  1991-05-10  |  4KB  |  100 lines
  1.  
  2. AssignX V1.2
  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 three more options to the "Retry/Cancel"
  25. requester:
  26.  
  27. "Deny" 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. "Mount" will have the same action as finding a CLI, typing "MOUNT DevName:"
  49. and then clicking Retry.  This is great for those cases where you want to
  50. use RAD: and you haven't mounted it yet (or NET: or whatever other devices
  51. you use but don't always mount).
  52.  
  53. INSTALLATION
  54.  
  55. AssignX ONLY RUNS UNDER 2.0 and will simply exit under 1.3.
  56.  
  57. Under 2.0, the best way to install AssignX is to drag it's icon into
  58. your WBStartup drawer and forget about it - that's all there is to it!
  59.  
  60. If you want to, you can call it as a CLI program - AssignX doesn't exit
  61. unless you manage to send it a Ctrl-C break signal, so you'll have
  62. to use RUN >NIL: <NIL: ASSIGNX if you want to put it in a script.
  63.  
  64.  
  65. THE SOURCE
  66.  
  67. AssignX's source is pretty simple, and is included for the suspicious
  68. or the curious to peer at.  It simply SetFunction()'s the EasyRequest()
  69. vector to point to my own routine, which examines the first argument
  70. that the es_FormatString is going to be fed through (es_FormatString
  71. is "%s%s%s" for the requester we're interested in), and if it matches
  72. "Please insert volume" then the requester will have the extra gadgets
  73. added to it.  The source won't be compilable without my library of
  74. routines that I use a lot, as I call two of my own routines -
  75. AslFileRequest() and EasyRequester(), which are just my ways of calling
  76. the ASL File Requester, or bringing up an EasyRequest(), without having
  77. to worry about intializing structures, etc.  These should be easy to replace
  78. if you wish to modify it.
  79.  
  80. The main program is in "AssignX.c" with a bit of ASM code in "asmbit.a".
  81.  
  82.  
  83. THE AUTHOR
  84.  
  85. I can be reached on People/Link (STEVEX), Bix (s.tibbett), or on my BBS
  86. at 613-731-3419.  If you're modemless and wish to talk to me, give me
  87. a call at 613-731-5316 in the evening.
  88.  
  89. AssignX is placed in the Public Domain.
  90.  
  91.  
  92.                     ...Steve
  93.  
  94.  
  95.  
  96. NOTE:  V1.2 is just V1.1 with a bug fixed - it no longer assumes the first
  97. argument on the stack is a pointer to a string, rather it checks the format
  98. string first to make sure.  Gets rid of some harmless enforcer hits.  Added a
  99. version string, also.
  100.