home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 2 / FFMCD02.bin / new / amigalibdisks / disk938 / turboleusch / turbo.engldoc < prev    next >
Encoding:
Text File  |  1993-12-21  |  6.5 KB  |  172 lines
  1.                                                  (c) 1993 by Thomas Hölle
  2.  
  3.                DOCUMENTATION OF TURBO-LEUSCHNER
  4.  
  5.  
  6. ATTENTION :   This is a Sharewareprogram. The  author  raises a
  7.   registration charge of about 20DM for the use of the program.
  8.   Sending this money to the following address, FREE  OF  CHARGE
  9.   the registrated user will get a version of  "Turbo-Leuschner"
  10.   which won't contain any "advertisement".
  11.  
  12.      The address is :
  13.  
  14.           Thomas Hölle
  15.           in den Steinäckern 10
  16.  
  17.          63517  Rodenbach 1  (Germany)
  18.  
  19.   THANK YOU VERY MUCH !!!!!!!
  20.  
  21.  
  22.  
  23.  
  24.  
  25.              HOW TO USE TURBO-LEUSCHNER
  26.  
  27.  
  28.   With the help of "Turbo-Leuschner" you are able to create your
  29.   own  menus comfortable  for Workbench-based  Windows or expand
  30.   already existing menus. Turbo-Leuschner supplies ALL functions
  31.   of the Workbench-Menu-System.
  32.  
  33.  
  34.   You call "Turbo-Leuschner" with two  parameters  and the  DOS-
  35.   command "run" :
  36.  
  37.  
  38.      run TurboLeuschner WINDOW FILE
  39.  
  40.  
  41.   For the  correct  work  of "Turbo-Leuschner" the command "run"
  42.   must be placed in the directory "c:". ( Just if you work with
  43.   Kickstart 1.2/1.3 ).
  44.  
  45.  "WINDOW" represents  the name of the Window you want  to expand
  46.   with your own menus. ( e.g. "Workbench" for the  window of the
  47.   workbench or "AmigaShell" for your highest shell-window )  You
  48.   have  to take  care  with the spelling :  The  program differs
  49.   between small and capital letters.
  50.  
  51.   "FILE" is the name ( including path) of an  ASCII-Controlling-
  52.   File which contains the information for "Turbo-Leuschner".
  53.   
  54.  
  55.  
  56.   The Controlling-File constists  of  several  controlling-codes
  57.   ( e.g. the exclamation-mark "!") which are often followed by a
  58.   string. Only ONE controlling code in a line is  permitted. You
  59.   can create this file with  every  editor ( such as "MEMACS" or
  60.   "ED" ).
  61.   The specified controlling codes :
  62.  
  63.   The "!" is followed by the name of a new menu.
  64.   ( e.g.  "!Tools")
  65.  
  66.   The "$" if followed by the name of a new item. The item refers
  67.   to the last menu given before in the file.
  68.   ( e.g.  "$editors")
  69.  
  70.   The "&" if followed by the name of a new subitem, which refers
  71.   to the last given item.
  72.  
  73.   The ">" is  followed by  the name of a file, "Turbo-Leuschner"
  74.   shall execute  if the user choose the corresponding (sub)item.
  75.   ( This is the  name of the  item-/subitem in the line before.)
  76.  
  77. EXAMPLE :
  78.  
  79. !Tools            ( creates the menu "Tools" )
  80.   $editors        ( creates the 1st item "editors" in "tools" )
  81.     &Memacs       ( creates the 1st subitem "Memacs" of the item
  82.                     "editors" )
  83.      >sys:memacs  ( file to execute when selecting "Memacs" )
  84.     &Ed           ( creates the 2nd subitem "Ed" of "editors" )
  85.      >c:Ed        ( file to execute )
  86.   $Diskcopy       ( creates 2nd item "Diskcopy" of "tools" )
  87.    >dh0:Diskcopy  ( file to execute )
  88. !games            ( new menu "games" )
  89.  
  90.  
  91.   Except  for these  basic functions  "Turbo-Leuschner" supports
  92.   ALL the other features of the workbench menu-system :
  93.  
  94.   The "§" is followed by the name of a menu that already belongs
  95.   to the window and you want to  extend. ( The  computer differs
  96.   between small and capital letters.)
  97.  
  98.   The "-" is  followed  by a  single  letter.  "Turbo-Leuschner"
  99.   generates a "keyboard shortcut", which means that the user can
  100.   select this item/subitem also by  pressing the left  amiga key
  101.   and the key given after the "-".
  102.  
  103.   If there is a "C" in the line after a given item-/subitemname,
  104.   this item/subitem  will be  provided with a "checkmark symbol"
  105.   ( the hook ). This "hook" appears after the 1st,3rd,5th,7th...
  106.   selection of the item/subitem or  disappears after  every 2nd,
  107.   4th,6th,8th.. selection. If you  write a small "c", the "hook"
  108.   will be already  present at  the first  appearance of the menu
  109.   and will dissapear after every 1st,3rd,4th,.. selection of the
  110.   (sub)item. If you specify a "c" or "C", "Turbo-Leuschner" sup-
  111.   ports the execution of two different files.
  112.   The file to be called if the "hool" is visible has to be given
  113.   by a "<" ( followed by the name and the path of the file to be
  114.   executed ). The other file you specify normally by the ">".
  115.   When using the "checkmark symbol" you  always have  to specify
  116.   two execution files even if they are equal.
  117.   EXAMPLE :
  118.  
  119.     !tools
  120.        $Activate PC   ( item "Activate PC" in "tools )
  121.        C              ( "Activate PC" gets a "hook" which is vi-
  122.                         sible after every 1st,3rd,.. selection )
  123.        >PC/PCStart    ( program to be executed if the hook was
  124.                         not active (here: 1st,3rd,.. selection )
  125.        <PC/PCClose    ( program to be executed if the hook was
  126.                         active ( here :  2nd,4th,.. selection  )
  127.  
  128.  
  129. IN ORDER TO FINISH "TURBO-LEUSCHNER" :
  130.   "Turbo-Leuschner" will be finished after the  selection of the
  131.   close gadget  in the  window with  the "Turbo-Leuschner"-menu.
  132.   You can finish "Turbo-Leuschner" also by choosing the menuitem
  133.   "quit" which will be automatically added in every menu bar. In
  134.   both cases the window will continue zo be opened until you se-
  135.   lect the close gadget (again). But be carefull when  closing a
  136.   "shell" or "cli"-window by the command  "endshell" or "endcli"
  137.   while "Turbo-Leuschner" is already active. In these  cases you
  138.   have to finish "Turbo-Leuschner" before by selecting the  item
  139.   "quit".
  140.  
  141.  
  142. HINTS :  If you want to create your own menus for your own shell
  143.   windows it would be useful to place the needed  command in the
  144.   file "shell-startup" which  is in the  directory "s:". "Turbo-
  145.   Leuschner" will be activated after every new shell start.
  146.   You can also place the command for the expansion  of the work-
  147.   bench menu bar at the end of the "startup-sequence".
  148.  
  149.  
  150. ATTENTION :  This  program  supplies  ALL  versions of the Amiga
  151.   workbench system which are  available. But there  is a  little
  152.   restriction corncerning the  workbench versions  V2.x and V3.x
  153.   ( not for V1.2 and V1.3 ) :  You can't extend the menu "tools"
  154.   by using subitems, checkmarks or keyboard shortcuts ( Just ad-
  155.   ding items is possible ).
  156.   IF YOU  THINK  OF  RUNNING "TURBO-LEUSCHNER" ON A  NON-ENGLISH
  157.   WORKBENCH ( WHICH IS SUPPORTED  BY THE V2.1 AND V3.0 OR HIGHER
  158.   OF THE WORKBENCH SYSTEM ), AND  EXPANDING THE  WORKBENCH  MENU
  159.   "Tools" ("Hilfmittel" in Germany or whatever it may be..), YOU
  160.   HAVE TO SPECIFY THE NEW NAME OF THE  WORKBENCH-WINDOW  AND THE
  161.   NEW NAME OF THE MENU "Tools". THIS HAS TO HAPPEN AS FOLLOWS :
  162.     ":"New name of the workbench window
  163.     ";"New name of the menu tools.
  164.  
  165. EXAMPLE :
  166.   :Arbeitsbank
  167.   ;Hilfsprogramme
  168.  
  169.  
  170.   PLEASE REFER ALSO TO THE EXAMPLE FILE "Turbo.example" !!!!!!
  171.   
  172.