home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaDemoCD1.iso / DEMOS / EFFECT-NixMizzMe10.DMS / EFFECT-NixMizzMe10.adf / MENUTS / Menuts_V1.74a / Documents / Menuts_V1.74a.DOC < prev   
Encoding:
Text File  |  1993-06-18  |  14.0 KB  |  339 lines
  1.                   MANUAL FOR 'MENUTS VERSION 1.74a'...
  2.  
  3. COPYRIGHT
  4.  
  5. This manual Copyright (c) M. van Aalten / DBPP, Inc. and DBPP software Cor-
  6. poration, 1985, All Rights Reserved. This document may not, in whole or in
  7. part, be copied, photocopied, reproduced, translated, or reduced to any
  8. electronic medium or machine readable form without prior consent, in wri-
  9. ting, from DBPP software Inc.
  10.  
  11. This software Copyright (c) DBPP software Corporation, 1985, All Rights Re-
  12. served. The distribution and sale of this product are are intended for the
  13. use of the original purchaser only. Lawful users of this program are hereby
  14. licensed only to read the program, from its medium into memory of a computer,
  15. solely for the purpose of executing the program.
  16. Duplicating, copying, selling, or otherwise distributing this product is a
  17. violation of the law.
  18.  
  19.  
  20. DISCLAIMER
  21.  
  22. THE PROGRAM IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
  23. OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  24. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO
  25. THE RESULTS AND PERFORMANCE OF THE PROGRAM IS ASSUMED BY YOU. SHOULD THE
  26. PROGRAM PROVE DEFECTIVE, YOU (AND NOT THE DEVELOPER OR COMMODORE-AMIGA, INC.
  27. OR ITS DEALERS) ASSUME THE ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR OR
  28. CORRECTION. FURTHER, COMMODORE-AMIGA DOES NOT WARRANT, GUARANTEE, OR MAKE ANY
  29. REPRESENTATIONS REGARDING THE USE OF, OR THE RESULTS OF THE USE OF, THE
  30. PROGRAM IS TERMS OF CORRECTNESS, ACCURACY, RELIABILITY, CURRENTNESS, OR
  31. OTHERWISE; AND YOU RELY ON THE PROGRAM AND THE RESULTS SOLELY AT YOUR OWN
  32. RISK. IN NO EVENT WILL COMMODORE-AMIGA, INC. BE LIABLE FOR DIRECT, INDIRECT,
  33. INCIDENTAL OR CONSEQUENTIAL DAMAGES RESULTING FROM ANY DEFECT IN THE PROGRAM
  34. EVEN IF IT HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME LAWS DO
  35. NOT ALLOW THE EXCLUSION OR LIMITATION OF IMPLIED WARRANTIES OR LIABILITIES
  36. FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE LIMITATION OR
  37. EXCLUSIONS MAY NOT APPLY.
  38.  
  39. ============================================================================
  40.  
  41. The above piece of text was found at the first page of the manual
  42. from 'AmigaBasic', and therefore should be ignored by anyone reading this.
  43. (I think I broke a copyright.)
  44. Thanks to ETO of CCCP for this great idea!
  45. The program may be copied as much as you like. I would be pleased if this
  46. manual and the example 'list'-file is copied with it. If you want, ask as
  47. much money for this program as you like. I hereby give all of you permission
  48. to sell it. But, all copyrights are MINE!
  49. If you paid for this program, or for this document, bad luck! There were
  50. ways to get this one for free... but it's to late to cry now.
  51.  
  52.  
  53.  
  54.     About 'Menuts':
  55.  
  56. Menuts is supposed to be a user-friendly (?) selector-program, which might
  57. even replace your favourite workbench.
  58. It shows the user a window with a number of gadgets. Double-clicking on one of
  59. those gadgets will start the desired program(s), or reveal a new window with
  60. new choices (submenu).
  61. Also, it has a built-in screen- and mouseblanker.
  62. At the time writing, there are already >5< registered users!
  63.  
  64.  
  65.  
  66.     History of 'Menuts':
  67.  
  68. It was first programmed as a harddisk selector for HAWK of Sanctuary. He liked
  69. it, and being an obeying programmer, I improved it to his needs.
  70. At that time, I was a floppy-user and therefore disliked Menuts.
  71. Now that I have bought a harddisk myself, I improved Menuts for MY needs...
  72.  
  73.  
  74.  
  75.     How to use 'Menuts':
  76.  
  77. First, create a 'list' file for Menuts, with all the gadget&file info.
  78. Place it in your favourite 'S:' directory, the 'S:Menuts/' directory or the
  79. current directory.
  80. Execute Menuts, and everything should work fine now.
  81. You get a window with a number of gadgets:
  82. 1) A window close gadget.
  83.     In case you get tired of 'Menuts'.
  84. 2) A window 'zoom' gadget. (ONLY on Kick2.0 and higher!)
  85.     Resizes Menuts-window to sleep-size.
  86. 3) A window to back/front gadget(s)
  87.     Guess what it does...
  88. 4) A slide bar.
  89.     When you have defined more gadgets in your list file than the window
  90.     could handle, you can slide through all the gadgets.
  91. 5) A 'parent dir!' gadget.
  92.     Only found in a submenu, this is the last gadget under your own created
  93.     gadgets. Doubleclicking leads 'Menuts' back to the last menu.
  94. 6-65535) User defined gadgets.
  95.    These gadgets look just like text strings, max. 12 chars.
  96.    Doubleclicking one of these probably executes a program.
  97.    For example, if you have a gadget reading 'PowerPacker', doubleclicking
  98.    it will hopefully execute the (legal?) version of PowerPacker. I can't
  99.    promise that, because YOU have to define it in YOUR list-file!
  100. The last line of the Menuts-window is a status-line, with memory info and
  101. a clock.
  102.  
  103.  
  104.  
  105.     How to create a 'list'-file:
  106.  
  107. With a text-editor: TxEd, CEd, MeMacs, Ed, Etc.
  108.  
  109.  
  110.  
  111.     The format of a 'list'-file:
  112.  
  113. The first list-file must be named 'Menuts.List'. This is the file that the
  114. program will search for when it is executed. It defines the gadgets you
  115. will see immediately when the window shows up, and should therefore contain
  116. your most used programmes, and possibly some sub-menus.
  117. A list-file is divided in three parts:
  118. - First, an option-part, where you can specify specific specifications for
  119.   Menuts, like X/Y position and its size.
  120. - Then, on a fresh, new line, a '#' character, indicating that the next
  121.   part will follow.
  122. - The second part defines all the gadget-names. Every line is for one gadget,
  123.   in the order left to right, top to bottom. Every name can be max. 12 chars
  124.   long. The names will not be centered (yet). Names longer than 12 chars will
  125.   be truncated.
  126.   Example:
  127.  
  128. "  DefPack   "
  129. "PowerPacker"
  130. "AsmOne V1.24"
  131. "More Choice"
  132.  
  133.  
  134. - After that part, another '#' line must follow, to indicate the start of
  135.   the last part:
  136. - The last part specifies what to execute for every gadget.
  137.  
  138. "DH1:Utils/DefPack"   will execute that program for the first gadget.
  139.  
  140.   Use the '|' character to specify multiple executes:
  141. "Type DH1:Utils/pp.copyright|DH1:Utils/PowerPacker_V4.6b|Format DH0:"
  142.   will type a copyright notice, then execute powerpacker, then format
  143.   your harddisk.
  144.  
  145.   Use the '*' character as the first character on a line to execute all
  146.   programmes on an output-window.
  147.   You probably won't need it, but here's an example:
  148. "*Type DH0:Utils/Bugreport.txt|DH9:Virus/AsmBugOne"
  149.   The output-window is sometimes needed with programmes that use Shell I/O,
  150.   for example the defpack cruncher.
  151.  
  152.   Use the '#' character to specify a submenu: Menuts will restart with
  153.   another list-file!
  154.   You will get an extra gadget, 'Parent Dir!', which will get you back
  155.   to the last menu. This can also be done by pressing the RIGHT MOUSE
  156.   button. An example:
  157. "#DH0:S/Menuts/SubMenuts.list"
  158.    Of course, any filename and any directory can be specified.
  159.  
  160.  
  161.  
  162.     The 'Options' in a list file:
  163.  
  164. In the first part of the list-file, you may specify the following options:
  165. (everything between brackets is the default value for that option)
  166. .XPOS ddd            The x-position of the top-left point of the window.
  167.     [-128]        Negative values are relative to the right-side
  168.                 screenborder.
  169. .YPOS ddd            The y-position of the top-left point of the window.
  170.     [10]            Negative values are relative to the bottom screenborder.
  171. .XMAX dd             The maximum number of gadgets on one line.
  172.      [1]
  173. .YMAX dd             The maximum number of gadgetlines in the window.
  174.     [10]
  175. .NOFLASH d        When the Menuts-window is active, and you press a key, the
  176.      [0]          window is deactivated. A warning-flash is given, to indi-
  177.                 cate that you have lost a character. By specifying this
  178.                 option, you tell Menuts that you do not like those
  179.                     flashes.
  180.                 d=0 : warning flashes. d<>0 : no warning flashes.
  181. .SPEED dd            The delay (in seconds) for the status-bar to change.
  182.     [3]            
  183. .MOUSEWAIT ddd        The delay (in seconds) for the mousepointer to blank.
  184.     [5]            (of course only when <delay> seconds no key/mouse/drive
  185.                  activity!)
  186.                 ddd=0 : no mousepointerblanking.
  187. .SCREENWAIT ddd    The delay (in seconds) for the screen to blank.
  188.     [60]            (of course only when <delay> seconds no key/mouse/drive
  189.                  activity!)
  190.                 ddd=0 : no screenblanking.
  191. .NOPOINTERCLEAR d    Normally, when keyboard activity is detected, 'Menuts'
  192.     [0]            will blank the mousepointer, so you won't be bothered
  193.                 with that irritating little bitch anymore. With this
  194.                 option, you can stop 'Menuts' with that blankaction.
  195.                 d=0 : pointerblanking allowed, d<>0 : not allowed.
  196. .NOKEYSTUFF d        With this option, you can disable all keyboard function
  197.     [0]            of 'Menuts'. Functions described later.
  198.                 d=0: Keyboard functions enabled, d<> : disabled.
  199. .POPUPKEY c        You can specify the popupkey: Control + Left-Amiga + c,
  200.     [m]            where 'c' is the specified key. Shifted keys are not
  201.                 supported, unknown characters will be converted to 'm'.
  202.                 Default popupkey: CTRL+LeftAmiga+'m'.
  203. .AUTOCENTER d        If you want the gadgettexts to be autocentered, d<>0.
  204.     [1]            If you want to center them by hand, d=0
  205.  
  206. An example list file is hopefully supplied with this document. It shouldn't
  207. make it much clearer.
  208.  
  209.  
  210.  
  211.     Keyboard functions:
  212.  
  213. - Pop-up key:
  214.   With 'Control+LeftAmiga+"m"' , 'Menuts' will be activated, the window
  215.   and screen where 'Menuts' is on will be pushed to the front.
  216.   The popupkey can be modified with the '.POPUPKEY' option.
  217. - F1 - F10 and Shift F1 - Shift F10:
  218.   These will activate the functions of the first 20 user-gadgets, if defined.
  219.   There is no difference between double-clicking or the corresponding
  220.   function key.
  221. - Parent-key: (backspace)
  222.   With 'backspace', 'Menuts' will go one submenu back.
  223.   There is no difference between double-clicking the parent dir gadget or
  224.   pressing the backspace key.
  225.  
  226.  
  227.  
  228.     Hints'n'Tips:
  229.  
  230. I think it is smart to have the window positioned at the right side of the
  231. screen, just one gadget wide, and right under the window-to-back/front
  232. gadget of the Shell-window. That way, it won't be in your way, but is
  233. available when you need it.
  234.  
  235.  
  236.  
  237.     Note from HAWK / SANCTUARY:
  238.  
  239. I've been using Menuts for just about as long as I've had my harddisk and
  240. found it a very useful utility. It much is faster than the regular workbench
  241. because you don't need to load all those irritating icons. Unlike Speedboy
  242. I prefer to have Menuts full-screen width, because then I get more gadgets
  243. on the screen without having to use the slider. Some Hints'n'Tips from me:
  244. - if you do not own a harddisk, then get one!
  245. - if you do not own a harddisk, copy the submenu's to ram: in your
  246.   startup-sequence if you find that reloading them from floppydisk takes
  247.   too long.
  248. - if you have Menuts take up the whole width of your screen then don't use
  249.   too may lines. It will prevent you from seeing any useful output in the 
  250.   CLI window.
  251. - DO NOT close the CLI where you've started Menuts from, Menuts needs the
  252.   CLI for output.
  253. - use RUN to start any programs which do not release the CLI after
  254.   execution. This way you can start another process from Menuts. If you
  255.   don't Menuts will wait for the CLI to be released before accepting
  256.   your selection.
  257.  
  258.  
  259. The author and his contact address:
  260. M. van Aalten
  261. Almalaan 2
  262. 3431 GX  Nieuwegein
  263. Holland
  264.  
  265. I used to be called 'Speedboy', until I dropped my handle.
  266.  
  267. That's it, and that's that!
  268.  
  269. Have fun!
  270.  
  271. ===========================================================================
  272.     Program History, starting from 'Menuts V1.50a':
  273.  
  274. V1.50a: Follow up to V1.40, but I don't remember what the improvement was.
  275.  
  276. V1.60a-d:    - Removed bugs in the auto-runback code.
  277.         - Menuts forced to Topaz-8 font. (might have some effect on the
  278.           rest of your system though... :-)
  279.         - Used the Kick2.0 function for the sleep-mode.
  280.           Sleep-mode not available on pre-2.0 kickstarts...
  281.         - Window size relative and user-definable.
  282.         - Slider bar introduced.
  283.         - Info-bar, with memory & time info.
  284.         - More options introduced, needed for the user-definedwindow size.
  285.         - probably a lot of bugs removed, with a lot of small improvements.
  286.  
  287. V1.62a-d    - Removed the extremely silly way for executing programmes, which
  288.           caused some shell-commands not to function properly.
  289.           (thanks to ETO-CCCP)
  290.  
  291. V1.70a    - Added mouse/screen blanker, with more listfile options.
  292. V1.70b    - Screen would blank to background color instead of black...
  293.           bug fixed!
  294. V1.70c    - Replaced the DMA-way of blanking mouse with a system-friendly
  295.           solution.
  296. V1.70d    - When you had 0 bytes chip and/or fast mem, nothing would be
  297.           displayed... bug fixed! (thanks to the Sourcerer-Sanctuary)
  298.  
  299. V1.71a    - Installed all keyboard functions.
  300. V1.71b    - Changed the popupkey from CTRL+Alt+m to CTRL+LeftAmiga+m.
  301.         - The popupcharacter can be specified with an option.
  302.  
  303. V1.72a    - Gadgets without dos-commands are now unclickable.  (KIWI/EFFECT)
  304.         - Added optional autocentering of gadgets. (KIWI/EFFECT)
  305.         - When the Menuts window is popupped, it will be 'unzipped' if
  306.           needed (Kick 2 only).
  307. V1.72b    - Bugfixed the autocentering function.
  308.         - Menuts will function properly on the WorkBench (yuk!).
  309.           For this reason, it is no longer possible to close Shell.
  310.         - From this version on, Menuts is a Da Bagger Production Posse pro-
  311.           duction!.
  312. V1.72c    - Hopefully removed the bug of Menuts blanking screen at startup...
  313. V1.72d    - Bug removed with the shell being locked when trying to start a
  314.           second Menuts. (KIWI/EFFECT)
  315.  
  316. V1.73a    - When pressing a key, Menuts will be de-activated and shell
  317.           activated, but from now on without losing the first key into
  318.           empty space... (thank god!)
  319. V1.73b    - On KickStart 1.2 systems, removing/inserting disks caused the
  320.           screen to blank... bug removed. (Carcharoth/SANCTUARY)
  321. V1.73c    - Hawk-bug of (sometimes) screenblanking at startup hopefully
  322.           removed in this version (one month testing needed...)
  323.  
  324. V1.74a    - Submenus have a different color on screen than the main items.
  325.         - By clicking on the status-info-bar on the bottom of the window,
  326.           you can skip a few messages (Handy if you just want to know the
  327.           time!)
  328.         - Because I dropped my handle 'Speedboy', 'Menuts' is now an offi-
  329.           cial 'M. van Aalten / DBPP' production.
  330.  
  331.     Buxx known:
  332. - I don't feel good about the way I workbenchfixed menuts... Who knows,
  333.   when the first bug-fix is needed?
  334. - Mouseblanker seems to switch mousepointers from different programs now
  335.   and then...
  336.  
  337. Major thanks to Hawk-Sanctuary, his bug-reports are too numerous to mention
  338. seperately...
  339.