home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 632.lha / AddAssign_v1.04 / AddAssign.doc.pp / AddAssign.doc
Encoding:
Text File  |  1992-05-19  |  7.2 KB  |  220 lines
  1. AddAssign V1.04 Manual
  2. ======================
  3.  
  4. Copyright:
  5. ----------
  6. (c) 1991 Alexander Rawass
  7.  
  8. Alexander Rawass
  9. Wilhelminenstraße 44
  10. 6700 Ludwigshafen 15
  11. Germany
  12. 0621/57 75 98
  13.  
  14.  
  15. AddAssign consists of two programs, named 'AddAssign' and 'AddAssignInstall'.
  16. Both of them are freely distributable ShareWare; that means, the author
  17. allows free copying and spreading of his program, as long as there is no
  18. profit made for the distributor.
  19. The copyright for the program and the source-code remains with the author.
  20.  
  21. If you use AddAssign regularly, you have to pay the ShareWare-fee of DM 5
  22. (Deutschmark) or US$ 5 (please send the money to the above address).
  23. If you have payed, you are a registered user and receive the latest update
  24. of AddAssign as soon as possible per disk.
  25.  
  26. Using AddAssign without paying the ShareWare-fee is both illegal and
  27. immoral !
  28.  
  29. I.    What is AddAssign for?            line  37
  30. II.    Examples                line  69
  31. III.    Usage of AddAssign            line 124
  32. IV.    Compiling                line 137
  33. V.    Distribution                line 154
  34. VI.    Last and least                line 102
  35.  
  36.  
  37. What is AddAssign for?
  38. ----------------------
  39.  
  40. AddAssign is a small system patch like FastDir, ViewDos, PatchReq,
  41. SnoopsDos,etc.
  42.  
  43. It is an improvement for the normal 'assign' command.
  44. With the standard 'assign', you may assign a logical device only to ONE
  45. volume or subdirectory at a time.
  46. This will get you in trouble, if you wanted to split up one of your
  47. standard C:, LIBS:, DEVS: etc. directories (maybe in libs/math for the
  48. mathematical libraries, libs/needed for the libraries you need most and
  49. libs/never_needed_but_once for the libs you ...), cause AmigaDos will
  50. search (at a 'OpenLibrary' or 'OpenDevice' call) in the directory assigned
  51. by assign.
  52.  
  53. With AddAssign, this becomes different.
  54. Now, you may put your programs in different directories, but when they are
  55. accessed (via DEVICE:program), AddAssign will search in all directories
  56. addassigned with AddAssign (oh my god, what a sentence!).
  57.  
  58. Shortly, you can assign an already assigned logical device a second
  59. directory to search for (example : AddAssign c: df1:x).
  60. When hereafter a program is accessed with df0:c/prog or c:prog or :c/prog,
  61. AmigaDos will not only search in C: for prog, but also in df1:x.
  62.  
  63. With this method, you can put programs or libraries which should be on the
  64. system disk on a second disk, without having any disadvantages.
  65.  
  66. Remark : the standard CLI command 'path' will not work if a program is
  67. accessed as 'C:program', but AddAssign will work!
  68.  
  69. Examples :
  70. ----------
  71. without AddAssign :
  72.  
  73.     Open("c:startup")
  74.         Dos searches only in SYS:C for STARTUP
  75.     OpenLibrary("rekwester.library")
  76.         Dos searches only in SYS:LIBS for REKWESTER.LIBRARY
  77.     OpenDevice("drucker.devcie")
  78.         Dos looks in SYS:DEVS for DRUCKER.DEVICE
  79.  
  80. with AddAssign (after executing the following) :
  81.  
  82.          AddAssign c:    df1:extras
  83.         AddAssign c:    df1:c
  84.         AddAssign libs: df1:spezial/libs
  85.         AddAssign devs: df2:treiber
  86.         AddAssign devs: df0:normtreiber/devs
  87.  
  88.     Open("c:startup")
  89.         Dos searches in SYS:C, DF1:EXTRAS, DF1:C for STARTUP
  90.     OpenLibrary("rekwester.library")
  91.         Dos will look in SYS:LIBS, DF1:SPEZIAL/LIBS for your
  92.                              REKWESTER.LIBRARY
  93.     OpenDevice("drucker.device")
  94.         Dos scans SYS:DEVS, DF2:TREIBER, DF0:NORMTREIBER/DEVS
  95.                             for DRUCKER.DEVICE
  96.  
  97.  
  98. A common example :
  99.  
  100. You, the user, are examining your latest package of brand new fish disks
  101. for something useful, as you discover a program you want to try.
  102. Unfortunately, the program needs the 'oh_not_another_library_again.library',
  103. which you don't have at the moment in your LIBS: directory (and you don't
  104. want to copy it there, cause to lack of disk space or something else).
  105. So, what do you do?
  106. Normally (what is normal?) you would maybe do the following :
  107. assign LIBS: 'AmigaLibDisk999:usefulV3.6/libs' and then try to start the
  108. program. But so, the program may be able to open the
  109. 'oh_not_another_library_again.library', but it would not be able to open
  110. the 'diskfont.library' which is only available on SYS:LIBS!
  111. So what do you say? (§%$%&/$/$%$/&%%$/ (censored))
  112.  
  113. BUT IF YOU OWN ADDASSIGN, there is no problem for you.
  114. You just have to install AddAssign (if you haven't it installed in your
  115. startup-sequence) by typing 'AddAssignInstall', and then you will type
  116. 'AddAssign LIBS: AmigaLibDisk999:usefulV3.6/libs' and then execute your
  117. program, and -whoopee- Dos will look in the one directory for the one
  118. library on in the second for the other.
  119.  
  120. (Hope you understood what AddAssign does)
  121.  
  122.  
  123.  
  124. Usage of AddAssign :
  125. --------------------
  126.  
  127. AddaInstall        : installs the patch in the system
  128. AddaInstall remove    : removes AddAssign from your system
  129. AddAssign <device> <dir>: after that, Dos will look also in <dir> of you
  130.               access <device>
  131. AddAssign list        : lists all additional assigns made with AddAssign
  132.  
  133. (P.S.: to work, AddAssign will need the arp.library in your LIBS:
  134. directory)
  135.  
  136.  
  137. Compiling :
  138. -----------
  139.  
  140. AddAssign was compiled under Aztec C V5.0a, having just a meagre MegaByte
  141. of RAM and very less place on my disks (owning no HD yet...)
  142.  
  143. as addiglue
  144. cc addainstall -so -wdons -qv
  145. ln addainstall addiglue gads arpdetach -larp -lc
  146.  
  147. cc addassign -so -wdons -qv
  148. ln addassign gads -larp -lc
  149.  
  150. (whereas 'gads', 'arpdetach' and 'arp.lib' belong to the code to invoke the
  151. arp.library)
  152.  
  153.  
  154. Distribution :
  155. --------------
  156.  
  157. AddAssign is ShareWare. It may be freely ditributed as long as no profit is
  158. made for the distributor and as long as AddAssign is completely distributed
  159. (either as archive or in a directory).
  160. The program, the source code and all subroutines remain copyright by the
  161. author.
  162.  
  163. to AddAssign belong :
  164.  
  165.     addassign        - program
  166.     addainstall        - program
  167.     addassign.doc        - this documentation
  168.     addassign.vertrieb    - Germans, read this!
  169.     addassign.readme    - a short readme-file
  170.     addassign.c        - source
  171.     addainstall.c        - source
  172.     addassign.h        - some headerfile
  173.     addiglue.asm        - assembler glue routines
  174.     ar_defs.h        - some defines
  175.     ar_funcs.h        - some small functions I wrote
  176.  
  177. (to compile, you'll also need gads.o, arpdetach.o and arp.lib from the
  178. arp.library package)
  179.  
  180. I would like to see AddAssign distributed with some PD-series, like Fred
  181. Fish, Taifun, Kickstart, TBAG, etc.
  182.  
  183. The newest version of AddAssign will be available at the following
  184. FTP-servers (I mean, when I've written them!) :
  185.  
  186.     ftp.uni-kl.de
  187.     amiga.physik.unizh.ch
  188.     ab20.larc.nasa.gov
  189.     wolfen.cc.uow.edu.au
  190.  
  191. (oops, are there any other good FTP-servers with amiga stuff in Europe?)
  192.  
  193.  
  194. Although I've no email-address, you can reach a friend of mine via :
  195.  
  196.     naddy@sun.rhrk.uni-kl.de (email)
  197.  
  198. Mention my name, and he will ship me your letter (complaints, bug reports,
  199. ideas for improvement, etc.)
  200.  
  201.  
  202. Last and least :
  203. ----------------
  204. there are some more small programs available from the author :
  205.  
  206. FastDir        will speed up directory access for disks enormously, is
  207.         installed as a system patch and works with EVERY
  208.         (multitasking) program
  209. ViewDos        displays most of the access of DOS-routines in a window
  210. BookPrint    prints manuals in a paper-saving way, printout will look
  211.         very good and will be readable like a book
  212. CTab        a C-source-code formatter
  213. MovieStrap    strips out IFF-pictures from Moviesetter-Files (especially
  214.         useful for the cute Eric-Schwartz anims, although it may be
  215.         illegal)
  216.  
  217. BookPrint Unix Version :
  218.         the same as BookPrint, but written for Unix, works the same
  219.         like 'pr', but is much much better and more reliable.
  220.