home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / programs / commodity / lazybench / lazybench.doc < prev    next >
Text File  |  1995-02-27  |  21KB  |  467 lines
  1. Distribution
  2.  
  3.      Briefly,  LazyBench is  a Freely  Distributable Copyrighted  product
  4.      whose  rights are reserved  to Werther 'Mircko' Pirani  (referred to
  5.      as "the Author").
  6.      LazyBench  may  be  freely  distributed  as  long as  the  following
  7.      restrictions are met:
  8.      -  The distributor may only charge a fee up to the cost of obtaining
  9.         a public domain disk from a PD Library.
  10.      -  The distributor agrees to cease distributing  the program and any
  11.         data involved if requested to do so by the Author.
  12.      -  The distributor  may only  distribute an  unmodified copy  of the
  13.         original program,  with all supplied documentation  and copyright
  14.         notices intact.
  15.      Read the file "License.doc" for more details.
  16.  
  17.      The original distribution includes:
  18.  
  19.           LazyBench.doc            21271 bytes (this document)
  20.           Lazybench.doc.info         745 bytes (its icon)
  21.           LazyBench                18116 bytes (LazyBench for OS 2.xx)
  22.           LazyBench.info             540 bytes (its icon)
  23.           License.doc               7608 bytes (legal stuff)
  24.           License.doc.info           745 bytes (its icon)
  25.  
  26.      If  one or more of  the above is missing,  then your distribution is
  27.      incomplete:  please, dump it immediately and check  it out with your
  28.      favourite  BBS or PD Library. If all else fails,  you can try to get
  29.      in  touch  with me  for a  complete distribution.  Read the  chapter
  30.      "Feedback" for more details.
  31.  
  32.  
  33.  
  34. LazyBench is Kickstart 2.xx and above only
  35.  
  36.      I'm  no longer developing and distributing LazyBench for pre OS 2.xx
  37.      Amigas  and so from now on all the new  archives circulating will be
  38.      Kickstart  2.xx only. Anyway, If you need  the simpler LazyBench for
  39.      OS  1.3  you can  find it  on Fish  Disk #  894, on  a Aminet  site,
  40.      perhaps on a BBS near you or directly from me.
  41.  
  42.  
  43.  
  44. LazyBench and MUI users
  45.  
  46.      Although  Stefan  Stuntz's  Magic  User  Interface is  causing  much
  47.      excitement  within  the Amiga  community,  LazyBench wants  to be  a
  48.      small  stand  alone application:  no custom  libraries, handlers  or
  49.      devices.  Also, is already font sensitive, Style Guide compliant and
  50.      fully configurable.
  51.      Nonetheless,  if you'd like LazyBench to support MUI, just drop me a
  52.      note  at one of the addresses listed in "Feedback". Perhaps the next
  53.      release could be MUI based, who knows? :-)
  54.  
  55.  
  56.  
  57. Introduction
  58.  
  59.      LazyBench  is a  little utility  for lazy  people with  a hard  disk
  60.      crammed  full of goodies, which  are too difficult to  reach because
  61.      they  are  buried  away in  drawers  inside  drawers inside  drawers
  62.      inside drawers ... I could go on and on but ... I'm too lazy! :-)
  63.  
  64.      Laziness  aside, LazyBench adds an item  under the Workbench "Tools"
  65.      menu,  installs  itself  as a  commodity and  quietly  waits in  the
  66.      background.  From now  on, you can  use its hot key  combination (or
  67.      select  the item 'LazyBench' from the "Tools" menu) to open a window
  68.      and   pick  up  an  application  from  a   list  of  your  favourite
  69.      applications  (tools or projects) without having to mess around with
  70.      the Workbench!
  71.  
  72.      Such  utilities  are  usually called  "hard  disk  menus" and  while
  73.      LazyBench  is neither  the only  one, nor  the best  available, it's
  74.      tiny  enough (just 18116 bytes)  to fit even in  the most crowded of
  75.      the  hard disks.  Furthermore, it's easy  to configure even  for the
  76.      laziest person in the world! :-)
  77.  
  78.  
  79.  
  80. Installing LazyBench
  81.  
  82.      1) Drag the LazyBench icon in the WBStartup drawer.
  83.  
  84.      2) Click   once  on  the   LazyBench  icon   and  select   the  item
  85.      'Information...'  from the Workbench "Icons" menu  (or use the Right
  86.      Amiga  - I keyboard equivalent) to edit the  Tool Types according to
  87.      your personal needs and tastes.
  88.      Like  any other commodity, LazyBench deals  with these standard Tool
  89.      Types:
  90.  
  91.      CX_POPUP (internal default: CX_POPUP=NO)
  92.         Use CX_POPUP=YES if you want LazyBench to open its window as soon
  93.         as it's launched.
  94.  
  95.      CX_POPKEY (internal default: CX_POPKEY=ralt help)
  96.         This  is the  hot key  to make  the LazyBench  window appear.  By
  97.         default the  combination is  Right Alt  - Help.  Choose this  one
  98.         carefully  to  avoid  any conflict  with  other  commodities  and
  99.         applications (remember  that this  hot key  is always  active, no
  100.         matter which screen is in  the foreground). Please, refer to your
  101.         "Using The  System Software"  manual and  read the  chapter about
  102.         commodities for more details.
  103.  
  104.      CX_PRI (internal default: CX_PRI=0)
  105.         You can  set the LazyBench priority  by entering a number  in the
  106.         range from -128 to 127 but you'd better stick with a value of 0.
  107.  
  108.      Furthermore, you may want to use these extra Tool Types:
  109.  
  110.      REMEMBER (internal default: NOREMEMBER)
  111.         By default LazyBench opens its window in the upper left corner of
  112.         the visible portion of the  Workbench screen, but you can use the
  113.         Tool  Type  REMEMBER  to  make   LazyBench  "remember"  its  last
  114.         position. That is,  you can pop up its window,  drag it where you
  115.         want and close  it: from the next time  the LazyBench window will
  116.         pop up there.
  117.  
  118.      AUTOHIDE (internal default: NOAUTOHIDE)
  119.         By default  when you launch  an application the  LazyBench window
  120.         stays open and  it's up to you  to close it when  you're done. On
  121.         the  other hand,  you  can use  the Tool  Type  AUTOHIDE to  make
  122.         LazyBench automatically close  its window as soon  as it launches
  123.         an application.
  124.  
  125.      EDITOR (internal default: EDITOR=C:Ed)
  126.         LazyBench can invoke the editor of your choice, so you can add or
  127.         remove items from its configuration  file with no efforts at all.
  128.         Use a string like:
  129.  
  130.           EDITOR=SYS:Tools/Memacs
  131.  
  132.         to  choose the  editor you  feel  more comfortable  with and  let
  133.         LazyBench take care about the rest.
  134.  
  135.      FONTSENSITIVE (Obsolete!)
  136.         LazyBench V1.14 is fully font sensitive and while LazyBench V1.12
  137.         used just the default Screen  font, now you're really spoiled for
  138.         choice:
  139.  
  140.         SYSTEMFONT (internal default: none)
  141.           LazyBench  will use whatever font you've  chosen as the default
  142.           System font.
  143.  
  144.         SCREENFONT (internal default: none)
  145.           If  you prefer a proportional font, LazyBench will use whatever
  146.           font you've chosen as the default Screen font.
  147.  
  148.         WBFONT (internal default: none)
  149.           Yet  another  occasion to  use a  proportional font:  LazyBench
  150.           will  use whatever font you've chosen  as the default Workbench
  151.           Icon font.
  152.  
  153.         Note: If  you don't  specify any of  these Tool  Types, LazyBench
  154.         will stick to the usual Topaz 8 font.
  155.  
  156.      ITEMS (internal default: ITEMS=10)
  157.         Now you can customize LazyBench  even more by specifying how many
  158.         items to display in the ListView at once.
  159.         Note: You can't  use a value smaller than 10.  On the other hand,
  160.         if this value  is too big the LazyBench window  won't feet on the
  161.         Workbench  screen and  will be  clipped  by the  OS. You've  been
  162.         warned!
  163.  
  164.      DONOTWAIT (system default: WAIT)
  165.         If you start  LazyBench at boot time and you  omit to insert this
  166.         Tool Type,  the Workbench  won't be  able to  close the  original
  167.         shell and  will ask  you if you  want to wait  some more:  just a
  168.         minor annoyance...
  169.  
  170.  
  171.  
  172. Configuring LazyBench
  173.  
  174.      Create  a file  called "LazyMenu"  in the  S: directory.  This is  a
  175.      plain   text  file,  so  you  can  use  the  editor  you  feel  more
  176.      comfortable  with, from the humble  Ed to a word  processor with all
  177.      the  bells and whistles. LazyBench reads this file to know about the
  178.      applications  (tools  or projects)  you  would like  to have  handy,
  179.      without  messing the  Workbench screen  with many  open drawers  and
  180.      windows.
  181.      Actually,  you can  use LazyBench itself  to edit this file.  If you
  182.      start  LazyBench with  no "LazyMenu"  file in  the S:  directory, it
  183.      asks  you if  you want to create  one. Clicking on the  'Yes' gadget
  184.      will  start the editor. Read  the  discussion about  the EDITOR Tool
  185.      Type in the chapter "Installing LazyBench" for more details.
  186.  
  187.      Each   line  in  this  text  file  is  the  full  pathname  for  the
  188.      application  you want LazyBench to launch and each line can be up to
  189.      256 characters in length:
  190.  
  191.           SYS:Utilities/Clock
  192.           SYS:Tools/Calculator
  193.           Work:FinalCopy_II/FinalCopy_II
  194.           Work:NComm/NCommSYS:Work/Games/Amoeba Invaders
  195.  
  196.      Please  note the space within the last line: when  a directory or an
  197.      application  name  contains  spaces you  don't  have  to use  double
  198.      quotes,  just type  the full  pathname as  above. Of  course in  the
  199.      LazyBench  ListView you'll see  just the applications name,  not the
  200.      full  pathnames, so  in this  case you'll  see items  named "Clock",
  201.      "Calculator", "FinalCopy_II", "NComm" and "Amoeba Invaders".
  202.      Please  note that  the only  limit is the  memory available  in your
  203.      system,  so you can have an unlimited  number of applications listed
  204.      in the "LazyMenu" file.
  205.  
  206.      Please also note that you can also use a line of the type:
  207.  
  208.           Work:WriteStuff/Documents/Letter
  209.  
  210.      where  "Letter" it's not an  application (a tool) but  a document (a
  211.      project)  and choosing  the item named  "Letter" from  the LazyBench
  212.      ListView  would  start  the word  processor  used  to write  such  a
  213.      document   and  load  the  file  named  "Letter".  Since  most  word
  214.      processors,   desktop  publishers  and  paint  programs  save  their
  215.      settings  along with the document, you can  start an application and
  216.      load  its preferences  just by  picking an  item from  the LazyBench
  217.      ListView. Neat, isn't it?
  218.  
  219.  
  220.  
  221. Activating LazyBench
  222.  
  223.      LazyBench sits in the background and you can activate it by:
  224.  
  225.      1)  Its  hot  key combination.  No  matter which  screen  is in  the
  226.      foreground,  the hot key combination causes  the Workbench screen to
  227.      come  to  the  foreground and  the  LazyBench  window to  open.  The
  228.      default  is the combination "Right Alt - Help"  (press the Right Alt
  229.      key,  hold it down and press the Help key)  but you are free to pick
  230.      up  the one you prefer. Read the discussion about the CX_POPKEY Tool
  231.      Type in the chapter "Installing LazyBench" for more details.
  232.  
  233.      2)  Selecting the item 'LazyBench' from  the Workbench "Tools" menu.
  234.      This is handy if the Workbench screen is already in the foreground.
  235.  
  236.      3)  Launching  the  Exchange  commodity,  selecting the  item  named
  237.      'LazyBench'  and clicking on the gadget labelled 'Show'. This one is
  238.      pretty awkward, I know, but it's just to let you know! :-)
  239.  
  240.  
  241. Using LazyBench
  242.  
  243.      When  you  start  LazyBench  you  are  presented  with a  window,  a
  244.      ListView  and a group of gadgets labelled 'About...', 'Start', 'Edit
  245.      List',  'Hide' and  'Quit'. All these  gadgets can also  be selected
  246.      from  the "LazyBench" menu,  with the Right  Amiga - key equivalent,
  247.      or with a quicker, more straightforward, single key equivalent.
  248.      Please  note that using the  latter method, the action  is performed
  249.      only  when you release the key so, should you change your mind, it's
  250.      possible  to  click  on  any  other  key  which has  no  meaning  to
  251.      LazyBench  (including Control, Shift,  Alt, Amiga and Caps Lock)  to
  252.      abort the operation.
  253.  
  254.      The ListView
  255.         The ListView is much like  a regular file requester but this time
  256.         the items displayed are the  applications (tools or projects) you
  257.         can launch  from LazyBench and  not files within a  directory. As
  258.         any other regular file requester, you can click on the arrows and
  259.         drag or  click the slider  to scroll the items.  Furthermore, you
  260.         can  use the  unshifted or  shifted up  and down  cursor keys  to
  261.         scroll the  ListView either  by one  item or by  one "page"  at a
  262.         time.  The current  selection  and the  number  of   applications
  263.         launched so  far by LazyBench  are displayed just  underneath the
  264.         ListView.
  265.         The simplest  and quickest  way to  launch an  application is  to
  266.         double-click on a ListView item or to press either the 'S' or the
  267.         ENTER key after you have selected an item.
  268.  
  269.      'About...' (Right Amiga - A) (A)
  270.         Okay, I'm a bit egocentric! :-)
  271.  
  272.      'Start' (Right Amiga - S) (S or ENTER)
  273.         Another way to launch an  application. Click once on the ListView
  274.         to select an item and then click on the 'Start' gadget or use the
  275.         cursor keys and then press  the 'S' or the ENTER key. Please note
  276.         that the 'S' and the ENTER keys are inactive and both the 'Start'
  277.         gadget  and  the 'Start'  items  from  the "LazyBench"  menu  are
  278.         ghosted (you  can't select them)  until you have not  selected an
  279.         item from the ListView.
  280.  
  281.      'Edit List' (Right Amiga - E) (E)
  282.         When  you need  to  add or  remove applications  to  or from  the
  283.         "LazyMenu"  file in  the S:  directory,  you don't  have to  quit
  284.         LazyBench to  update the ListView.  Just click on this  gadget or
  285.         press the 'E'  key to invoke your editor, then  edit the file and
  286.         let LazyBench  close the window,  reload the file and  reopen the
  287.         window, thus updating the ListView. Pheeew!!! :-)
  288.  
  289.      'Hide' (Right Amiga - H) (H)
  290.         Click on  this gadget or  press the  'H' key to close  the window
  291.         (same as clicking  on the close gadget in  the upper left corner)
  292.         and to let  LazyBench running in the background.  Use its hot key
  293.         combination or select 'LazyBench' from the Workbench "Tools" menu
  294.         to make its window pop up again.
  295.  
  296.      'Quit' (Right Amiga - Q) (Q)
  297.         The only way  to quit LazyBench. Please note that  the 'Q' key is
  298.         inactive and both the 'Quit' gadget and the 'Quit' items from the
  299.         "LazyBench"  menu are  ghosted (you  can't click  on them)  until
  300.         applications launched by LazyBench are still running.
  301.  
  302.  
  303.  
  304. Quick Troubleshooting Guide
  305.  
  306.      Due   to   its   simplicity,  LazyBench   doesn't   really  need   a
  307.      troubleshooting  guide. Anyway, if one or more  items are present in
  308.      the  "LazyMenu" file  but are missing  from the  LazyBench ListView,
  309.      you may want to look for one of the following:
  310.  
  311.      1)  Either you've  made a typo or  you have gotten the  pathname for
  312.      one or more of the applications wrong;
  313.  
  314.      2)  The pathname is correct but the application it's neither a tool,
  315.      nor a project. A directory perhaps?!?
  316.  
  317.      3)  The pathname is right and the application is  really a tool or a
  318.      project  but has  no icon. Since  LazyBench purpose is to  launch an
  319.      application  without  having  to double-click  on  its icon,  you're
  320.      definitely  out of luck. How can you  double-click on something with
  321.      no icon at all?!? :-)
  322.  
  323.      Furthermore,  if LazyBench  quits with  the message  "Cannot install
  324.      LazyBench  as a commodity" either  you've entered a hot  key used by
  325.      another  commodity  or you've  entered  an illegal  hot key.  Please
  326.      check  the CX_POPKEY Tool Type  and refer to your  "Using The System
  327.      Software" manual.
  328.  
  329.  
  330.  
  331. LazyBench History
  332.  
  333.      V1.00: February 28, 1993
  334.         - First ever public release.
  335.  
  336.      V1.01: March 7, 1993
  337.         -  Memory  is now  dynamically  allocated  and the  benefits  are
  338.         twofold:
  339.         1) LazyBench uses just the memory it needs, depending on how many
  340.         items a user  wants to display in the  LazyBench ListView and not
  341.         assuming there are 100 of them.
  342.         2) The limit  of up to 100  applications in the ListView  is gone
  343.         and the only limit is the memory available!
  344.  
  345.      V1.02: March 11, 1993
  346.         -  The  'Start'  gadget  is  ghosted until  there  is  a  current
  347.         selection and becomes ghosted again as soon as the application is
  348.         launched. That  is, to use the  'Start' gadget first you  have to
  349.         select an item from the ListView.
  350.         - The 'Quit'  gadget and the 'Quit' item  in the "LazyBench" menu
  351.         become both  ghosted as  soon as  there is  at least  a LazyBench
  352.         launched application: that is, you cannot quit while applications
  353.         started by LazyBench are still running.
  354.         - Added support for the "version" string: the user can tell which
  355.         revision he owns  without starting LazyBench, but  just by typing
  356.         in the Shell window:
  357.           version SYS:WBStartup/LazyBench FULL
  358.  
  359.         - Now LazyBench  asks for version 36 (the one  in the Amiga 3000)
  360.         of the libraries  needed, so Amiga 3000  owners should experience
  361.         no problem at all. Sorry: I forgot you!
  362.  
  363.      V1.03: March 14, 1993
  364.         - Rearranged the items in the "LazyBench" menu.
  365.         - Workbench  virtual screens  (screens bigger  than the  physical
  366.         screen)  now are  properly  supported  and the  LazyBench  window
  367.         always pops up in the  upper left corner of the (visible part of)
  368.         the Workbench screen.
  369.         - Added the keyword REMEMBER to the Tool Types: now LazyBench can
  370.         remember where it was placed  last time you closed its window. If
  371.         REMEMBER is not  set, LazyBench always pops up  its window in the
  372.         upper left corner of the (visible part of the) Workbench screen.
  373.  
  374.      V1.04: Apr 8, 1993
  375.         - Added the keyword AUTOHIDE to the Tool Types: now LazyBench can
  376.         automatically close its window after launching an application. If
  377.         AUTOHIDE is not  set, the LazyBench window  stays open. Thanks to
  378.         Bernie Cosell for this suggestion!
  379.         - Rearranged one more time the items in the "LazyBench" menu: now
  380.         all the  LazyBench gadgets (including  'Start') are  available as
  381.         menu items under the "LazyBench"  menu and have keyboard shortcut
  382.         equivalents.
  383.  
  384.      V1.05 - V1.09: Apr, May and June 1993
  385.         -  Just  minor  "internal"  revisions   not  worth  a  standalone
  386.         distribution.
  387.  
  388.      V1.10: June 25, 1993
  389.         - Added the  keyword EDITOR to the Tool  Types: now LazyBench can
  390.         invoke the editor  of your choice to edit  the "LazyMenu" file in
  391.         the  S:  directory  with no  efforts  at  all. Thanks  to  Daniel
  392.         Migueres for this suggestion!
  393.         - Added a couple of  requesters that pop up before any "critical"
  394.         operation.
  395.  
  396.      V1.11: September 4, 1993
  397.         - Added   the  keyword  FONTSENSITIVE  to  the  Tool  Types:  now
  398.         LazyBench can use  the font selected as  the default Screen font.
  399.         Omitting  this keyword  forces LazyBench  to stick  to the  usual
  400.         topaz 8 font.
  401.  
  402.      V1.12: October 10, 1993
  403.         - Now every   gadget as  a single  key equivalent  denoted by  an
  404.         underscore. Furthermore,  the cursor keys  can be used  to scroll
  405.         the ListView either by one  item or by one "page" at a time using
  406.         the shift keys.  The ENTER key can be used just  like the 'S' key
  407.         or  the   'Start'  gadget  to   launch  the   currently  selected
  408.         application, so  there's no really need for a mouse!
  409.  
  410.      V1.13: November 1993
  411.         - Another "internal" release.
  412.         - Fixed  a   minor  bug   that  caused  the  ListView  to  become
  413.         temporarily blank  if the  user pressed  either the  left or  the
  414.         right cursor;
  415.         - Improved single key equivalent handling;
  416.  
  417.      V1.14: December 23, 1993 - The Xmas release! :-)
  418.         - Removed the FONTSENSITIVE Tool Type;
  419.         - Added  more font  support with  the SYSTEMFONT,  SCREENFONT and
  420.         WBFONT Tool Types;
  421.         - Added  the ITEMS  Tool Type  to let the  user specify  how many
  422.         items to display in the ListView at once;
  423.         - Compiled with SAS 6.50!
  424.  
  425.  
  426.  
  427. Feedback
  428.  
  429.      LazyBench  is freely distributable and so I'm  not asking for money.
  430.      Anyway,  if you  are using LazyBench I'd  like very much to  hear it
  431.      from   you.  Suggestions,   bug  reports,  positive   criticism  and
  432.      contributions are welcomed at the following addresses:
  433.  
  434.           Internet:   werther@karunko.nervous.com
  435.           Fidonet:    2:335/602.12 (Mirko Pirani)
  436.           Amiganet:   39:102/1.12  (Mirko Pirani)
  437.  
  438.      If  all else  fails you can  always reach me  by snail mail  (even a
  439.      simple postcard will do):
  440.  
  441.           Werther 'Mircko' Pirani
  442.           Via Mario Torresi, 74
  443.           60128 Ancona
  444.           ITALY
  445.  
  446.  
  447.  
  448. Dedicated to
  449.  
  450.      Mila, Yaya, Tina, Biba, Betty and Laura: Merry Christmas.
  451.  
  452.      Rosanna:  The Woman in my life, the one who really loves me, the one
  453.      who really cares ... my mother! :-)
  454.  
  455.      Steve  B. from  Bernardones. Their brand  new "Mondo  Buzzurro" demo
  456.      tape is due real soon now.
  457.  
  458.      Anyone who has taken the time to get in touch with me. Thanks!
  459.  
  460.  
  461.  
  462.  
  463.  
  464.      December 23, 1993
  465.  
  466.      Werther 'Mircko' Pirani
  467.