home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 3 / CDPDIII.bin / fish / 831-840 / ff839 / lazybench / lazybench2.0.doc < prev    next >
Text File  |  1993-03-13  |  12KB  |  277 lines
  1. Distribution
  2.  
  3.      In  a  nutshell,  LazyBench is  a copyrighted  product  and all  the
  4.      rights  are reserved to Werther 'Mircko' Pirani (referred to as "the
  5.      Author")  but it may be freely distributed as  long as the following
  6.      restrictions are met:
  7.      The  distributor may only charge a fee up to the cost of obtaining a
  8.      public domain disk from a PD Library.
  9.      The  distributor agrees  to cease distributing  the program  and any
  10.      data involved if requested to do so by the author.
  11.      The  distributor  may  only distribute  an  unmodified  copy of  the
  12.      original  program,  with all  supplied  documentation and  copyright
  13.      notices intact.  Fore more details read the file "License.doc".
  14.  
  15.      The original distribution includes:
  16.  
  17.           LazyBench1.3.doc          9257 bytes (the document for OS 1.3)
  18.           LazyBench1.3.doc.info      745 bytes (its icon)
  19.           LazyBench1.3             15048 bytes (LazyBench for OS 1.3)
  20.           LazyBench1.3.info          454 bytes (its icon)
  21.           LazyBench2.0.doc         11965 bytes (this document)
  22.           Lazybench2.0.doc.info      745 bytes (its icon)
  23.           LazyBench2.0             19576 bytes (LazyBench for OS 2.xx)
  24.           LazyBench2.0.info          500 bytes (its icon)
  25.           License.doc               7811 bytes (legal stuff)
  26.           License.doc.info           745 bytes (its icon)
  27.  
  28.      If  one or more of the above are missing,  then your distribution is
  29.      incomplete:  please, discard  it immediately and  check it  out with
  30.      your  favorite BBS or get in touch with me for a complete and *REAL*
  31.      distribution. For more details read the chapter "Feedback".
  32.  
  33.  
  34.  
  35. Introduction
  36.  
  37.      LazyBench  is a  little utility  for lazy people  with an  hard disk
  38.      crammed  full of  goodies which are  too difficult to  reach because
  39.      they  are  buried  away in  drawers  inside  drawers inside  drawers
  40.      inside drawers... I could go on and on but... I'm too lazy!
  41.  
  42.      Laziness  apart, LazyBench adds an item  under the Workbench "Tools"
  43.      menu,  installs  itself  as a  commodity and  quietly  waits in  the
  44.      background.  From now on, when you need to launch an application you
  45.      can  use its  hot key  combination (or  select the  item 'LazyBench'
  46.      from  the "Tools" menu) to open a window and  pick up an application
  47.      from  a list of up  to 100  of your  favorite applications (tools or
  48.      projects) without having to reorganize the Workbench!
  49.  
  50.      Such  utilities are  usually known  as "hard  disk menus"  and while
  51.      LazyBench  is by no means  the only one or  the best available, it's
  52.      tiny  enough (just 19576 bytes)  to fit even in  the most crowded of
  53.      the  hard disks. Furthermore, it's  dead easy to configure  even for
  54.      the laziest person in the world!
  55.  
  56.  
  57.  
  58. LazyBench and Kickstart 2.xx
  59.  
  60.      This  is the documentation about LazyBench for the Amiga OS 2.xx and
  61.      (hopefully)  above.   Read the file LazyBench1.3.doc  and be sure to
  62.      install LazyBench1.3 if you are running OS 1.3.
  63.  
  64.  
  65.  
  66. Installing LazyBench
  67.  
  68.      1) Drag the LazyBench icon  in the  WBStartup drawer.  From the next
  69.      reboot LazyBench will be ready for you.
  70.       
  71.      2) Click   once  on  the   LazyBench  icon   and  select   the  item
  72.      'Information...'  from the Workbench "Icons" menu  (or use the Right
  73.      Amiga  - I keyboard equivalent) to edit the  Tool Types according to
  74.      your personal needs and tastes.
  75.      Like  any other  commodity, LazyBench recognizes the  following Tool
  76.      Types:
  77.  
  78.      CX_POPUP (default: CX_POPUP=NO)
  79.         Use CX_POPUP=YES if you want LazyBench to open its window when it
  80.         is first launched.
  81.  
  82.      CX_POPKEY (default: CX_POPKEY=ralt help)
  83.         These are  the keys  to use as  a hot key  to make  the LazyBench
  84.         window appear.   By default the  combination is Right Alt - Help.
  85.         Choose  this  one carefully  to  avoid  any conflict  with  other
  86.         commodities and applications (this hot key is *always* active, no
  87.         matter  which  screen is  the  frontmost  one). Please  read  the
  88.         chapter about  commodities in  your "Using  The System  Software"
  89.         manual.
  90.         
  91.      CX_PRI (default: CX_PRI=0)
  92.         You can set the LazyBench priority by entering a number from -128
  93.         to 127 but I'd stick with 0 if I were you...
  94.  
  95.      Furthermore,  don't forget to  specify the Tool Type  'DONOTWAIT' or
  96.      the Workbench won't be able to close the original shell.
  97.  
  98.  
  99.  
  100. Configuring LazyBench
  101.  
  102.      Create  a file  called 'LazyMenu'  in the  s: directory.  This is  a
  103.      plain   text  file,  so  you  can  use  the  editor  you  feel  more
  104.      comfortable  with, from the humble  Ed to a powerful  word processor
  105.      with  all the bell and  whistles. LazyBench reads this  file to know
  106.      about  the applications (tools or  projects) you would like  to have
  107.      handy  without  messing  the  Workbench  screen  with lots  of  open
  108.      drawers and windows.
  109.  
  110.      Each   line  in  this  text  file  is  the  full  pathname  for  the
  111.      application  (tool or project) you'll want to use  and each line can
  112.      be up to 256 characters in length:
  113.  
  114.           SYS:Utilities/Clock
  115.           SYS:Tools/Calculator
  116.           SYS:Work/WriteStuff/WordProcessors/ProWrite
  117.           SYS:Work/NComm/NComm
  118.           SYS:Work/Games/Amoeba Invaders
  119.  
  120.      Please  note the  space within the last  line. If a directory  or an
  121.      application  name contains  spaces you  *don't* have  to use  double
  122.      quotes,  just type  the full  pathname as  above. Of  course in  the
  123.      LazyBench  ListView you'll see  just the application names,  not the
  124.      full  pathnames, so  in this  case you'll  see items  named "Clock",
  125.      "Calculator",  "ProWrite",  "NComm"  and  "Amoeba  Invaders".  Don't
  126.      forget  that you can have  up to a maximum  of 100 items  to pick up
  127.      from the  LazyBench ListView, so extra lines in  the 'LazyMenu' file
  128.      will simply be ignored.
  129.  
  130.      Please also note that you could also use a line of the type:
  131.  
  132.           SYS:Work/WriteStuff/Documents/Letter
  133.  
  134.      where  "Letter" it's not an  application (a tool) but  a document (a
  135.      project)  and choosing  the item named  "Letter" from  the LazyBench
  136.      ListView  would  start  the word  processor  used  to write  such  a
  137.      document   and  load  the  file  named  "Letter".  Since  most  word
  138.      processors,   desktop  publishers  and  paint  programs  save  their
  139.      settings  with the document, you  can start an application  and load
  140.      its   preferences  just  by  picking  an  item  from  the  LazyBench
  141.      ListView. Neat, eh?
  142.  
  143.  
  144.  
  145. Activating LazyBench
  146.  
  147.      Like  any other commodity LazyBench sits in the background and waits
  148.      to be activated by:
  149.  
  150.      1)  A hot key combination.  No matter which screen  is the frontmost
  151.      one,  the hot key combination causes the Workbench screen to come to
  152.      the foreground and the LazyBench window to open.
  153.      The  default is the combination "Right Alt - Help"  (press the right
  154.      Alt  key, hold it down  and press the Help key) but  you are free to
  155.      pick  up the one you prefer. Read the discussion about the CX_POPKEY
  156.      Tool Type in the chapter "Installing LazyBench" above.
  157.  
  158.      2)  Selecting the item 'LazyBench' from  the Workbench "Tools" menu.
  159.      This is handy if the Workbench screen is already on the foreground.
  160.  
  161.      3)  Launching  the 'Exchange' commodity  and clicking on the  gadget
  162.      labelled  'Show'. This one is pretty awkward, I  know, but  this for
  163.      your information only!
  164.  
  165.  
  166.  
  167. Using LazyBench
  168.  
  169.      Every  time you activate LazyBench you are  presented with a window,
  170.      a  ListView and  a bunch  of gadgets  labelled 'About...',  'Start',
  171.      'Reload   List',  'Hide'  and  'Quit'.   All  these  gadgets  except
  172.      'About...'  and 'Start'  can be also  selected from  the 'LazyBench'
  173.      menu.  If  so the  Right  Amiga -  key equivalent  is  given in  the
  174.      discussion below.
  175.  
  176.      The ListView
  177.         The ListView is much like  a regular file requester but this time
  178.         the items displayed are the  applications (tools or projects) you
  179.         can launch  from LazyBench and  not files within a  directory. As
  180.         any other regular file requester  you can click on the arrows and
  181.         drag or  click the slider  to scroll  the items. The name  of the
  182.         currently selected  application and the  number of   applications
  183.         launched by LazyBench are displayed underneath the ListView.
  184.         The simplest  and quickest  way to launch  and application  is to
  185.         double click on a ListView item.
  186.  
  187.      'About...' gadget
  188.         For your information only... and a bit for my ego too!
  189.  
  190.      'Start' gadget
  191.         Another way to launch and application. Click once on the ListView
  192.         to select an  item and click on the 'Start'  gadget. Handy if you
  193.         have an old or a hyper responsive mouse...
  194.  
  195.      'Reload List' gadget (Right Amiga - L)
  196.         If you  add/remove applications to/from  the 'LazyMenu'  file you
  197.         don't have to  quit LazyBench to update  the ListView. Just click
  198.         on this  gadget to close the  window, reload the file  and reopen
  199.         the window.
  200.  
  201.      'Hide' gadget (Right Amiga - H)
  202.         To closes the  window (same as clicking on  the close gadget) and
  203.         to  let LazyBench  running in  the  background. Use  the hot  key
  204.         combination or select 'LazyBench' from the Workbench "Tools" menu
  205.         to reopen the window.
  206.  
  207.      'Quit' gadget (Right Amiga - Q)
  208.         The only way to quit/kill  LazyBench. Please note that you cannot
  209.         quit while applications launched by LazyBench are still running.
  210.         Same as clicking on the 'Exchange' commodity 'Kill' gadget.
  211.  
  212.  
  213.  
  214. Quick Troubleshooting Guide
  215.  
  216.      Due   to   its   simplicity,  LazyBench   doesn't   really  need   a
  217.      troubleshooting  guide. Anyway, if one or more  items are present in
  218.      the  'LazyMenu' file  but are missing  from the  LazyBench ListView,
  219.      you  may have to check  the 'LazyMenu' file in  the s: directory for
  220.      one of the following:
  221.  
  222.      1)  You've made a typo or you have got  the pathname for one or more
  223.      of the applications wrong;
  224.  
  225.      2)  The pathname is correct but the application it's neither a tool,
  226.      nor a project. A directory perhaps?!?
  227.  
  228.      3)  The pathname is right and the application is  really a tool or a
  229.      project  but  has  no icon.  Since  LazyBench is made  to launch  an
  230.      application  without  having  to double-click  on  its icon,  you're
  231.      definitely  out of luck. How can you  double-click on something with
  232.      no icon at all?!?
  233.  
  234.      Furthermore,  if LazyBench  quits with  the message  "Cannot install
  235.      LazyBench  as a commodity" either  you've entered a hot  key used by
  236.      another  commodity  or you've  entered  an illegal  hot key.  Please
  237.      check  the  CX_POPKEY  Tool Type  and  refer  to the  chapter  about
  238.      commodities in your "Using The System Software" manual.
  239.  
  240.  
  241.  
  242. Feedback
  243.  
  244.      LazyBench  is freely distributable and so I'm  not asking for money.
  245.      Anyway,  if you  are using LazyBench I'd  like very much to  hear it
  246.      from   you.  Suggestions,   bug  reports,  positive   criticism  and
  247.      contributions are welcomed at the following addresses:
  248.  
  249.           internet:   werther@karunko.nervous.com
  250.           fidonet:    2:335/602.12 (Mirko Pirani)
  251.           amiganet:   39:102/1.12  (Mirko Pirani)
  252.  
  253.      If  all else  fails you can  always reach me  by snail mail  (even a
  254.      simple postcard would be fine):
  255.  
  256.           Werther 'Mircko' Pirani
  257.           Via Mario Torresi, 74
  258.           60128 Ancona
  259.           ITALY
  260.  
  261.  
  262.  
  263. Dedicated to
  264.  
  265.       Mila, Yaya, Tina and Biba. You are always with me.
  266.  
  267.       Steve B. from Bernardones. Look out for their "19  BON BUSTE" demo-
  268.       tape: punk'n'roll at its best!!!
  269.  
  270.  
  271.  
  272.  
  273.  
  274.       February 28, 1993
  275.  
  276.       Werther 'Mircko' Pirani
  277.