home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / util / dosprefs-2.0.lha / DOSPrefs-2.0 / DOSPrefs.doc < prev    next >
Encoding:
Text File  |  1994-07-05  |  9.8 KB  |  289 lines
  1. 1. About DOSPrefs
  2.  
  3. DOSPrefs is a small commodity with three functions:
  4.  
  5. 1. Control the "Wildstar"-flag of the Amiga OS 2.0+ dos.library.
  6.  
  7. 2. Control the "Noclick"-flags of the Amiga OS 2.0+ trackdisk.device.
  8.  
  9. 3. Provide an all new "Unixdirs"-feature.
  10.  
  11. These functions can be controlled when DOSPrefs is started by Tooltypes,
  12. or at runtime by Intuition(tm)-menus.
  13.  
  14. Furthermore, DOSPrefs is localized, using the locale.library* (requiring
  15. Workbench 2.1+) to adapt to your prefered language, and provides a context-
  16. sensitive help system with AmigaGuide(tm) (requiring amigaguide.library V34+).
  17. (Simply press "Help" !)
  18.  
  19. * currently, catalog and amigaguide help files for the following languages
  20. are included:
  21.  
  22. english (catalog built in)
  23. deutsch
  24.  
  25. If you want, you can help me to provide support for additional languages.
  26. All you have to do is fill in the empty catalog source file DOSPrefs.ct and
  27. translate the helpfile catalogs/english/DOSPrefs.guide (note: you must not
  28. translate the @node names !!), and mail them to me (see below for my
  29. addresses). I will include them in the next release.
  30.  
  31. 2. Requirements
  32.  
  33. DOSPrefs requires at least Kickstart 2.04. To be more exact, the following
  34. libraries are needed:
  35.  
  36. exec.library V37
  37. dos.library V37
  38. commodities.library V37
  39. icon.library V37
  40. utility.library V37
  41. intuition.library V37
  42. gadtools.library V37
  43. graphics.library V37
  44. locale.library V38*
  45. amigaguide.library V34*
  46.  
  47. *: optional
  48.  
  49. 3. Installation
  50.  
  51. If you have the C= Installer program, simply double-click on the 
  52. Install-DOSPref Icon to start the installation. If you do not have the
  53. installer, this is what you have to do:
  54.  
  55. copy DOSPrefs SYS:WBStartup clone
  56. copy DOSPrefs.info SYS:WBStartup clone
  57. copy catalogs LOCALE:catalogs all clone ; if you have WB 2.1 +
  58. copy help HELP: all clone               ; if you have amigaguide
  59.  
  60. You may of course opt to install catalogs and helpfiles for only some of the
  61. provided languages.
  62.  
  63. NOTE: If you have AmigaGuide, DOSPrefs needs a HELP: assign. The standard
  64. for this assign is the directory locale:help. 
  65.  
  66. 4. Tooltypes
  67.  
  68. When DOSPrefs is started from the Workbench(tm), it evaluates the tooltypes
  69. of its icon; when it is started from the CLI, it evaluates the commandline
  70. arguments (the recognized Parameters are in both cases the same). The 
  71. parameters recognized by DOSPrefs are summarized in the following template:
  72.  
  73. CX_PRIORITY/N/K,CX_POPKEY/K,CX_POPUP/K,PUBSCREEN/K,WILDSTAR/K,UNIXDIRS/K,
  74. NOCLICK/K
  75.  
  76. CX_PRIORITY (default: 0): This is the priority for the commodities event
  77. handling mechanism.
  78.  
  79. CX_POPKEY (default: lalt d): This is the hotkey that causes DOSPrefs to
  80. show its interface. (By the way: starting DOSPrefs a second time will have
  81. the same effect as pressing the hot key; the first DOSPrefs will pop up and
  82. the second will terminate immediately.)
  83.  
  84. CX_POPUP (default: yes): This determines, if DOSPrefs is to show its
  85. interface on program startup.
  86.  
  87. PUBSCREEN (no default): This is the name of the public screen on which
  88. DOSPrefs is to open its interface. If this parameter is not specified or
  89. the given screen cannot be found, DOSPrefs opens its interface on the
  90. default public screen.
  91.  
  92. WILDSTAR (default: yes): This determines, if DOSPrefs is to set the
  93. wildstar flag of the dos.library on startup.
  94.  
  95. UNIXDIRS (default: yes): This determines, if DOSPrefs is to install the
  96. unixdirs-patch on startup.
  97.  
  98. NOCLICK (no default): This determines for which floppy drives DOSPrefs
  99. sets the noclick-flags on startup. You have to list the
  100. drives seperated by "|"s, e.g. "DF1:", "DF0:|DF1:|DF2:".
  101.  
  102. CAUTION: If an empty drive clicks even if you have set the noclick flag
  103. for this drive, unset the flag immediately. Your disk drive may be damaged
  104. otherwise.
  105.  
  106. 5. GUI
  107.  
  108. DOSPrefs has both menus and gadgets. The gadgets duplicate the functions of
  109. the "Settings" menu. 
  110.  
  111. DOSPrefs has the following Menu-structure (using the english language):
  112.  
  113.    Project              Settings
  114.      Save                 WildStar
  115.      About                UnixDirs
  116.      Enable               NoClick
  117.      Disable                DF0:
  118.      Hide                   DF1:
  119.      Quit                   DF2:
  120.                             DF3:
  121.                             
  122. 5.1 The Project Menu
  123.  
  124. "Save" saves the current settings in the DOSPrefs.info file.
  125.  
  126. "About" shows a nice, short copyright message. ;-)
  127.  
  128. "Enable" brings DOSPrefs to the active state. If it is already active,
  129. the "Enable" item is ghosted.
  130.  
  131. "Disable" brings DOSPrefs to the inactive state, if possible. If it is
  132. already inactive, the "Disable" item is ghosted.
  133. This operation may fail if the "unixdirs"-patch cannot be undone.
  134.  
  135. "Hide" hides the user interface of DOSPrefs. (Clicking on the
  136. closegadget has the same effect.) To make the interface visible again,
  137. press the hot key or use the commodities exchange program.
  138.  
  139. "Quit" terminates DOSPrefs, if possible.
  140. This may fail if the "unixdirs"-patch cannot be undone.
  141.  
  142. 5.2 The Settings Menu
  143.  
  144. 5.2.1 The WildStar Item
  145.  
  146. "WildStar" toggles the wildstar-flag of the dos.library. If the flag is set,
  147. "*" will be recognized as an abbreviation for "#?" in search patterns.
  148.  
  149. 5.2.2 The UnixDirs Item
  150.  
  151. "UnixDirs" enables the unixdirs-patch of the dos.library. What does this
  152. patch do ? It allows the use of the special directory names ".." and "."
  153. like under UNIX (thus the name of the function).
  154.  
  155. ".." represents the parent-directory of the current directory (like "/").
  156. So "../blabla" is identical to "/blabla", etc.
  157.  
  158. "." is the current directory. Thus you can say "copy ../blabla/*.c .".
  159.  
  160. NOTE: Due to the nature of library patches, it may not be possible to
  161. unpatch the dos.library if the patched functions are in use.
  162. DOSPrefs will detect this and put up a requester allowing you to try again 
  163. to unpatch the dos.library or to cancel the operation.
  164.  
  165. Here is an alphabetic list of the patched library funtions:
  166.  
  167. AssignLate
  168. AssignPath
  169. CreateDir
  170. DeleteFile
  171. GetDeviceProc
  172. LoadSeg
  173. Lock
  174. MakeLink
  175. NewLoadSeg
  176. Open
  177. Rename
  178. SetComment
  179. SetFileDate
  180. SetOwner*
  181. SetProtection
  182.  
  183. * V39 dos.library funtion
  184.  
  185. NOTE: In version 1.0, DOSPrefs patched some more functions. This was not a
  186. good idea - it caused weird problems when I improved the string conversion
  187. routine. 
  188.  
  189. 5.2.3 The NoClick SubMenu
  190.  
  191. The "NoClick" item has four subitems labeled "DF0:" to "DF3:", that allow you
  192. to set the noclick-flag individually for each of your disk drives. If a disk
  193. drive does not exist, its subitem is disabled.
  194.  
  195. CAUTION: If an empty drive clicks even if you have set the noclick flag
  196. for this drive, unset the flag immediately. Your disk drive may be damaged
  197. otherwise.
  198.  
  199. 6. Licence
  200.  
  201. DOSPrefs is Freeware. You may freely redistribute the complete, unchanged
  202. archive. You may not change any of the files or distribute an incomplete
  203. version of the archive. (Of course, you may change ToolTypes in the .info
  204. files. :-)) You may not add files to the archive, except ony .displayme -
  205. file with your mailbox-logo if - and only if - you have the archive freely
  206. available for download.
  207.  
  208. You may charge no more than DM 5,- (or US $3) for a disk containing DOSPrefs. 
  209. (Fred Fish is exempt from this rule.) DOSPrefs may also be distributed on
  210. CD-ROM (if the price is below US $50). 
  211.  
  212. 7. Disclaimer & Warranty
  213.  
  214.      THERE IS NO WARRANTY FOR THE PROGRAMS, TO THE EXTENT PERMITTED
  215.      BY APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE
  216.      COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAMS "AS
  217.      IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
  218.      INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  219.      MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE
  220.      ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAMS IS
  221.      WITH YOU.  SHOULD THE PROGRAMS PROVE DEFECTIVE, YOU ASSUME THE
  222.      COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.  
  223.  
  224.        IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
  225.      WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY
  226.      REDISTRIBUTE THE PROGRAMS AS PERMITTED ABOVE, BE LIABLE TO YOU
  227.      FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
  228.      CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE
  229.      THE PROGRAMS (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA
  230.      BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
  231.      PARTIES OR A FAILURE OF THE PROGRAMS TO OPERATE WITH ANY OTHER
  232.      PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED
  233.      OF THE POSSIBILITY OF SUCH DAMAGES.  
  234.  
  235. There is no warranty at all. Use at your own risk.
  236.  
  237. 8. Bug Reports
  238.  
  239. Report bugs & improvement suggestions to:
  240.  
  241. SnailMail:
  242.   Norbert Püschel
  243.   Am Turm 6
  244.   53572 Unkel
  245.   Germany
  246.  
  247. or
  248.  
  249. EMail:
  250.   nobbi@zaphod.rhein.de (Internet)
  251.  
  252.   2:2453/30.14  (FidoNet)
  253.   21:100/50.14  (GerNet)
  254.   53:228/107.14 (BonNet)
  255.  
  256. 9. Credits
  257.  
  258. Thanks to the TrapDoor-Team for the disclaimer I shamelessly copied from
  259. them. ;-)
  260.  
  261. 10. Version History
  262.  
  263.   1.0 (.07.93)
  264.   - first public release
  265.  
  266.   1.1 (.03.94)
  267.   - reduced number of patched functions. Some patches were superfluous,
  268.     some even potentially dangerous.
  269.   - improved string conversion routine. Now, the strings are no longer
  270.     patched "in place" but copied & converted onto the stack.
  271.  
  272.   1.2 (16.06.94)
  273.   - fixed bug in LoadSeg()-patch that caused programs with overlays to
  274.     crash. Thanks to Robert Reiswig for the bug report, shame to CBM for
  275.     the bad documentation.
  276.  
  277.   2.0 (05.07.94)
  278.   - improved GUI. Now has some checkbox gadgets in addition to menus.
  279.   - added a function to save the current settings in DOSPrefs.info
  280.   - improved patching mechanism. Now uses a jumptable; thus, DOSPrefs can
  281.     exit even if someone changed the patched vectors in dos.library.
  282.   - now detects if SetMan or SaferPatches is installed (skips library
  283.     vector change detection in this cases) (suggested by Gunther Nikl).
  284.   - moved the code that is not always needed (GUI, etc.) into an overlay.
  285.   - fixed string conversion function. Now processes names ending in .
  286.     correctly.
  287.   - improved help system. Now searches for guide files in your prefered
  288.     languages, defaulting to english if none are found.
  289.