home *** CD-ROM | disk | FTP | other *** search
/ Computerworld 1996 March / Computerworld_1996-03_cd.bin / idg_cd3 / utility / prgbr211 / readme.txt < prev   
Text File  |  1996-02-14  |  24KB  |  593 lines
  1.                                 ProgramBar 2.11
  2.                                 ---------------
  3.                          Copyright 1995 Ian Jefferies.
  4.                        jeffers@teaching.physics.ox.ac.uk
  5.                                    Shareware
  6.  
  7.         Inspired by the task bar found in Windows95, this program has been
  8. written so that the same kind of functionality and ease of use can be
  9. brought to Windows 3.1 and Windows For Work Groups.
  10.  
  11.  
  12. ---------------------------------------------------------------------
  13. Features
  14. ---------------------------------------------------------------------
  15.  
  16. * A `Start' button that gives access to much of the functionality of
  17. ProgramBar.
  18.  
  19. * Access to, and running of, any program in your Program Manager
  20. groups.
  21.  
  22. * Access to all of the Control Panel configuration applets
  23.  
  24. * Each running application is represented on the ProgramBar as a
  25. button.  A push of the button makes that application active.
  26.  
  27. * Right click on the ProgramBar panel to display a list of active
  28. applications that can be closed.
  29.  
  30. * Shutdown Windows, either returning to DOS, restarting Windows again,
  31. or rebooting your machine.
  32.  
  33. * Fast access menus for your most frequently used programs, documents
  34. and help files.
  35.  
  36. * Access to this help file (click on the ProgramBar logo on the right
  37. hand side of the bar.)
  38.  
  39. * Hidden out of the way when you don't need it.  May also be
  40. permanently visible on your desktop.
  41.  
  42. * Fast search for files on your hard disk.  They may be launched or
  43. added to the fast access menus.
  44.  
  45. * Run a program specifying the command arguments, or a data file with
  46. an association.  The file can be browsed for.
  47.  
  48. * Colourful icons help navigation through the main popup menu.
  49.  
  50. * Flyby help hints when you let the mouse hover over part of the
  51. ProgramBar interface.
  52.  
  53. * Drag and drop of files from File Manager onto ProgramBar. Automatic
  54. separation into Applications, Documents and Help files.
  55.  
  56. * The state of ProgramBar is saved between sessions.
  57.  
  58. * The Control Panel may be inhibited from running in order that a
  59. potential clash between ProgramBar and Control Panel is avoided.
  60.  
  61. * Full configuration of ProgramBar via a popup dialog box.
  62.  
  63. * Applications can be excluded from the front panel task switching
  64. buttons to reduce clogging up of the panel.
  65.  
  66. * Task switching buttons on the front panel may now be stacked onto
  67. more than one row.
  68.  
  69. * ProgramBar may be triggered from any of the four edges of the
  70. screen.
  71.  
  72. * Applications/documents and help files added to the fast access menus
  73. may be edited to give more appropriate titles, run time arguments, or
  74. different working directories.
  75.  
  76. * Task switching now handles modal dialog boxes opened by an
  77. application better.
  78.  
  79. * Better support for people who use cursor screen wrap: the size of
  80. the region that can be triggered may be adjusted, the time delay
  81. before ProgramBar hides again may be increased.
  82.  
  83. * Menu and front panel fonts may be changed from within ProgramBar.  A
  84. sample box also shows the suitability of the font for reproducing
  85. non-standard characters that may be used in titles.
  86.  
  87. * Clock and date displayed on the front panel.
  88.  
  89. * 3D effect on all dialog boxes though the automatic use of CTL3DV2.DLL if
  90. present.  Tabbed dialog boxes adjusted to look more like their Windows 95
  91. counterparts when used in conjunction with this DLL.
  92.  
  93.  
  94.  
  95.  
  96. ---------------------------------------------------------------------
  97. Installation
  98. ---------------------------------------------------------------------
  99.  
  100. There are three files required for the correct use of ProgramBar.
  101. They are:
  102.  
  103. PROGBAR.EXE     The executable that provides all of the functionality
  104.                      of ProgramBar.
  105. PBHOOK.DLL      A DLL that is used by ProgramBar to monitor system
  106.                 activity, notify of programs being opened or closed.
  107. PROGBAR.HLP     The Windows help file used by ProgramBar.
  108.  
  109. In addition, the following two files should also be present in the
  110. archive:
  111.  
  112. README.TXT      Text instructions on how to install the program (this
  113.                 file!)
  114. FILE_ID.DIZ     A file that assists BBS operators in maintaining their
  115.                 archives.
  116.  
  117.  
  118. To install ProgramBar follow the steps below:
  119.  
  120. 1.      Create a new directory for ProgramBar.  (e.g.
  121.         C:\WINAPPS\PROGBAR)
  122.  
  123. 2.    Copy all the files listed above into this directory.
  124.  
  125. 3.      Then activate Program Manager and choose the program group
  126.         that you want to place the ProgramBar launch icon into.
  127.  
  128. 4.    From Program Manager's menu chose File|New...
  129.  
  130. 5.    Select Program Item, then press the OK button.
  131.  
  132. 6.      Fill in the name of the icon and the path where the executable
  133.         may be found.
  134.  
  135. 7.      If you want to have ProgramBar launch when you run Windows, place a
  136.         copy of the icon in the StartUp group.  This may be done by keeping
  137.         the CTRL key pressed down while clicking on the ProgramBar icon and
  138.         dragging it to the StartUp group.
  139.  
  140. Clicking on the ProgramBar icon will now run the program.  ProgramBar
  141. creates an initialisation file called progbar.ini in the windows
  142. directory.
  143.  
  144. ProgramBar assumes that both the Program Manager and WinHelp
  145. executables are available. Some default icons are taken from these
  146. files for display purposes.
  147.  
  148.  
  149. ---------------------------------------------------------------------
  150. About shareware and legal disclaimers
  151. ---------------------------------------------------------------------
  152.  
  153.         Shareware is a method by which software may be evaluated by the end
  154. user before purchase.  Almost all of the shrink-wrapped software produced
  155. comercially in large volumes (and at comparatively high prices!) provide
  156. their installation disks in licensed and sealed packs.  On opening the
  157. sealed packs the user is no longer allowed to return the software and obtain
  158. a refund - clearly you cannot find out if a software package will do what
  159. you need without commiting a significant amount of money beforehand. With
  160. shareware the end user can evaluate the software and decide if it benefits
  161. their working practices.  If it doesn't then the software can just be
  162. deleted from their hard-disk.  If, however, the software is found to be
  163. useful then the user is expected to pay for it.  Just like shrink-wrapped
  164. software. Your continued support of shareware gives the programmer the
  165. incentive to continue developing and improving the software. Shareware means
  166. distribute the program freely, not use the program freely.
  167.  
  168.         ProgramBar is shareware.  You have 14 days in which you may evaluate
  169. the software before you have to pay for it or delete it from your machine.
  170. Once paid for all subsequent upgrades may be used for FREE!  All users who
  171. showed their support for version 1.x of ProgramBar under its bookware status
  172. are not required or expected to re-register. This software has not been
  173. crippled, nor has it any timer expiry.  It is not my wish to have to add
  174. code like this to ProgramBar, I'd much rather be putting in new features for
  175. people to use.  However, since shareware requires the trust of the user to
  176. pay for the product or delete it from their machine then I may be forced
  177. into adding a more positive reminder.
  178.  
  179.         Users are classified into three groups for the type of payment
  180. expected. A single user is entitled to use the software in the same fashion
  181. as a hardcover book, that is only one copy may be running on one machine at
  182. any one time.
  183.  
  184.         My contact details are given later in this file.
  185.  
  186. ***
  187. ***  Group1:  Single user full-time academic students, full-time
  188. ***  academic staff, or unemployed.
  189. ***
  190.  
  191.         Members of this group may continue to use this software
  192. without charge.  If you would like to show your appreciation for this
  193. software in a stronger fashion then may I suggest one of the
  194. following:
  195.  
  196. * Send me a postcard from your part of the world to the address given
  197.   below.
  198.  
  199. * If you feel very strongly about how much this program has changed
  200.   your life and have a good book or two that you no longer read and
  201.   want to pass onto a good home then please mail it/them to me at the
  202.   address given below.
  203.  
  204. * If you want to part with hard earned cash then you may pay for
  205.   ProgramBar as a Group 2 user.
  206.  
  207. Group 1 users who move up to Group 2 and have not registered under any
  208. of the bulleted points above are expected pay for this software as a
  209. Group 2 user.
  210.  
  211. ***
  212. ***  Group 2: All other single users not in Group 1
  213. ***
  214.  
  215.         Payment for ProgramBar is #10 (ten British pounds sterling) or
  216. $15 (fifteen US dollars) whichever is more convenient.  Cheque, postal
  217. order, or money order are acceptable.  Cash is also acceptable but
  218. somewhat more risky to send through the post.  If you would like a
  219. receipt then please indicate this when you send the money.
  220.  
  221. ***
  222. ***  Group 3: Site license for multiple users
  223. ***
  224.  
  225.         ProgramBar may be licenced for multiple users.  A site is
  226. defined as a building or group of buildings with a unique external
  227. postal address.  Please contact the author if you wish to negotiate on
  228. behalf of multiple sites.
  229.  
  230.         The number of users is defined as either the number people
  231. that will use the software, or the number of machines (including
  232. networked workstations) on which the software may be used, whichever
  233. is the lower.
  234.  
  235.         Usage is limited to those machines for which the company has
  236. purchased, hired, or leased.  It does not include machines owned by
  237. employees of that company.
  238.  
  239. Number of users                         Price per user
  240.                         # (British pounds sterling)     $ (US dollars)
  241. First user                          10                       15
  242. 2nd to 5th user                      8                       12
  243. 6th to 10th user                     6                        9
  244. 11th to 25th user                    4                        6
  245. 26th to 50th user                    2                        3
  246. 51st user and over                   1                        1.50
  247.  
  248. Unlimited users at                 300                      450
  249. one site
  250.  
  251. The price is capped at approximately 170 users to #300 or $450.
  252.  
  253.  
  254.  
  255. --- DISCLAIMER OF WARRANTY ---
  256.         THIS SOFTWARE IS PROVIDED FREE AND "AS IS" WITHOUT WARRANTY OF
  257. ANY KIND.  THE AUTHOR FURTHER DISCLAIMS ALL IMPLIED WARRANTIES
  258. INCLUDING WITHOUT LIMITATION ANY IMPLIED WARRANTIES OF MERCHANTABILITY
  259. OR OF FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK ARISING OUT
  260. OF THE USE OR PERFORMANCE OF THE SOFTWARE AND DOCUMENTATION REMAINS
  261. WITH YOU. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DAMAGES
  262. WHATSOEVER (INCLUDING WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS
  263. PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR OTHER
  264. PECUNIARY LOSS) ARISING OUT OF THE USE OF OR INABILITY TO USE THE
  265. SOFTWARE OR DOCUMENTATION EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE
  266. POSSIBILITY OF SUCH DAMAGES.
  267.  
  268. --- DISTRIBUTION ---
  269.  
  270.         You may distribute this software freely on any electronic
  271. based medium including but not limited to: uploading to a FTP site,
  272. uploading to a BBS, downloadable from a WWW page.  May also be
  273. distributed as part of a CD-ROM collection of shareware/freeware.  Any
  274. distribution should not limit my rights (either explicitly or
  275. implicitly) to distribute this software using the same medium or any
  276. other.  The software should be distributed as received in the original
  277. archive file. The only charge a distributor may make shall be limited
  278. to the cost of the medium by which the software is delivered, and
  279. those incurred in handling/distribution.  A small shipping and
  280. handling charge may be made if this software is distributed as part of
  281. a collection.
  282.  
  283.  
  284. --- OTHER NOTES ---
  285.  
  286. ProgramBar is Copyright 1995 Ian Jefferies.  All rights reserved.
  287. All rights not explicitly licensed to the user are reserved to the
  288. developer.
  289.  
  290. If you write or publish an editorial about ProgramBar then the author
  291. would appreciate receiving a copy via either conventional or
  292. electronic mail.
  293.  
  294. The most recent version of ProgramBar may be obtained from the SimTel
  295. mirror archive at ftp.coast.net in the directory SimTel\win3\desktop or
  296. any of the mirror sites as prgbr???.zip, where ??? represents the version
  297. number.  Versions 2.1 and earlier of ProgramBar were released under the
  298. filename system prgbar??.zip where ?? represents the version number.
  299.  
  300.  
  301. Contact address:
  302.  
  303.     Ian Jefferies,
  304.     24, Meredith Close,
  305.     Pinner,
  306.     Middx,
  307.     HA5 4RP,
  308.     England.
  309.  
  310.     Tel: England (0)181-428-1466
  311.  
  312.     Internet:  jeffers@teaching.physics.ox.ac.uk
  313.  
  314. Windows, Windows95 and MS-DOS are registered trademarks of Microsoft
  315. Corporation.
  316.  
  317. All other product names may be copyrighted and registered or
  318. unregistered trademarks/trade names of their respective owners.
  319.  
  320.  
  321.  
  322.  
  323. ---------------------------------------------------------------------
  324. Version information
  325. ---------------------------------------------------------------------
  326.  
  327. Version 2.11, released 1-Dec-95
  328. -------------------------------
  329.  
  330. * ProgramBar failed to handle a large number of applications on the front
  331.   panel, generating a `TaskBar overloaded' message.  This message
  332.   should now only appear under extreme unreasonable circumstances (ie
  333.   when the buttons are so narrow that they cannot display their contents.)
  334.  
  335. * Control Panel applets are now cached, significantly decreasing
  336.   ProgramBar's load time.  If any of the applets used by Control Panel are
  337.   replaced, deleted or added to then ProgramBar will re-cache the data
  338.   where required.  Data is also re-cached if the screen driver is changed as
  339.   the icon format may be different.
  340.  
  341. * Control Panel applets in the [MMCPL] section of control.ini are now
  342.   scanned as well as the [drivers.desc] section.
  343.  
  344. * A peculiar window create/destroy/create cycle that assigned the same
  345.   window handle in both cases resulted in two buttons being displayed on
  346.   the ProgramBar front panel.  E-mail Connection was the only application
  347.   seen to exhibit this behaviour.  Fixed.
  348.  
  349. * Added a switch that allows the display of elipses (...) on the front panel
  350.   task switch buttons to be turned off.  Useful for when a large number of
  351.   buttons are displayed.
  352.  
  353. * Confirmation of closure of a DOS box via right clicking on the front panel
  354.   is now required.  A strongly worded message reminds the user that
  355.   resources may be lost and Windows may be impaired.
  356.  
  357. * The Find file dialog box now defaults to searching subdirectories.
  358.  
  359. * Most error dialog box and menu message strings moved to the resource
  360.   file for easier internationalisation of the executable.
  361.  
  362. * Multiple arguments may now be specified for file wildcards and directories
  363.   in the Find file dialog box.  Each argument must be separated by a
  364.   semicolon (;).
  365.  
  366. * Button text colours on the front panel are now fixed to black regardless of
  367.   the choice of personal colour scheme.
  368.  
  369. * CTL3DV2.DLL now used for dialog boxes if it is installed.  The 3D menus
  370.   and front panel buttons are not and never have been provided using this
  371.   DLL.  Tab dialog boxes provide a Windows 95 look and feel when this
  372.   DLL is detected.
  373.  
  374. * ProgramBar crash protection code improved, now distinguishes between
  375.   modules of the same name.
  376.  
  377. * Annoying screen flicker caused by selecting a new dialog page on the
  378.   configuration dialog removed.
  379.  
  380. * Intermittant problem when switching from a DOS full screen app back to
  381.   Windows caused the button indicating the active app to have a black
  382.   background.  Technique for drawing buttons changed, fixing problem.
  383.  
  384. * Split menus crashed ProgramBar when sorted after an insertion.  Most
  385.   likely to occur on the fast access menus.  Fixed.
  386.  
  387.   
  388. Version 2.1, released 21-Nov-95
  389. -------------------------------
  390.  
  391. * Non-standard Windows colour schemes interfered with icon masking
  392.   using monochrome bitmaps.  Menu icons gained lurid clashing colour
  393.   backgrounds.  Fixed.
  394.  
  395. * If both clock and date were not displayed on startup of ProgramBar
  396.   then a recursive loop was entered, locking Windows.  Ctrl-Alt-Del
  397.   aborted ProgramBar, but Windows was left in an unstable state and
  398.   running ProgramBar again returned the user to the DOS prompt without
  399.   warning. Fixed.
  400.  
  401. * Code has been installed to ensure that should ProgramBar crash for
  402.   any reason, it is now safer to re-run the program.  Due to the
  403.   nature in which ProgramBar interacts with Windows it cannot be
  404.   guaranteed to prevent further crashes/lockups/unexpected kickouts
  405.   to DOS.
  406.  
  407. * Browse buttons added to fast access configuration dialogs to
  408.   complement the drag/drop addition of files.
  409.  
  410.  
  411. Version 2.0, released 18-Nov-95
  412. -------------------------------
  413. * Added full configuration to ProgramBar via a popup dialog box.  Most
  414.   changes to the configuration dialog are immediately reflected in the
  415.   appearance of ProgramBar.  All changes can be easily cancelled.
  416.  
  417. * The Find File dialog box now provides a default search directory, it
  418.   will be the root directory of the first fixed or remote disk on your
  419.   system (most likely C:\).
  420.  
  421. * When using the Find File dialog box to append a second set of files,
  422.   the first file to be appended was incorrectly placed somewhere in
  423.   the middle of the first list.  Fixed.
  424.  
  425. * Better handling of desktop applications that don't define class
  426.   icons.
  427.  
  428. * Ability to exclude applications parent windows from the front panel
  429.   task switching based on module name and window class.  Included
  430.   ability to preview the criterion used to eliminate the parent
  431.   windows.
  432.  
  433. * Better display of front panel task switching buttons.  They can now
  434.   stack onto more than one row.  User configurable.
  435.  
  436. * Full editing of applications on the fast access menus.  Entries may
  437.   now be run minimized/maximized/normal, arguments can be appended,
  438.   working directory may be changed, title displayed on the fast access
  439.   menu can be edited.  Settings saved to ini file are incompatible
  440.   with v1.x, but upgrade performed automatically.
  441.  
  442. * While finding the control panel applets, entries in the
  443.   [drivers.desc] section of control.ini were assumed to be in the
  444.   Windows system directory.  ProgramBar could not find drivers that
  445.   included a full path in their entry.  Fixed.
  446.  
  447. * Added a /d command line option to produce a debugging script during
  448.   start up.  Currently limited to examining loading of DLL's and
  449.   opening files.
  450.  
  451. * When switching to an application using the button bar, if the
  452.   application had been disabled by a dialog box then the focus was
  453.   incorrectly set to the application (not the dialog box).  ProgramBar
  454.   now searches for the most recent dialog box that has disabled the
  455.   application and sets the input focus there.
  456.  
  457. * ProgramBar may now be accessed from the left, right and top edges of
  458.   the screen in addition to the bottom edge.
  459.  
  460. * The size of the region that can activate ProgramBar may now be
  461.   modified.  Added for the benefit of those who use cursor wrap and
  462.   can't hit the edge pixels reliably.
  463.  
  464. * The time delay between moving the cursor off of the front panel and
  465.   ProgramBar hiding itself may now be adjusted by the user.
  466.  
  467. * Choice of font used on the front panel and in menus moved from
  468.   progbar.ini to the configuration dialog box.  Dynamic adjustment
  469.   shows what the new front panel will look like (if visible on the
  470.   desktop) before the change is committed.
  471.  
  472. * Better handling of close down of Control Panel if it has a dialog
  473.   box open. ProgramBar now attempts to close the dialog box before
  474.   closing Control Panel.
  475.  
  476. * ProgramBar front panel now appears briefly on startup to indicate an
  477.   edge that may be used to access the front panel from.  For the first
  478.   time user the main window appears permanently on by default, several
  479.   people failed to find ProgramBar once it had finished displaying the
  480.   logo screen.
  481.  
  482. * Enhanced detection of parent windows that may be switched to.
  483.   ProgramBar failed to handle properly windows that had been hidden or
  484.   had zero size.  In several cases windows were not seen to close by
  485.   ProgramBar and activating buttons were not removed from the front
  486.   panel.
  487.  
  488. * Closing an application with a right click now attempts to close
  489.   dialog boxes associated with the application first.
  490.  
  491. * Clock and date added to front panel.  Either a digital or panel font
  492.   clock may be displayed.  If the clock uses the front panel font then
  493.   the short date may also be displayed.  The digital clock is not able
  494.   to display the date.  The fly-by hint associated with the clock
  495.   displays the long date, as defined in Configuration|Control
  496.   Panel|International.
  497.  
  498. * Corrected several omissions and factual errors from the help file,
  499.   as well as writing up all the new features.
  500.  
  501. * Fixed a bug that crashed ProgramBar with a `Divide by Zero' error if
  502.   there were no programs on the desktop when ProgramBar was run.
  503.  
  504. * Reduced the chance of a text clipping problem occuring on the front
  505.   panel buttons.  Text clipping may still occur because of kerning by
  506.   the GDI font driver.
  507.  
  508.  
  509. Version 1.2, released 23-Oct-95
  510. -------------------------------
  511. * Crashing bug.  When a popup menu is closed and the cursor is at
  512.   the very bottom edge of the screen, ProgramBar locks up.  Fixed.
  513.   This is the only improvement to this version, but warrants a new
  514.   release to prevent data loss.
  515.  
  516.  
  517. Version 1.1, released 22-Oct-95
  518. -------------------------------
  519. * Task switching to full screen DOS application from the button bar
  520.   failed, doing nothing.  Fixed.
  521.  
  522. * ProgramBar failed to popup if the cursor was at the bottom edge of
  523.   the screen and sitting over an icon title or window resizing frame.
  524.   Fixed.
  525.  
  526. * ProgramBar became confused if another application forced ProgramBar
  527.   to display/hide its main window, refusing to popup when hidden.
  528.   Fixed.
  529.  
  530. * An application that forced ProgramBar to minimize its main window
  531.   succeeded.  This should now not be possible.
  532.  
  533. * Cursor now changes to an hourglass while ProgramBar loads or
  534.   performs a time consuming operation.
  535.  
  536. * All menus now display colourful icons to aid navigation.
  537.  
  538. * A Program Manager item that specified a working directory different
  539.   to the full path prepended to the executable file name could not be
  540.   run.  Items that did not specify a directory in which to find the
  541.   executable were unaffected.  Fixed.
  542.  
  543. * The ProgramBar panel display font and point size may now be adjusted
  544.   in the progbar.ini file for those people using high resolution
  545.   display modes.
  546.  
  547. * Flyby hints for the front panel give more information than the
  548.   (possibly) truncated title text.
  549.  
  550. * While scanning for the DLL's and drivers managed by Control Panel, a
  551.   non-existant driver will no longer produce a `File not found' dialog
  552.   box during start up.
  553.  
  554. * Added ability to change fonts used on the front panel and in the
  555.   menus by user request.
  556.  
  557. * Menu handling improved, menu's now split when they are larger than
  558.   the screen height rather than a fixed number of entries.  The list
  559.   of Program Manager groups will now split into two if you have an
  560.   excessive number of groups.  This is a hint that you should
  561.   rationalize the number of groups in Program Manager :)
  562.  
  563. * Added Maximized checkboxes to the file finder and program run dialog
  564.   boxes.
  565.  
  566. * FILE_ID.DIZ added for the benefit of BBS Sysops.
  567.  
  568.  
  569. Version 1.0, released 9-Oct-95
  570. ------------------------------
  571. * First public release.
  572.  
  573.  
  574.  
  575. ---------------------------------------------------------------------
  576.                             FILE_ID.DIZ
  577. ---------------------------------------------------------------------
  578.  
  579. Cut---------------------------
  580. (2.11) ProgramBar - App launch/switch/close
  581. ProgramBar brings much of the functionality
  582. of the Win95 TaskBar to Win3.1.  A button bar
  583. at any edge of the screen displays active
  584. tasks for switching.  All Program Manager
  585. groups may be accessed. Control Panel items
  586. may be run for configuration.  Fast launch
  587. of commonly used applications, documents
  588. and help files.  Easy configuration of most
  589. aspects of usage.
  590. Copyright 1995 Ian Jefferies. Shareware.
  591. jeffers@teaching.physics.ox.ac.uk
  592. End Cut-----------------------
  593.