home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 52 / af052sub.adf / Lazybench.lha / LazyBench / LazyBench2.0.doc < prev    next >
Text File  |  1993-06-26  |  17KB  |  385 lines
  1. Distribution
  2.  
  3.      Briefly,  LazyBench is a copyrighted product and  all the rights are
  4.      reserved  to Werther 'Mircko' Pirani (referred  to as "the Author").
  5.      Nonetheless,  LazyBench may  be freely  distributed as  long as  the
  6.      following restrictions are met:
  7.      -  The distributor may only charge a fee up to the cost of obtaining
  8.      a 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. Read the file "License.doc" for more details.
  14.  
  15.      The original distribution includes:
  16.  
  17.           LazyBench1.3.doc          9279 bytes (the document for OS 1.3)
  18.           LazyBench1.3.doc.info      745 bytes (its icon)
  19.           LazyBench1.3             14172 bytes (LazyBench for OS 1.3)
  20.           LazyBench1.3.info          454 bytes (its icon)
  21.           LazyBench2.0.doc         17181 bytes (this document)
  22.           Lazybench2.0.doc.info      745 bytes (its icon)
  23.           LazyBench2.0             16692 bytes (LazyBench for OS 2.xx)
  24.           LazyBench2.0.info          500 bytes (its icon)
  25.           License.doc               7897 bytes (legal stuff)
  26.           License.doc.info           745 bytes (its icon)
  27.  
  28.      If  one or more of  the above is missing,  then your distribution is
  29.      incomplete:  please, dump it immediately and check  it out with your
  30.      favourite  BBS or PD Library. If all else fails,  you can try to get
  31.      in  touch  with me  for a  complete distribution.  Read the  chapter
  32.      "Feedback" for more details.
  33.  
  34.  
  35.  
  36. LazyBench and Kickstart 2.xx
  37.  
  38.      This  is the documentation about LazyBench for the Amiga OS 2.xx and
  39.      above.  Read  the file  "LazyBench1.3.doc"  and be  sure to  install
  40.      LazyBench1.3 if you are running OS 1.3.
  41.  
  42.  
  43.  
  44. Introduction
  45.  
  46.      LazyBench  is a  little utility  for lazy  people with  a hard  disk
  47.      crammed  full of goodies, which  are too difficult to  reach because
  48.      they  are  buried  away in  drawers  inside  drawers inside  drawers
  49.      inside drawers ... I could go on and on but ... I'm too lazy!
  50.  
  51.      Laziness  aside, LazyBench adds an item  under the Workbench "Tools"
  52.      menu,  installs  itself  as a  commodity and  quietly  waits in  the
  53.      background.  From now  on, you can  use its hot key  combination (or
  54.      select  the item 'LazyBench' from the "Tools" menu) to open a window
  55.      and  pick  up  an  application  from  an  *unlimited* list  of  your
  56.      favourite   applications  (tools  or  projects)  without  having  to
  57.      reorganize the Workbench!
  58.  
  59.      Such  utilities  are  usually called  "hard  disk  menus" and  while
  60.      LazyBench  is neither  the only  one, nor  the best  available, it's
  61.      tiny  enough (just 15824 bytes)  to fit even in  the most crowded of
  62.      the  hard disks.  Furthermore, it's easy  to configure even  for the
  63.      laziest person in the world!
  64.  
  65.  
  66.  
  67. Installing LazyBench
  68.  
  69.      1) Drag the LazyBench icon in the WBStartup drawer.
  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 deals  with these standard Tool
  76.      Types:
  77.  
  78.      CX_POPUP (internal default: CX_POPUP=NO)
  79.         Use CX_POPUP=YES if you want LazyBench to open its window as soon
  80.         as it's launched.
  81.  
  82.      CX_POPKEY (internal default: CX_POPKEY=ralt help)
  83.         This  is the  hot key  to make  the LazyBench  window appear.  By
  84.         default the  combination is  Right Alt  - Help.  Choose this  one
  85.         carefully  to  avoid  any conflict  with  other  commodities  and
  86.         applications (remember that  this hot key is  *always* active, no
  87.         matter which screen is in  the foreground). Please, refer to your
  88.         "Using The  System Software"  manual and  read the  chapter about
  89.         commodities for more details.
  90.  
  91.      CX_PRI (internal default: CX_PRI=0)
  92.         You can  set the LazyBench priority  by entering a number  in the
  93.         range from -128 to 127 but you'd better stick with a value of 0.
  94.  
  95.      Furthermore, you may want to use these extra Tool Types:
  96.  
  97.      REMEMBER (internal default: NOREMEMBER)
  98.         By default LazyBench opens its window in the upper left corner of
  99.         the Workbench screen,  but you can use the  Tool Type REMEMBER to
  100.         make LazyBench "remember" its last position. That is, you can pop
  101.         up its window, drag it where you want and close it: from the next
  102.         time the LazyBench window will pop up there.
  103.  
  104.      AUTOHIDE (internal default: NOAUTOHIDE)
  105.         By default  when you launch  an application the  LazyBench window
  106.         stays open and  it's up to you close it when  you're done. On the
  107.         other hand, you can use  the Tool Type AUTOHIDE to make LazyBench
  108.         automatically  close  its  window  as  soon  as  it  launches  an
  109.         application.
  110.  
  111.      EDITOR (internal default: EDITOR=C:Ed)
  112.         LazyBench can invoke the editor of your choice, so you can add or
  113.         remove items from the "LazyMenu" file with no efforts at all. Use
  114.         a string like:
  115.  
  116.           EDITOR=SYS:Tools/Memacs
  117.  
  118.         to  choose the  editor you  feel  more comfortable  with and  let
  119.         LazyBench do all the rest.
  120.      DONOTWAIT (system default: WAIT)
  121.         If you  start LazyBench at  boot time  and you neglect  to insert
  122.         this Tool Type, the Workbench won't be able to close the original
  123.         shell and  will ask  you if you  want to wait  some more:  just a
  124.         minor annoyance...
  125.  
  126.  
  127.  
  128. Configuring LazyBench
  129.  
  130.      Create  a file  called "LazyMenu"  in the  S: directory.  This is  a
  131.      plain   text  file,  so  you  can  use  the  editor  you  feel  more
  132.      comfortable  with, from the humble  Ed to a word  processor with all
  133.      the  bells and whistles. LazyBench reads this file to know about the
  134.      applications  (tools  or  projects) you  would  like  to have  handy
  135.      without  messing the  Workbench screen  with many  open drawers  and
  136.      windows.
  137.  
  138.      Actually,  you can  use LazyBench itself  to edit this file.  If you
  139.      start  LazyBench with  no "LazyMenu"  file in  the S:  directory, it
  140.      asks  you if  you want to create  one. Clicking on the  'Yes' gadget
  141.      will  start the editor. Read  the  discussion about  the EDITOR Tool
  142.      Type in the chapter "Installing LazyBench" for more details.
  143.  
  144.      Each   line  in  this  text  file  is  the  full  pathname  for  the
  145.      application  you want LazyBench to launch and each line can be up to
  146.      256 characters in length:
  147.  
  148.           SYS:Utilities/Clock
  149.           SYS:Tools/Calculator
  150.           SYS:Work/FinalCopy_II/FinalCopy_II
  151.           SYS:Work/NComm/NCommSYS:Work/Games/Amoeba Invaders
  152.  
  153.      Please  note the space within the last line: when  a directory or an
  154.      application  name contains  spaces you  *don't* have  to use  double
  155.      quotes,  just type  the full  pathname as  above. Of  course in  the
  156.      LazyBench  ListView you'll see  just the applications name,  not the
  157.      full  pathnames, so  in this  case you'll  see items  named "Clock",
  158.      "Calculator", "FinalCopy_II", "NComm" and "Amoeba Invaders".
  159.      Please  note that  the only  limit is the  memory available  in your
  160.      system,  so you can have an unlimited  number of applications listed
  161.      in the "LazyMenu" file.
  162.  
  163.      Please also note that you can also use a line of the type:
  164.  
  165.           SYS:Work/WriteStuff/Documents/Letter
  166.  
  167.      where  "Letter" it's not an  application (a tool) but  a document (a
  168.      project)  and choosing  the item named  "Letter" from  the LazyBench
  169.      ListView  would  start  the word  processor  used  to write  such  a
  170.      document   and  load  the  file  named  "Letter".  Since  most  word
  171.      processors,   desktop  publishers  and  paint  programs  save  their
  172.      settings  along with the document, you can  start an application and
  173.      load  its preferences  just by  picking an  item from  the LazyBench
  174.      ListView. Neat, isn't it?
  175.  
  176.  
  177.  
  178. Activating LazyBench
  179.  
  180.      LazyBench sits in the background and waits to be activated by:
  181.  
  182.      1)  Its  hot  key combination.  No  matter which  screen  is in  the
  183.      foreground,  the hot key combination causes  the Workbench screen to
  184.      come  to  the  foreground and  the  LazyBench  window to  open.  The
  185.      default  is the combination "Right Alt - Help"  (press the Right Alt
  186.      key,  hold it down and press the Help key)  but you are free to pick
  187.      up  the one you prefer. Read the discussion about the CX_POPKEY Tool
  188.      Type in the chapter "Installing LazyBench" for more details.
  189.  
  190.      2)  Selecting the item 'LazyBench' from  the Workbench "Tools" menu.
  191.      This is handy if the Workbench screen is already in the foreground.
  192.  
  193.      3)  Launching  the  Exchange  commodity,  selecting the  item  named
  194.      'LazyBench'  and clicking on the gadget labelled 'Show'. This one is
  195.      pretty awkward, I know, but it's just to let you know!
  196.  
  197.  
  198.  
  199. Using LazyBench
  200.  
  201.      When  you  start  LazyBench  you  are  presented  with a  window,  a
  202.      ListView  and  a  group  of  gadgets labelled  'About...',  'Start',
  203.      'Reload  List', 'Hide'  and 'Quit'.  All these  gadgets can  also be
  204.      selected  from  the  "LazyBench" menu,  so  the  Right Amiga  -  key
  205.      equivalent is given in the discussion below.
  206.  
  207.      The ListView
  208.         The ListView is much like  a regular file requester but this time
  209.         the items displayed are the  applications (tools or projects) you
  210.         can launch  from LazyBench and  not files within a  directory. As
  211.         any other regular file requester  you can click on the arrows and
  212.         drag  or  click  the slider  to  scroll  the items.  The  current
  213.         selection and  the number  of   applications launched  so far  by
  214.         LazyBench  are  displayed  just   underneath  the  ListView.  The
  215.         simplest and quickest way to  launch an application is to double-
  216.         click on a ListView item.
  217.  
  218.      'About...' (Right Amiga - A)
  219.         Okay, I'm a bit egocentric! :)
  220.  
  221.      'Start' (Right Amiga - S)
  222.         Another way to launch an  application. Click once on the ListView
  223.         to select  an item and then  click on the 'Start'  gadget. Please
  224.         note that both  the 'Start' gadget and the  'Start' item from the
  225.         "LazyBench" menu  are ghosted (you  can't select them)  until you
  226.         click at least once on a ListView item.
  227.  
  228.      'Edit List' (Right Amiga - E)
  229.         When  you need  to  add or  remove applications  to  or from  the
  230.         "LazyMenu"  file in  the S:  directory,  you don't  have to  quit
  231.         LazyBench to  update the ListView.  Just click on this  gadget to
  232.         invoke your  editor, then edit  the file and let  LazyBench close
  233.         the window, reload the file  and reopen the window, thus updating
  234.         the ListView. Pheew!!!
  235.  
  236.      'Hide' (Right Amiga - H)
  237.         Click on this gadget to close the window (same as clicking on the
  238.         close  gadget in  the upper  left  corner) and  to let  LazyBench
  239.         running in the background. Use  its hot key combination or select
  240.         'LazyBench' from  the Workbench "Tools"  menu to make  the window
  241.         pop up again.
  242.  
  243.      'Quit' (Right Amiga - Q)
  244.         The only way to quit LazyBench. Please note that  both the 'Quit'
  245.         gadget and the 'Quit' item  from the "LazyBench" menu are ghosted
  246.         (you can't click  on them) until there  are applications launched
  247.         by LazyBench.
  248.  
  249.  
  250.  
  251. Quick Troubleshooting Guide
  252.  
  253.      Due   to   its   simplicity,  LazyBench   doesn't   really  need   a
  254.      troubleshooting  guide. Anyway, if one or more  items are present in
  255.      the  "LazyMenu" file  but are missing  from the  LazyBench ListView,
  256.      you may want to look for one of the following:
  257.  
  258.      1)  Either you've  made a typo or  you have gotten the  pathname for
  259.      one or more of the applications wrong;
  260.  
  261.      2)  The pathname is correct but the application it's neither a tool,
  262.      nor a project. A directory perhaps?!?
  263.  
  264.      3)  The pathname is right and the application is  really a tool or a
  265.      project  but has  no icon. Since  LazyBench purpose is to  launch an
  266.      application  without  having  to double-click  on  its icon,  you're
  267.      definitely  out of luck. How can you  double-click on something with
  268.      no icon at all?!?
  269.  
  270.      Furthermore,  if LazyBench  quits with  the message  "Cannot install
  271.      LazyBench  as a commodity" either  you've entered a hot  key used by
  272.      another  commodity  or you've  entered  an illegal  hot key.  Please
  273.      check  the CX_POPKEY Tool Type  and refer to your  "Using The System
  274.      Software" manual.
  275.  
  276.  
  277.  
  278. LazyBench History
  279.  
  280.      V1.00: February 28, 1993
  281.         - First ever public release.
  282.  
  283.      V1.01: March 7, 1993
  284.         -  Memory  is now  dynamically  allocated  and the  benefits  are
  285.         twofold:
  286.         1) LazyBench uses just the memory it needs, depending on how many
  287.         items a user  wants to display in the  LazyBench ListView and not
  288.         assuming there are 100 of them.
  289.         2) The limit  of up to 100  applications in the ListView  is gone
  290.         and the only limit is the memory available!
  291.  
  292.      V1.02: March 11, 1993
  293.         - The  'Start'  gadget  is  ghosted  until  there  is  a  current
  294.         selection and becomes ghosted again as soon as the application is
  295.         launched. That  is, to use the  'Start' gadget first you  have to
  296.         select an item from the ListView.
  297.         - The 'Quit'  gadget and the 'Quit' item  in the "LazyBench" menu
  298.         become both  ghosted as  soon as  there is  at least  a LazyBench
  299.         launched application: that is, you cannot quit while applications
  300.         started by LazyBench are still running.
  301.         - Added support for the "version" string: the user can tell which
  302.         revision he owns  without starting LazyBench, but  just by typing
  303.         in the Shell window:
  304.  
  305.           version SYS:WBStartup/LazyBench FULL
  306.  
  307.         - Now LazyBench  asks for version 36 (the one  in the Amiga 3000)
  308.         of the libraries  needed, so Amiga 3000  owners should experience
  309.         no problem at all. Sorry: I forgot you!
  310.  
  311.      V1.03: March 14, 1993
  312.         - Rearranged the items in the "LazyBench" menu.
  313.         - Workbench  virtual screens  (screens bigger  than the  physical
  314.         screen)  now are  properly  supported  and the  LazyBench  window
  315.         always pops up in the  upper left corner of the (visible part of)
  316.         the Workbench screen.
  317.         - Added the keyword REMEMBER to the Tool Types: now LazyBench can
  318.         remember where it was placed  last time you closed its window. If
  319.         REMEMBER is not  set, LazyBench always pops up  its window in the
  320.         upper left corner of the (visible part of the) Workbench screen.
  321.  
  322.      V1.04: Apr 8, 1993
  323.         - Added the keyword AUTOHIDE to the Tool Types: now LazyBench can
  324.         automatically close its window after launching an application. If
  325.         AUTOHIDE is not  set, the LazyBench window  stays open. Thanks to
  326.         Bernie Cosell for this suggestion!
  327.         - Rearranged one more time the items in the "LazyBench" menu: now
  328.         all the  LazyBench gadgets (including  'Start') are  available as
  329.         menu items under the "LazyBench"  menu and have keyboard shortcut
  330.         equivalents.
  331.  
  332.      V1.05 - V1.09: Apr, May and June 1993
  333.         -  Just  minor  "internal"  revisions   not  worth  a  standalone
  334.         distribution.
  335.  
  336.      V1.10: June 25, 1993
  337.         - Added the  keyword EDITOR to the Tool  Types: now LazyBench can
  338.         invoke the editor  of your choice to edit  the "LazyMenu" file in
  339.         the  S:  directory  with no  efforts  at  all. Thanks  to  Daniel
  340.         Migueres for this suggestion!
  341.         - Added a couple of  requesters that pop up before any "critical"
  342.         operation.
  343.  
  344.  
  345.  
  346. Feedback
  347.  
  348.      LazyBench  is freely distributable and so I'm  not asking for money.
  349.      Anyway,  if you  are using LazyBench I'd  like very much to  hear it
  350.      from   you.  Suggestions,   bug  reports,  positive   criticism  and
  351.      contributions are welcomed at the following addresses:
  352.  
  353.           internet:   werther@karunko.nervous.com
  354.           fidonet:    2:335/602.12 (Mirko Pirani)
  355.           amiganet:   39:102/1.12  (Mirko Pirani)
  356.  
  357.      If  all else  fails you can  always reach me  by snail mail  (even a
  358.      simple postcard will do):
  359.  
  360.           Werther 'Mircko' Pirani
  361.           Via Mario Torresi, 74
  362.           60128 Ancona
  363.           ITALY
  364.  
  365.  
  366.  
  367. Dedicated to
  368.  
  369.      Mila, Yaya, Tina, and Biba: Wish you were here.
  370.  
  371.      Betty: You really make my day!
  372.  
  373.      Steve  B.  from  Bernardones. Look  out  for  their "19  BON  BUSTE"
  374.      demotape: punk'n'roll at its best!!!
  375.  
  376.      Anyone who has taken the time to get in touch with me. Thanks!
  377.  
  378.  
  379.  
  380.  
  381.  
  382.      June 26, 1993
  383.  
  384.      Werther 'Mircko' Pirani
  385.