home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / bbs / amigalib / d996 / startup-menu.lha / Startup-Menu / Startup-Menu.doc < prev    next >
Encoding:
Text File  |  1994-04-05  |  8.4 KB  |  209 lines
  1.                    Startup-Menu v1.00 documentation - OS2+
  2.                      
  3.         
  4. AboutThisDoc
  5.  
  6.         This documentation describes release 1.00 of Startup-Menu. This 
  7.   Program is freely distributable. However copyright is retained by the author
  8.   and no more than a nominal fee may be charged for distribution (price of a 
  9.   fish disk). 
  10.   
  11.   (* Legal stuff *)
  12.   In short, if any thing happens it's not my fault! You use this program at
  13.   your own risk.
  14.   
  15.  
  16. Introduction
  17.  
  18.         Startup-Menu is a menu which appears on start-up giving the user a 
  19.   choice of which startup-sequence to follow. The menu can have any number of
  20.   gadgets, limited only by the screenmode used and hardware, I've had 700! 
  21.                            
  22.           STARTUP-MENU REQUIRES KICKSTART 2 (V36) OR GREATER
  23.                  
  24. Installation
  25.         
  26.         The included Install script should be used to install SM. This script 
  27.   will copy the main program to C:, the preference editor to SYS:Prefs/, 
  28.   Reqtools.library to LIBS: and some example scripts and a prefs file to S:.
  29.   This files will be copied only after confirmation. In order to use SM your 
  30.   Startup-Sequence requires to be altered. Relax, I know how people cringe on 
  31.   altering their startup-sequence, how it will be non-standard and all but SM 
  32.   increases your flexibility at startup. You could install a default 
  33.   startup-sequence later as one of the options on the menu. 
  34.  
  35.   Your Startup-Squence requires to be altered to something like this:
  36.         
  37.   ;**************
  38.   
  39.   C:SetPatch QUIET                          ; Patch some bugs
  40.   C:Assign ENV: Sys:Prefs/Env               ; Assign ENV:, Reqtools requires this
  41.   
  42.   IF EXISTS DEVS:Monitors                   ; Active all monitors
  43.    IF EXISTS DEVS:Monitors/VGAOnly          ; so that you can get _any_ 
  44.     DEVS:Monitors/VGAOnly                   ; screenmode.
  45.    EndIF
  46.    C:List >NIL: DEVS:Monitors/~(#?.info|VGAOnly) TO T:M LFORMAT "DEVS:Monitors/%s"
  47.    Execute T:M
  48.    C:Delete >NIL: T:M
  49.   EndIF
  50.  
  51.   Failat 20
  52.   C:Startup-Menu                            ; execute SM. NOTE : SM can load-in
  53.   IF WARN                                   ; an alternative prefs file, eg
  54.                                             ; Startup-Menu [prefsfilename]
  55.    execute >NIL: S:Startup-sequence.wb      ; what to do if an error occurs
  56.   ENDIF
  57.   endcli >NIL:
  58.   
  59.   ;**************
  60.   
  61.   The above is for WB3.00 for WB2.0x simply delete the part dealing with 
  62.   monitors and replace it with the corresponding section from your original
  63.   startup-sequence.
  64.  
  65.   This file is copied to S: as startup-sequence.sm by the installation script.
  66.   To use this file simply rename the old startup-sequence as 
  67.   "startup-sequence.org" and rename this file to "startup-sequence"
  68.   
  69.   ReqTools is (c) Nico François.
  70.           
  71.           
  72. Creating_a_Preference_File
  73.  
  74.         SM requires a preference file in order to work. This file is
  75.   created by SMPrefs. With SMPrefs you create a list of gadgets that will be 
  76.   present on the menu the follwoing gadgets are used :
  77.   
  78.    o Top    : Moves the currently selected item in the list to the top.
  79.    
  80.    o Up     : Moves the currently selected item in the list up one place.
  81.    
  82.    o Down   : Moves the currently selected item in the list to the bottom.
  83.    
  84.    o Sort   : Sorts the list into decsending alphabetic order.
  85.    
  86.    o New    : Creates a new item in the list. This item becomes the current 
  87.               item
  88.  
  89.    o Remove : Removes the current item from the list.
  90.    
  91.    o Copy   : Copies the selected item.
  92.    
  93.   (* Have you understood that! Some information now... *)
  94.  
  95.    o List        : Each item in this list represents a button on the resulting
  96.                    menu created by SM.
  97.             
  98.    o Gadget Text : The text entered into this gadget will be shown on the 
  99.                    corresponding button in the menu.
  100.                    
  101.    o Command     : The command entered into this gadget will be executed by SM
  102.                    when the you select the corresponding button on the menu.
  103.                    A command of "None" will create a comment box, this ox will
  104.                    be a recessed bevelbox and not a gadget on the menu.
  105.                
  106.    o Command...  : Uses a file requester to fill the command gadget instead of 
  107.                    typing it in.
  108.                   
  109.    o Key         : Denotes the key equivalent for this gadget. All entries are
  110.                    converted into upper case.
  111.            
  112.    o Across      : Determines how many gadgets there will be horizontally.
  113.    
  114.    o Down        : Displays how many gadgets there will be vertically.
  115.    
  116.    o Screen...   : Brings up a screenmode requester. The mode picked from this 
  117.                    list will be used by the screen that the menu opens on. 
  118.                    This mode must be available at boot-time, i.e. execute the 
  119.                    corresponding monitor file before running SM.
  120.                  
  121.    o Font...     : Activates requester from which the font used in the menu
  122.                    can be picked, along with its style and size (6..30 point).
  123.                
  124.    o Palette...  : A screen is created, from which you can alter the palette
  125.                    that the menu screen will have.
  126.                    
  127.    o Titles...   : Two string gadgets will pop-up. The text entered into these
  128.                    will be shown on the window and screen titlebars.
  129.                    
  130.    o Save        : Saves the preference file as 'S:Startup-Menu.prefs' and 
  131.                    exits the program.
  132.             
  133.    o Save As...  : Requester allowing user to save a preference file elsewhere.
  134.    
  135.    o ?           : Some information.
  136.    
  137.    o Open...     : Requester allowing the user to load in a new preference 
  138.                    file. If the name returned by the requester does not exist 
  139.                    a new list is created.
  140.                
  141.    o Cancel      : Exits the program without saving the preference file.
  142.  
  143.  
  144. Overview
  145.       
  146.             Various scripts can now be created and entered as the commands in
  147.   SMPrefs. These scripts could be used to create totally different working 
  148.   environments, eg shell, WB each with separate ENVARC: drawers etc. SM allows
  149.   greate flexibility over what you can do at startup.
  150.     
  151.     
  152. The_End
  153.  
  154.             Hi, SM was writtten by me, Lee Kindness in my spare time while 
  155.   doing my SCE Highers. I would really like to hear from you if you use this
  156.   program, any suggestions on how to improve it are welcomed, along with tales
  157.   of bugs. I wrote SM due the frustration I had when running memory hungry 
  158.   games and applications, having to disable the startup-sequence an' a' that. 
  159.   SM does everything that I require it to do, but if the support is large 
  160.   enough I may continue to improve it. I'm also considering creating a new 
  161.   pogram based on SM, a kind of menu program that does not quit after 
  162.   selection, like MenuMaster but they are so many going around. 
  163.   I've got one idea on improving SM:
  164.   
  165.            - Display  of a witty catchphrase at the bottom of the menu.
  166.   
  167.   So if you want to this send me some witty/dirty/funny phrases, eg 
  168.   
  169.            "Never play leapfrog with a unicorn" 
  170.            
  171.   I can be conntacted at the following address :
  172.    
  173.    Lee Kindness
  174.    8 Craigmarn Rd.
  175.    Portlethen               - i've got no modem, no cash.
  176.    Aberdeen AB1 4QR
  177.    SCOTLAND
  178.            
  179.   Note if you want the current version of SM send me a disk and money to
  180.   cover return postage. On the disk you send, if you put some PD or some data 
  181.   on it eg Mod's, HAM-8's then I'll fill the disk I return. Any ideas about 
  182.   programs that _you_ want are also welcome.
  183.    
  184.   Thanks go out to :
  185.   
  186.         Nico François : for Reqtools
  187.         Stefan Becker : source for the excellent ToolManager, which was helpful
  188.         Stephan Fuhrmann : the idea for the filliping up of the window, 
  189.                            baritisation.
  190.         Adam Kindness : Suggestions
  191.         Commodore : Luckily they make better computers than they handle money.
  192.                     I'd really like an A3000 or A4000.
  193.         
  194.                                     
  195. History
  196.  
  197.         SM is written in HighSpeed Pascal on an Amiga A1200 120MBHD ParNETed to
  198.   an A600 SD.
  199.   Source is included with this distribution.
  200.   
  201.    o v1.00 : 5.2.94
  202.            - first public release
  203.            - uses ASL/Reqtools requesters
  204.            - Font sensitive
  205.            - SMPrefs opens on frontmost public screen
  206.            - Works!
  207.           \ /
  208.            X Memory loss of 1216 bytes by SMPrefs - help!
  209.           / \