home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Misc / AUASSIGN.LHA / AutoAssign / AutoAssign.doc < prev    next >
Encoding:
Text File  |  1995-10-23  |  12.5 KB  |  381 lines
  1.  
  2.              --------------------------------------------------
  3.  
  4.                            »»» AutoAssign v1.12 «««
  5.              "Let's get rid of those damned assigns & mounts...!"
  6.                                 
  7.  
  8.                        Beetware © 1995 The Beet Research
  9.  
  10.                         written by Grzegorz Calkowski
  11.  
  12.       -----------------------------------------------------------------
  13.  
  14.  
  15. Disclaimer
  16. ----------
  17.  
  18.     The program executable and information above is provided "as is".  No
  19. representations or warranties are made with respect to the accuracy,
  20. reliability, performance, currentness, or operation of this software and
  21. information, and all use is at your own risk.  The author doesn't assume any
  22. responsibility or liability whatsoever with respect to your use of the program
  23. and information.
  24.  
  25.  
  26. Copying
  27. -------
  28.  
  29.     AutoAssign is published under "BeetWare" conception.  It's very special
  30. sort of GiftWare.  It means you should send a beet to the author (but not a
  31. rotten one!  8).  Well, if you run short on beets send a disk or a small
  32. donation or anything else.  (Have a hint:  a bottle of beer would be
  33. excellent...  :)
  34.  
  35. This program can be freely distributed under following conditions:
  36.  
  37.         1. Everything in this distribution must be kept together and
  38.            unaltered. Applies to:
  39.  
  40.            AutoAssign                     (the program itself)
  41.            AutoAssign.info
  42.            AutoAssign.020                 (68020+ version)
  43.            AutoAssign.020.info
  44.            AutoAssign.doc                 (plain-ascii doc)
  45.            AutoAssign.doc.info
  46.            AutoAssign.guide               (AmigeGuide®'ed doc)
  47.            AutoAssign.guide.info
  48.            MWB-Icons/AutoAssign.info      (program's icon in MagicWB style :)
  49.            MWB-Icons.info
  50.  
  51.         2. Copyright notices are not removed from executables and
  52.            documentation.
  53.  
  54.         3. No more than a nominal fee is charged to cover cost of magnetic
  55.            media.
  56.  
  57. AutoAssign is Copyright (C) 1995 The Beet Research. All rights reserved.
  58.  
  59.  
  60. Introduction
  61. ------------
  62.  
  63.     Haven't you got tired of those applications which add more and more assigns
  64. to your user-startup?  Haven't you got irritated of those hundreds assigns
  65. showing in the requesters?  I bet you have.  Well, no more...
  66.  
  67.     AutoAssign is a small resident program which automatically makes an assign
  68. when it is requested.  It works somehow like DEFER assign but the assign won't
  69. show until it is referenced.  It's the feature that such programs like AssignX,
  70. AssignWedge or ReqChange's AssignWedge lack of.  Note, that AutoAssign isn't
  71. replacement for them - they are complementary. See The AssignWedge section.
  72.  
  73.     From version 1.10 AutoAssign can also perform "auto" mounts.  Effect is
  74. similar to so-called late mount (Mountlist's Mount keyword or DosDriver's
  75. ACTIVATE tooltype set to 0) but it has an important advantage - mount can be
  76. done also when a device is accessed by the volume name!  And I think it is far
  77. more convinient to manage late mounts in one file (assignsfile, I mean)
  78. than in several mountlists, dosdrivers and startup-sequences.  Even more!  You
  79. can put all your devices to the assignsfile and forget about 'Mount' command!!!
  80. Nice, isn't ?
  81.  
  82.     Although AutoAssign is small it occupies about 8 kilobytes of memory, but
  83. the goal was not to save a few bytes but to get rid of those rarely used
  84. assigns.  Note, that memory usage doesn't depend on length of assignsfile
  85. - it's accessed every time, when unexisting assign is referenced.  It also
  86. allows you to edit the assignsfile without quitting and re-running AutoAssign
  87. (or even worse - rebooting).
  88.  
  89.     AutoAssign propely recognizes "Please insert volume..." requesters even in
  90. localized enviroment.  Note, if you change language while AutoAssign is running
  91. you have to quit & rerun it.
  92.  
  93.     AutoAssign is 100% legal and was thoroughly tested with Enforcer &
  94. Mungwall.
  95.  
  96.  
  97. Requirements
  98. ------------
  99.  
  100.     AutoAssigns requiers an Amiga (surprise?) with at least Kickstart 2.04
  101. (NOTE:  tested only on 3.0/3.1!, sorry :).  It makes not much sense to use
  102. AutoAssign without harddisk.  Memory requirements are negligible.
  103.  
  104.     AutoAssigns requires reqtools.library V38+ installed in your LIBS:  to show
  105. 'About' requester, but it won't panic if it's not installed (is there anybody
  106. without, really?  :-).
  107.  
  108.     The automount feature requires the 'Mount' command installed on your
  109. command path (it's part of Workbench and should sit in C:).
  110.  
  111.  
  112. Installation
  113. ------------
  114.  
  115.     To have AutoAssign installed every boot you should drag it to WBStartup
  116. drawer.  Of course you can put it anywhere else on your harddisk.  It such case
  117. you are responsible to run it (for example form your startup-sequence or
  118. user-startup scripts).  Note, that there is an alternative icon supplied in
  119. MagicWB style :-).
  120.  
  121.     Note, that there is 68020+ version supplied.  If you have 68020, 68030,
  122. 68040, or maybe 68060 based Amiga you should use it instead.
  123.  
  124.     Also, you have to make assignsfile which consists all the
  125. assigns.  By default it is "S:AutoAssigns".
  126.  
  127.  
  128. Usage from Shell
  129. ----------------
  130.  
  131.     Although  I strongly recommend you to use AutoAssign from Workbench you can
  132. use   it   from  Shell  as  well  (for  example,  you  can  put  it  into  your
  133. startup-sequence  or  user-startup).   AutoAssign DOES NOT detach automatically
  134. from Shell so you should use 'run' command:
  135.  
  136.         run >NIL: AutoAssign
  137.  
  138.     As every other standard shell command AutoAssign recognizes the '?' what
  139. brings the options template.
  140.  
  141.     Options are:
  142.  
  143.         ASSIGNSFILE <path>      Specifies the path for assignsfile.
  144.                                 It's optional.
  145.                                 Default: S:AutoAssigns                  
  146.  
  147.                                 Note, that ASSIGNSFILE keyword can be omitted.
  148.  
  149.                                 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  150.                                 IMPORTANT: the path must be absolute, not
  151.                                 relative (i.e. S:MyAssigns not S/MyAssigns).
  152.                                 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  153.  
  154.  
  155.         QUIET                   Switch - if specified the about requester
  156.                                 won't be shown.
  157.  
  158.  
  159.  
  160. Usage from Workbench
  161. --------------------
  162.  
  163.     When lauched from WB AutoAssign looks for following tooltypes:
  164.  
  165.         
  166.         ASSIGNSFILE=<path>      Specifies the path for assignsfile.
  167.                                 It's optional.
  168.                                 Default: S:AutoAssigns
  169.  
  170.                                 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  171.                                 IMPORTANT: the path must be absolute, not
  172.                                 relative (i.e. S:MyAssigns not S/MyAssigns).
  173.                                 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  174.  
  175.         QUIET                   If specified the about requester won't be
  176.                                 shown.
  177.  
  178.  
  179. The assignsfile
  180. ---------------
  181.  
  182.     The assigns must be in pure ASCII format. Take a look at following
  183. example:
  184.  
  185. ; AutoAssigns & AutoMounts
  186.  
  187. DPaint:         Work:GFX/DPaint
  188. SC:             Work:SAS-C
  189. LIB:            SC:LIB SC:LIB2/ Development:store/LIB
  190. Toaster:        Work:Raytracing/LightWave
  191. 3d:             Data:3d                     ; for LightWave
  192.  
  193. "My Game:"      "Work:Games/My Beloved Game"
  194.  
  195. FF0:            mount FF0:
  196. Xmodules:       mount XH1: from DEVS:Mountlist.xpk
  197.  
  198.     Any string begining with a semi-colon (;) is considered to be a comment and
  199. is ignored.  Also blank lines or any leading or trailing blanks are ignored.
  200.  
  201.     Each line describes an assign or a device to mount.  The second case is
  202. recognized by 'mount' keyword.
  203.  
  204.     The first argument is a normal assign name.  The following are the paths
  205. where assignment should be made.  For example the first assign would be the
  206. same as:
  207.  
  208.         Assign DPaint: Work:GFX/DPaint
  209.  
  210. and third is the same as:
  211.  
  212.         Assign LIB: SC:LIB SC:LIB2 Development:store/LIB
  213.  
  214.     Note, that you can specify assigns refering to another (unexisting)
  215. assigns. For example:
  216.  
  217. AAA:    BBB:
  218. BBB:    Work:
  219.  
  220. is correct. 
  221.  
  222.     When 'mount' keyword is given it indicates that a mount should be
  223. performed.  The first argument is a device or a volume name.  The second is the
  224. 'mount' keyword followed by arguments for 'Mount' command.  The arguments are
  225. directly passed to the 'Mount' command - you can use multiple devices to mount.
  226. Also you can use FORM option to specify optional mountlist.
  227.  
  228.     Important - when you specify automount by a volume name the corresponding
  229. device's mountentry MUST have its 'Mount' keyword set to 1 (i.e "immediate"
  230. mount). Why? Look at following example:
  231.  
  232. XH2:            mount XH2:
  233. XFH_Works:      mount XH2:
  234.  
  235.     When XFH_Works:  is first refered to 'mount XH2:' will be executed.  XH2:
  236. will be mounted but if it's "late" mount volume XFH_Works:  won't appear!  So
  237. you will get what you wouldn't want to...  ('Please insert...').
  238.  
  239.     Note, if either a path, an assign name or device name consists any blanks
  240. it must be enclosed in double-quotes (it's general rule in AmigaDos).
  241.  
  242.     Summarizing - the template for
  243.  
  244.         - assigns is    NAME/A,TARGET/M/A
  245.  
  246.         - mounts is     NAME/A,MOUNT/S/A,DEVICE/M,FROM/K
  247.  
  248.     VERY IMPORTANT:  AutoAssign doesn't make *ANY* checks wether the
  249. assignsfile is correct!  Any errors, like missing colon, missing quote,
  250. unexisting path won't be reported!  Therefore you should edit the assignfile
  251. carefully.
  252.  
  253.  
  254. The AssignWedge
  255. ---------------
  256.  
  257.     As I have written above AutoAssign perfectly complements with such "Assign"
  258. commodities like AssignX, AssignWedge or ReqChange's AssignWedge.  But to make
  259. it work AutoAssign *MUST* be run _AFTER_ AssignWedge!!!  If you put AutoAssign
  260. into WBStartup drawer STARTPRI tooltype should be set to lower value than
  261. STARTPRI value of AssignWedge!  (If you are not familiar with STARTPRI tooltype
  262. refer to your Workbench Manual).
  263.  
  264.     For your convinience AutoAssign's icon has STARTPRI tooltype set to -128
  265. (the lowest value).
  266.  
  267.  
  268. To Do
  269. -----
  270.  
  271.     o Installer script
  272.  
  273.     o A tool to extract all assigns from user-startup and create (or add to)
  274.       the assignsfile (soon :-)
  275.  
  276.     o A hotkey to remove all previously made assigns (ie AutoAssign should
  277.       be a commodity)
  278.  
  279.     o Polish and, maybe, French documentation.
  280.  
  281.     o AutoAssign prefs editor (?)
  282.  
  283.     Note, that the last one depends on the feedback I will get from you.
  284.     (Just don't be lazy - write few words if you like & use AutoAssign)
  285.     For me it's convinient enough to edit assignsfile with an
  286.     editor.
  287.  
  288.     FEEDBACK REALLY ENCOURAGED!!! TELL ME YOUR IDEAS!!!
  289.  
  290.  
  291. Contacting the author
  292. ---------------------
  293.  
  294.     Any *ideas*, *bug reports*, *donations*, hardware (for example Cyberstorm
  295. turboboard for my A4000), etc.  will be sincerely welcomed.  Just contact me!
  296.  
  297.     My addy:
  298.                 Grzegorz Calkowski
  299.                 Rzedowice
  300.                 ul.Dobrodzienska 8
  301.                 42-780 Dobrodzien
  302.                 POLAND
  303.  
  304.     Phone:      +48(0)34-575875
  305.  
  306.     E-mail:     calkowsk@us.edu.pl
  307.  
  308. (Sorry, for my poor English...)
  309.  
  310.  
  311. Always remember:
  312.  
  313.         Beeting is beliving...
  314.  
  315.         and Amiga is the best computer ever!
  316.  
  317.  
  318. Acknowledgements
  319. ----------------
  320.  
  321. Thanks go to:
  322.  
  323.    o  Michal "Dixan05" Prochownik for the game idea. Hope we'll realize
  324.       the project :-)
  325.  
  326.    o  Ryszard "Justus" Baginski for being "Marysia" ;)
  327.  
  328.    o  Jacek "Shind" Grzegorczyk for supporting me with additional
  329.       340MB harddisk and for loads of hot new stuff :-]
  330.  
  331.    o  Pawel Wezgowiec for hard work with downloading Linux for me.
  332.  
  333.    o  For develop team at C= (R.I.P) for the wonderful machine.
  334.  
  335.    o  ESCom for giving us a ray of hope...
  336.  
  337.  
  338. History
  339. -------
  340.  
  341. v1.00 (06.07.95)
  342.  
  343.     o First release.
  344.  
  345.  
  346. v1.01 (07.07.95)
  347.  
  348.     o Doesn't lock the assignsfile for the whole run time. It allows for
  349.       editing the assignsfile without quitting & re-entering AutoAssign.
  350.       As a side-effect full path to the assignsfile must be given.
  351.  
  352.  
  353. v1.10 (25.07.95)
  354.  
  355.     o Auto-mount feature added.
  356.  
  357.     o Support for multi-assigns added. Now uses ReadArgs() to parse.
  358.  
  359.     o Icon's STARTPRI tooltype set to -128 instead of -30. (To be safer :-)
  360.  
  361.     o Documentation reworked a bit.
  362.  
  363.  
  364. v1.11 (27.07.95)
  365.  
  366.     Oooopss...  1.10 was an *accidental* release - I forgot to include the
  367.     latest compiled executables. (So, in fact, this is what 1.10 should be).
  368.  
  369.     o FROM keyword for mount didn't work. If specified _whole_ mount line
  370.       was ignored! Fixed.
  371.  
  372. v1.12 (23.10.95)
  373.  
  374.     o Recompiled with some compiler's options changed - now ca. 500 shorter!
  375.  
  376.     o Documentation update - included my E-Mail address! (finally, got it %-)
  377.  
  378.     o Expect new _major_ update soon (-: When I finish my current -commercial-
  379.       project :-)
  380.  
  381.