home *** CD-ROM | disk | FTP | other *** search
/ The Pier Shareware 6 / The_Pier_Shareware_Number_6_(The_Pier_Exchange)_(1995).iso / 035 / fileb190.zip / FILEBAR.TXT < prev    next >
Text File  |  1994-11-25  |  37KB  |  733 lines

  1. ===============================================================================
  2. -------------------------------------------------------------------------------
  3.            
  4.                  FileBar - Version 1.90
  5.         
  6.         An OS/2 Application Launch Facility and WPS Replacement
  7.        Written By Eric A. Wolf - Copyright (C) 1994 - All Rights Reserved
  8.  
  9. This program is SHAREWARE!  Please read the registration information at the end
  10.      of this document for details on how to register your copy of FileBar.
  11.  
  12. -------------------------------------------------------------------------------
  13. ===============================================================================
  14.  
  15.  
  16.  
  17. == Introduction ============
  18.  
  19. FileBar, quite simply, is a menubar for your desktop.  It is intended to ease 
  20. the operation of launching frequently used applications and from jumping from 
  21. task to task within OS/2.  Spanning across the top or bottom of your desktop, 
  22. FileBar is intended to give you quick and easy access to your most used 
  23. applications (whether they are DOS, Windows or OS/2 applications).  You have 
  24. eight menus in which you can place a maximum of 40 different items in each.  
  25. Each item may represent a command shell to boot, a script file to perform a
  26. task or even your favorite application.  With FileBar, you're just one click 
  27. away from your favorite and most used programs.  Also, FileBar can be used
  28. as a regular application or you can use it to replace your existing Workplace 
  29. Shell in order to provide you with much more memory for the rest of your 
  30. programs (thus, speeding up your system).
  31.  
  32. This program is ideal for network situations where network drivers use vast
  33. amounts of precious memory.  FileBar can give you back a large portion of that
  34. memory!!!  (Government and site licenses can be arranged at discounted rates --
  35. please contact the author for details!)  It also allows password protection
  36. and system administrator access features for network or group situations.
  37.  
  38. -------------------------------------------------------------------------------
  39.  
  40. == Installation ============
  41.  
  42. If you are installing FileBar for the first time, please continue to the next
  43. paragraph.  If you are simply upgrading filebar, keep a copy of your old
  44. filebar.ini initialization file.  Delete ALL the files associated with the
  45. older version of FileBar, unzip this newer version and copy your previous
  46. filebar.ini file back into the directory.  If you are using FileBar as a 
  47. WPS replacement, skip to that section below.  If not, skip to the Using 
  48. FileBar section below.
  49.  
  50. Installing FileBar is simple.  Read the readme file and once you agree to
  51. register the product if you continue to use it, unzip the second zipfile,
  52. FILEBAR.ZIP.  Now, simply go to an OS/2 prompt, and type INSTALL from the
  53. same directory where you unzipped the files.  That will invoke a REXX script
  54. that will create a FileBar program object/icon on the desktop for you to
  55. use to start FileBar.  A german language version icon of FileBar is also
  56. created.
  57.  
  58. To immediately start FileBar, double click the program object on the
  59. desktop.  And to make FileBar start every time you boot OS/2, drag the
  60. object (or a copy/shadow thereof) to the startup folder that is found in
  61. the OS/2 system folder.
  62.  
  63. (NOTE:  You should proceed to unzip the second zipfile ONLY if you agree to
  64.     the registration requirements presented both in the README file and
  65.     in the registration text at the end of this document.)
  66.  
  67. Installing FileBar as a WPS replacement:
  68. ----------------------------------------
  69. FileBar has the capability to be used as a replacement shell.  This means,
  70. instead of using the WPS, you can use FileBar.  Doing this greatly reduces
  71. the amount of memory the system uses and can give your programs an extra
  72. two and a half to three megabytes of memory to run in (resulting in very
  73. noticeable speed increases on most systems).
  74.  
  75. If you wish to use FileBar over the WPS as your shell, simply edit your
  76. OS/2 config.sys and change the line that reads:
  77.  
  78.   SET RUNWORKPLACE=PM_Shell_Path\PMSHELL.EXE
  79.  
  80.       to
  81.  
  82.   SET RUNWORKPLACE=Put_Complete_FileBar_Path_Here\FILEBAR.EXE
  83.  
  84. (**NOTE:** DO NOT modify the PROTSHEL setting in the OS/2 config.sys!!)
  85.  
  86. Also, you will need to copy the FILEBAR.DLL file to your \OS2\DLL directory.
  87. (This is necessary only if you are running FileBar as a WPS replacement.)
  88.  
  89. After doing both of these things, the next time you boot OS/2, you will
  90. have FileBar as your shell.  To change back to WPS, simply change the line
  91. back to PMSHELL.
  92.  
  93. Please note that replacing the Workplace Shell will no longer give you access
  94. to folders or objects.  If you need these objects on a continual basis, please
  95. use FileBar as an application.  If you need them on a limited basis, use
  96. filebar as your shell while using WPS only when you need it (WPS can be
  97. launched as an application from the FileBar menubar); by using Filebar, you 
  98. will save A LOT of memory.
  99.  
  100. -------------------------------------------------------------------------------
  101.  
  102. == Using FileBar =============
  103.  
  104. Once FileBar is started, you will see the FileBar across the top of your
  105. screen.  You access functions in FileBar like any other menu bar that is in 
  106. any other OS/2 application.  The menubar may be positioned at the top or the
  107. bottom of your desktop (see below for instructions on moving it).  The current
  108. time and or date may also be displayed on the FileBar for convenience (again,
  109. see below for details) and you may also schedule items that either launch
  110. program items or display reminder notices to you at specified times using the
  111. task scheduler.
  112.  
  113. The first time you boot FileBar, it comes preconfigured with several menus.
  114. The first two, FileBar and Task List are static (that is, unchangable by the
  115. user) but the remaining menus may be added to, changed or even deleted and
  116. replace by more of your own menus.
  117.  
  118. The functions of the menus are explained below:
  119.  
  120.     FileBar
  121.     -------
  122.       Move to Bottom/Top:  This option changes the position of the FileBar on
  123.                the desktop.  Select this option to toggle the
  124.                position of the FileBar on the desktop.
  125.       
  126.       Edit FileBar:  This is where you add, remove or change the appearence of
  127.       Menus:         your user menus.  When you select this option, you will
  128.              be presented with all of your currently defined menus.
  129.              You may remove entire menus by selecting Remove Menu or
  130.              you may change the order of your menus by selecting a
  131.              menu and then clicking Move Menu < or Move Menu > to
  132.              move your menu left or right on the filebar menu.
  133.              You may also add a menu by simply clicking Add Menu and
  134.              typing a title for your new menu.  You may edit the 
  135.              items of a menu by selecting Change Menu (or by double
  136.              clicking a menu item) or you may go back to
  137.              normal FileBar operation by clicking OK.
  138.  
  139.              If you choose to change your menu, you will be
  140.              presented with all the items currently under the
  141.              selected menu.  You may change the name of an
  142.              existing menu by overwriting the name of the menu in
  143.              the menu name entry field.  You may move items up and
  144.              down, insert menu separators, delete items or insert
  145.              (add) items.  Selecting OK will return you to the 
  146.              menu selection dialog box.
  147.  
  148.              If you choose to add an item (or change an existing
  149.              item), you will be presented with a dialog containing
  150.              the item's name (which may be changed by simply typing
  151.              in the new name into the name entry field), the type
  152.              of program you wish to run (OS/2, DOS or Windows
  153.              application), whether the program should start
  154.              maximized or minimized, the complete pathname of the
  155.              program to execute if this item is selected off the
  156.              menu, any command-line arguments that should be passed
  157.              to the program and the starting directory for the
  158.              program.
  159.  
  160.              (You may also edit a menu item by double clicking it).
  161.  
  162.              Clicking OK saves the information and returns you to
  163.              item editing dialog box.  If you click Find File, you
  164.              will be presented with a dialog box to allow you to
  165.              browse over your disk drives and find a file you wish
  166.              to execute.  Select Cancel to abort this operation and
  167.              return to the previous dialog.  If you select a file
  168.              from here, the pathname of the file, the directory and
  169.              the program type will be set for this program when you
  170.              return to the item editing dialog box.
  171.  
  172.              In the edit item data dialog window, you may click
  173.              Reset to restore the data for the item you had before
  174.              you opened the dialog or you may press cancel if you
  175.              wish to abandon your changes.
  176.  
  177.           OPENING WPS OBJECTS 
  178.              In the 'edit item' dialog, there is also a feature to
  179.              open Workplace Shell objects.  To enable this feature,
  180.              simply drag a copy of the object you want to open to
  181.              the area marked on the dialog and drop it.  The 
  182.              dialog will then configure itself to open that object
  183.              whenever the item is selected.  Once you drop the
  184.              object, simply click OK because the settings are
  185.              correct.
  186.  
  187.           USING SETTINGS
  188.              If you have a program that requires specialized
  189.              settings, you may mark the program to be launched as
  190.              a WPS program and you will then be given the oppurtunity
  191.              to modify any settings you may need to for the program.
  192.              Remember, in order to use and modify program settings,
  193.              you must have the program marked as launchable as a
  194.              WPS object.  In order to correctly use this option,
  195.              you MUST FULLY QUALIFY THE PATHNAME!  (instead of
  196.              entering just FILEBAR.EXE you must enter 
  197.              C:\OS2\FILEBAR\FILEBAR.EXE).  This way OS/2 can
  198.              associate the settings you specify with the executable.
  199.  
  200.              Note that each executable only has 1 set of options,  If
  201.              you want to set up a program with two different sets of
  202.              options, make a copy of the executable and set the 2nd
  203.              set of options for the new copy of the executable and
  204.              set FileBar to launch that file.
  205.       
  206.              SPECIAL NOTE:  You may also use WPS type settings without
  207.              going through the WPS!!  When you specify an application
  208.              to launch, if there exists a file called SETTINGS.INI in
  209.              the same directory as the executable (and the explicit
  210.              use of WPS settings is turned OFF), FileBar will use the
  211.              settings in SETTINGS.INI for your session.
  212.  
  213.       Time/Date Options:  This option lets you select what is displayed on
  214.               the far right of the FileBar at all times.  You 
  215.               have the choices of displaying nothing, the 
  216.               current time, the current date, or both the 
  217.               the current time and date and also all of these
  218.               options in international format.
  219.  
  220.               There is also an hourly chime feature that will
  221.               play a chime sound ever hour.  You can enable
  222.               or disable this feature the feature by clicking
  223.               the checkbox and you can select a .WAV sound file
  224.               to play as your chime by either typing the 
  225.               filename of it in the control dialog or using the
  226.               find file feature to find a .WAV file.
  227.  
  228.       Password Settings:  With this option, you may turn on and off system
  229.               administrator protection for FileBar tasks.  This
  230.               means that, as a system administrator, you can
  231.               prevent others from making changes to your FileBar
  232.               set up or getting at the internals of your 
  233.               computer with the use of a password. This means 
  234.               you can lock out all FileBar tasks to only those 
  235.               persons holding a correct password if you enable 
  236.               this feature.  Moreover, before any critical system
  237.               option is invoked, a password entry field is 
  238.               displayed for the user to type their password 
  239.               (and the option is not executed until the correct 
  240.               password is given) if you use this option.  
  241.               Passwords are also set by the next question dialog 
  242.               in Password settings.  
  243.               
  244.               Simply check the box if you want system 
  245.               administrator (or global) password protection.
  246.               Press the button to change your global password,
  247.               also.
  248.               
  249.               Password protecting the launching of menu items
  250.               is done on a per-item basis and is handled through 
  251.               the password protection check-box in the edit item 
  252.               data dialog.  Also, passwords may be up to 8
  253.               characters long and can have symbols 
  254.               embedded within them (spaces, periods, etc).
  255.  
  256.               NOTE: When you first run this version of FileBar
  257.                 your password, by default, is FILEBAR
  258.                 (all upper case -- case is very important!).
  259.  
  260.               If, for some reason, you forget your password, with 
  261.               a text editor, look at the last lines of your
  262.               FILEBAR.INI.  It will contain all the passwords
  263.               used in the program.  Try each of these (or
  264.               perhaps they will jog your memory!)  You can
  265.               use the editor to delete the last lines of your 
  266.               FILEBAR.INI file that are strings if you wish
  267.               to revert you back to the default password of 
  268.               FILEBAR (case is important!) for everything. 
  269.  
  270.               Please do this with caution!  It should be done
  271.               ONLY as a last resort!
  272.  
  273.               On a similar note, your passwords are written in 
  274.               your FILEBAR.INI file.  If you are using password 
  275.               protection on your system, you should make it a 
  276.               point not to let anyone view or tamper with that 
  277.               file!
  278.  
  279.       Pop Up Menu Settings:  This features allow you to configure the behavior
  280.                  of the popup menu available in FileBar.  You can
  281.                  decide if the popup menu is enabled and whether
  282.                  you want to hide the primary filebar menu.  Also,
  283.                  you can decide which button combination pops up
  284.                  the menu (Button 3 is not available when FileBar
  285.                  is used as a shell replacement unless you have a
  286.                  mouse driver that supports 3 buttons (RODENT, etc))
  287.  
  288.                  If the popup menu operation interferes with any
  289.                  existing application, please disable this feature.
  290.  
  291.                  Show/Hide Primary FileBar Menu:
  292.                  This feature allows you to hide the
  293.                  filebar menu across the top or bottom of 
  294.                  your screen in the instance you want to
  295.                  solely use the pop-up menu (similar to
  296.                  the operation of X-Windows).
  297.  
  298.       Launch Start Up Items:  If using FileBar as a shell replacement, when
  299.                   starting FileBar, you have the option of also
  300.                   starting with it up to ten different menu items
  301.                   as well.  Simply select the menu items to launch,
  302.                   arrange the order as to your liking and then
  303.                   be sure you check the box to enable them and next
  304.                   time you load FileBar, these other applications
  305.                   will launch, as well.
  306.  
  307.       Use Alternate FileBar Menu:  Selecting this toggles whether the FileBar
  308.                    System menu will be the name FileBar or
  309.                    just a sigle character symbol.  Use the
  310.                    single symbol if you want the menu to use
  311.                    less menubar real-estate.
  312.       
  313.       Background Bitmap:  Use this option only if you are using FileBar as a
  314.               WPS replacement.  This functions similarly to the
  315.               WPS background bitmap setting.  Select whether you
  316.               want to display the bitmap or not and also how
  317.               (scaled to fit screen, normal, or tiled image).
  318.               The complete pathname of the image should be
  319.               entered into the entry field.  You may use the
  320.               Find button to help you locate images.  (Note that
  321.               ONLY .BMP images can be used for this option).
  322.       
  323.       Confirm on Task Close:  This menu item should be checked if you want
  324.                   FileBar to double check with you before
  325.                   terminating an application.
  326.       
  327.       Resize Desktop on Boot:  If you have FileBar placed along the top
  328.                    portion of your screen, you have the option to
  329.                    resize your Desktop window so when FileBar
  330.                    loads, it will no longer cover any icons or
  331.                    objects that may be placed near FileBar.
  332.  
  333.       Remove from Jump List:  When this option is enabled, and FileBar is used
  334.                   as a replacement shell, the switch list entry
  335.                   for FileBar is removed so it cannot be switched 
  336.                   to by ALT+ESC nor visible in the CTRL+ESC window
  337.                   list. If you want to be able to switch to it,
  338.                   simply uncheck this item and reboot.
  339.  
  340.       Force On Top/Auto-Sizing:  When this option is selected, FileBar will
  341.                  force itself to stay on top of any other
  342.                  windows that may be on your desktop.  Also,
  343.                  when windows are maximized, they will be
  344.                  forced to fit under/or above FileBar so as
  345.                  not to cover it.  
  346.  
  347.                  If you select this feature, FileBar will make
  348.                  it a point to float above any other windows on
  349.                  your desktop.  If you find that an application
  350.                  places itself underneath FileBar, simply click
  351.                  in the application area with the 2nd mouse
  352.                  button or click one of the sizing bars with
  353.                  the 1st mouse button and the window will float
  354.                  to the top so you can correctly position it.
  355.  
  356.       Save menu configuration:  Although menu and configuration information
  357.                 is saved everytime you exit FileBar, you
  358.                 can force FileBar to save your configuration
  359.                 if you select this option.
  360.  
  361.       Product Information:  This option shows author, copyright and 
  362.                 program information.
  363.       
  364.       Exit:  This option allows you to exit the FileBar application and save
  365.          its current state in the option file, FILEBAR.INI.  The state
  366.          is only saved when the application is terminated!
  367.  
  368.     TaskList
  369.     --------
  370.       Each item in this menu represents a currently active OS/2 task.  This
  371.       menu is updated each time it is accessed and allows you a single-click
  372.       option to jump between OS/2 processes.  Any running OS/2 task will be
  373.       displayed in this menu.  There is also a cascaded menu that may be
  374.       selected for each item.  If you select this additional menu, you will
  375.       be allowed to switch to the task, close the task, show or hide the
  376.       task as well as minimize or maximize the task.  Note, that if you
  377.       do not select the cascaded menu, but simply select just a task name,
  378.       you will jump to that task.
  379.  
  380.       There is also shutdown option that when selected will shutdown your
  381.       system (similar to OS/2's shutdown system command).
  382.  
  383.     User Menus
  384.     ----------
  385.       Selecting an item in any of the seven user menus results in the file
  386.       specified in the item's options information to be started using the
  387.       information specified in the item information (see Edit FileBar Menus
  388.       for more information on modifying this information).  This is how the
  389.       user will go about launching applications they want to get to
  390.       frequently.
  391.  
  392.     Task Scheduler
  393.     --------------
  394.       If you press the area where the current time/date information is
  395.       displayed, you will invoke the task scheduler.  You will now be shown
  396.       a calendar displaying the current month.  If you wish to go back a
  397.       month, press < and if you want to advance a month, press >.  If you
  398.       ever wish to return to the current month, simply press '*'.
  399.  
  400.       With reminders, you can specify a .WAV sound file to be played along
  401.       with the display of the reminder.  If the reminder is not serviced
  402.       within 60 seconds (by default), the sound will be replayed.  If you
  403.       wish to change that 60 second time interval, press the - or + keys.
  404.  
  405.       User specified tasks can be placed on -any- calendar day.  If you want
  406.       to see -all- of the currently scheduled tasks, simply press 'Show All'.
  407.       This will display a list of all the tasks along with their associated
  408.       times and dates to go off.  If you want to revise one of these items,
  409.       simply double click the item or select OK to return to the calendar.
  410.  
  411.       If you wish to schedule a task, simply press the button corresponding to
  412.       the day you wish to schedule the item for.  This will bring up a list of
  413.       all the reminders currently scheduled for the day you selected.  To add
  414.       add an item, simply select Add Item.  (To delete or revise an item,
  415.       select the corresponding buttons, as well).
  416.  
  417.       Once you've selected Add Item, you will be presented with another
  418.       dialog box.  Here, you specify the time you want the task to occur.  If
  419.       you decide you want to move it to another day, you can also adjust the
  420.       date.  Also, you can decide if after the note has been serviced, if you
  421.       want to reschedule it.  You have the option of deleting a note when it
  422.       is serviced or you can reschedule the same note to appear the next hour, 
  423.       day, week, month or year.
  424.  
  425.       If you want a text reminder (for example, a "To-Do" item), simply type the
  426.       text of your reminder into the Reminder entry field.  If you would rather
  427.       launch an item, select 'launch item' and select an item to launch at the
  428.       specified time.  If you have an item scheduled to launch but wish to 
  429.       change it to a text reminder, simply select launch item and deselect the
  430.       checkbox signifying to launch an item.
  431.  
  432.       You have the option of only playing the specified sound at the alarm time
  433.       if you select 'sound only'.  Also, in order for your .WAV file to play,
  434.       you must have 'play sound' checked.
  435.  
  436.       When a text reminder is displayed, you have the option to reschedule the
  437.       note (by pressing OK), erasing the note completely (by selecting erase),
  438.       by revising the note (by selecting revise) or by pressing snooze and 
  439.       this will make the note disappear but re-appear in 9 minutes (the snooze
  440.       time).
  441.  
  442. Notes:  
  443. ======
  444.  
  445. * Remember, your default password is FILEBAR (all uppercase!)
  446.  
  447. * Also remember that if you are using the password protection system, be sure
  448.   to change your passwords frequently and that you keep your FILEBAR.INI file
  449.   out of view from anyone.
  450.  
  451. * To make a Windows program item start in 386 Enhanced mode, put "/3 " before
  452.   the program path of the item to execute.  For example, you if have the
  453.   program MATLAB.EXE which you want to start in 386 enhanced mode, edit the
  454.   item and make the program path read: /3 MATLAB.EXE
  455.  
  456.   The /3 should NOT be put in the arguments line but, as stated, preceeding
  457.   the executable name of the item.  (Use /S instead of /3 to make Windows
  458.   start in real mode).
  459.  
  460. * If you would like to set up the VIEW command (to view the OS/2 command
  461.   reference or other .INF materials), the program path field in the item
  462.   settings should be set to VIEW.EXE and the argument field should point
  463.   to the .INF you would like to view (ie: D:\OS2\BOOK\CMDREF.INF)
  464.  
  465. * You may notice that the FileBar will flash for a brief moment.  This is
  466.   because the time has changed and OS/2 is changing the time on the menu
  467.   bar.  Nothing is wrong, this flash is just the way OS/2 updates the menu.
  468.  
  469. * When entering command line parameters, you can specify that some or all of
  470.   the options be entered when the program is started.  If you enclose one
  471.   or parameters in brackets ('[' and ']') then FileBar will prompt you to enter
  472.   the parameter(s) when the item is launched.
  473.  
  474. * You may drag a font to the FileBar (from the Font Palette) if you wish
  475.   to change the font FileBar uses for its menus.  After you drop a font,
  476.   the menu bar will change to accomdate this new font.  The font you drop
  477.   will be remembered next time you start FileBar.  If you find yourself
  478.   running out of room on your menubar because you are using long menu names,
  479.   simply drag and drop a smaller font to FileBar (from the font palette in
  480.   the OS/2 system folder).
  481.  
  482. * If the time is not displayed (but you have the option under Time/Date
  483.   options set to display a time/date), you probably need a smaller font.
  484.   If there is not enough room for the entire time and/or date, OS/2 will
  485.   simply not display it.
  486.  
  487. * You may also drag colors (or schemes) to FileBar from the color or scheme
  488.   palettes that come with OS/2.
  489.  
  490. * You may use the tilde (~) in your menu and item names to signify that the
  491.   character immediately following the tilde should be used as an
  492.   accelerator for accessing the respective menus or items.
  493.  
  494. * All changes made (time/date, bar position, menu contents, etc.) are saved
  495.   each time FileBar is closed (or the system is shutdown or an explicit save
  496.   operation is requested).  FileBar is restored to the state it was saved in
  497.   next time it is executed.  Changes are saved ONLY during these times.
  498.  
  499. * When editing menu items, you can drag WPS objects to the "drop area"
  500.   and FileBar will open that object when you select that item.
  501.  
  502. * When using FileBar as a WPS replacement, WPS features such as folders and
  503.   program objects are no longer functional.  Please remember this if you are
  504.   trying to open a WPS folder via FileBar when FileBar has replaced the WPS.
  505.  
  506. * The configuration information for the FileBar is stored in a file named
  507.   FILEBAR.INI (in the directory where FILEBAR.EXE is located) and may be
  508.   backed up by the user for added protection.  It is a strictly text file
  509.   and may be backed up by copying a valid FILEBAR.INI file to another, 
  510.   unused filename (ie: COPY FILEBAR.INI BACKUP.INI).
  511.  
  512.        -- It is recommended that you make a backup copy of --
  513.             your FILEBAR.INI on a regular basis!
  514.  
  515. * FileBar comes with two sample FileBar configurations, SAMPLE1.INI and
  516.   SAMPLE2.INI.  To try these out, copy one of them over your FileBar .INI
  517.   file (ie: COPY SAMPLE1.INI FILEBAR.INI).  NOTE!  This will overwrite your
  518.   current FileBar configuration and destroy the contents it currently has.
  519.   These contain samples for how to launch DOS windowed and full screen 
  520.   sessions, OS/2 windowed and full screen sessions, and Win-OS/2 windowed
  521.   and full screen sessions, among other things.  Refer to these for tips on
  522.   how to set up your own FileBar!
  523.  
  524. * If you wish to add items that launch OS/2 command shells (DOS windows,
  525.   DOS full-screens, WIN-OS2 sessions, etc.), see the SAMPLE1 or SAMPLE2
  526.   .INI files.  For OS/2 and DOS sessions, simply select what type of command
  527.   shell you would like (from application type section) and then leave the
  528.   Program Path empty.  That will start a command shell (DOS window, DOS
  529.   fullscreen, OS/2 window, and OS/2 fullscreen sessions).
  530.  
  531.   However, if you want to start a WINOS/2 windowed session, put PROGMAN.EXE
  532.   in the program path (it will start program manager for you).  If you want
  533.   to launch a fullscreen WINOS/2 session, put WIN.COM in the program path
  534.   section of the text.  (See SAMPLE1.INI or SAMPLE2.INI for details)
  535.  
  536.   Again, see the examples provided for the exact details on how to launch
  537.   command shells from FileBar.
  538.  
  539. * If you wish to make an item on one of your menus that is an OS2, DOS or 
  540.   WINOS2 session that has modified settings, follow the instructions
  541.   below:
  542.  
  543.   - For OS/2 sessions, go to the \OS2 directory and make a copy of CMD.EXE.
  544.     Make FileBar point to this new copy of the executable and mark it to
  545.     boot as a WPS program object.  Now, change the settings as you wish.
  546.  
  547.   - For DOS sessions, go to the \OS2\MDOS directory and make a copy of 
  548.     COMMAND.COM.  Make FileBar point to this new copy of the executable and
  549.     mark it to boot as a WPS program object.  Now, change the settings as
  550.     you wish.
  551.  
  552.   - For WINOS2 sessions, go to the \OS2\MDOS\WINOS2 directory and make a
  553.     copy of WIN.COM for fullscreen sessions or PROGMAN.EXE for windowed
  554.     sessions.  Make FileBar point to this new copy of the executable
  555.     and mark it to boot as a WPS program object.  Now, change the settings
  556.     as you wish.
  557.  
  558. * Since WPS settings are implemented to be tied to the executable of the
  559.   program that is being launched, if you need two or more programs with the
  560.   same settings, you will need to make a copy of that executable with a 
  561.   different name and give it different settings.  Command prompts work in
  562.   the same way.  (Simply make a copy of CMD.EXE or COMMAND.COM and name it
  563.   something differently.  Give it new settings and when you launched this
  564.   renamed object, it will come up with the new settings (if using use WPS
  565.   settings option)).
  566.  
  567.   Or, you may also leave the program path blank and just fill in the
  568.   program directory.  If you ensure that a settings.ini file resides in
  569.   the directory you specify, it will use it!  This way, you don't have to
  570.   make a copy of command.com/cmd.exe and you can still have settings!!
  571.  
  572. * Alarm tasks will NOT be active when editing individual alarm tasks.  In
  573.   simpler words, alarms are disabled when you are editing items that are
  574.   alarms.  This is to avoid conflict which may arise in having an item you
  575.   are editing go off when you don't want it to.
  576.  
  577. * FileBar has an hourly chime built in but if you would like a chime to go
  578.   off on the half of the hour as well (6:30, 7:30, etc), simply set up a
  579.   task that is 'sound only' and that will reschedule itself every hour.
  580.   Now, insert the .WAV sound file you want your chime to be, and you will
  581.   be all set.  The hourly chime will go off at the top of every hour and
  582.   this will go off at the middle of every hour.
  583.  
  584. * If you use the Float on Top/Auto-Sizing feature, this may cause FileBar to
  585.   remain visible during some screen saver program's activity.  If you find this
  586.   happens with the screen saver you use, simply disable the "Force on
  587.   Top/Auto-Sizing" feature.  Note that this will not affect the screen saver
  588.   program nor FileBar but if it does bother you, simply turn OFF the float
  589.   feature.
  590.  
  591.   (Also note:  Special code has been added with version 1.7 and later versions
  592.            of FileBar so that the interference caused by BocaSoft's WipeOut
  593.            has been remedied.  I have found no other screen saver that
  594.            causes problems for FileBar, but if you encounter one, please
  595.            contact me.)
  596.  
  597. * DOS settings are NOW supported when launching WIN-OS/2 applications
  598.  
  599. * If you are trying to get the most memory possible out of your computer, you
  600.   should refrain from using the background bitmap option.  Backgrounds use a 
  601.   fair deal of memory and you can save quite a bit of memory when not using
  602.   this option.
  603.  
  604. -------------------------------------------------------------------------------
  605.  
  606. == Registration ============
  607.  
  608. If you like FileBar, or perhaps, you enjoy having the complete source code
  609. for an OS/2 PM program to aid you in writing your own programs, I ask you to
  610. register your copy of the program.  The registration cost is only $10.00 and
  611. it will ONLY be with your support that I continue to develop for OS/2, 
  612. and especially, provide the complete source code for any of my works.
  613.  
  614. You can register your copy of FileBar with me for only $10.00.  Please send 
  615. your registration payment as a check or money order (US funds only) to:
  616.  
  617. If you are MAILING your registration BEFORE April 20, 1995, please send to:
  618.             Eric A. Wolf
  619.             498 Wiley Hall NW
  620.             West Lafayette, Indiana  47906-4223
  621.  
  622. Or, if you are MAILING your registration ON or AFTER April 20, 1995, send to:
  623.             Eric A. Wolf
  624.             1630 North Johnson Street
  625.             South Bend, Indiana  46628-2936
  626.  
  627. I want to encourage everyone to start writing applications for OS/2, no
  628. matter how simple or complex.  That is why I am providing the source code 
  629. with this program.  If you've never developed for OS/2 before, now is your
  630. time to start and you have this to look off of to get you going.
  631.  
  632. Please note, however, I provide the source code as-is and as a learning tool 
  633. for aspiring programmers.  Please do NOT modify the source code and re-release 
  634. an exact or similar product.  The source is provided solely as a learning 
  635. device.  The $10.00 registration fee is cheaper than any OS/2 programming 
  636. book and what I provide is a complete, functional OS/2 PM application and 
  637. ALL component source files that comprise it (how many books do that?)
  638.  
  639. If the response is good enough, and only if it is good enough, I will continue 
  640. to develop products and ship the source code along with them.
  641.  
  642. I will answer no questions about the source code of the program from an
  643. individual until a registration payment has been received.  Once registered,
  644. source questions can be directed to me via electronic mail only:
  645.         
  646.          internet:     ericwolf@expert.cc.purdue.edu
  647.  
  648. If you have general comments or questions about the program, you may also
  649. send the electronic address above.  Thanks!
  650.  
  651. -------------------------------------------------------------------------------
  652.  
  653. == Source Code ===========
  654.  
  655. This program comes complete with the entire source code that generated it.
  656. Please note the following restriction:
  657.  
  658.    FileBar's source code is to be modified by the author alone.  The source
  659.    code is provided as a learning tool ONLY!  No modifications may be made
  660.    to it to reproduce a same or similar product.  The copyright remains that
  661.    solely of the author and the program is protected under both United States 
  662.    and International Copyright Laws.
  663.  
  664. The complete source code for this program can be found in the SOURCE
  665. directory that was created when you uncompressed this program.  It was
  666. developed on Borland's C++ for OS/2.  A project file (FILEBAR.PRJ) has been
  667. provided to facilitate your working with these files.  Each source file
  668. is documented and you should review the code with some good OS/2 references
  669. in hand (PM references, API reference, etc.)  
  670.  
  671. -------------------------------------------------------------------------------
  672.  
  673. == Distribution of FileBar ========================
  674.  
  675. You are free to distribute FileBar to whomever and however you wish as long
  676. as the following conditions are satisified:
  677.  
  678.   -  FileBar should ALWAYS be distributed in its entirety.  This includes
  679.      all documentation, executables, and source files.  Under no circumstances
  680.      should FileBar be distributed without all of its original files.
  681.      Distribution of FileBar (in any way possible!) is strongly encouraged
  682.      both by individuals and software houses!
  683.  
  684.   -  FileBar's source code is to be modified by the author alone.  The source
  685.      code is provided as a learning tool ONLY!  No modifications may be made
  686.      to it to produce a same or similar product.  The copyright remains that
  687.      of solely the author and the program is protected under both United States 
  688.      and International Copyright Laws.
  689.  
  690.   -  If you use FileBar, you MUST register it (directions for doing so
  691.      preceeded this section of the text).  "Use" includes both the actual
  692.      use of the FileBar application program -or- using the source code 
  693.      as a reference for your own works.  If you use the source as a reference, 
  694.      please register your copy ($10.00 is cheaper than any book you can buy on
  695.      OS/2 programming and what is going to teach you as much??)  
  696.      
  697.   -  Government and site licenses can be granted at a discounted rate.  Please
  698.      inquire for more details.
  699.  
  700.   -  Remember, if you like the program (even if you don't care much for the 
  701.      source code) you should still register!!
  702.  
  703. -------------------------------------------------------------------------------
  704.  
  705. == Technical Support =================
  706.  
  707. If you would like to obtain the latest version of Filebar or Filebar add-on
  708. programs, need to ask a question directly the author, have feature requests 
  709. or a bug report, call Filebar's official support Bulletin Board System (BBS),
  710. Gaming 101, at (304) 363-2252. Once you have logged on, join the Filebar
  711. Support Conference and you will have access to the Filebar File Bases and
  712. Message Bases. Gaming 101 allows first call IMMEDIATE access to all FileBar
  713. support files and messages.
  714.  
  715. -------------------------------------------------------------------------------
  716.  
  717. == Revision History ========================
  718.  
  719. (The revision history from FileBar's inception to its current release is
  720.  contained in the HISTORY.TXT file that should have come with this archive
  721.  file...  Please contact the system administrator from the site in which you
  722.  obtained this archive if you did not receive it or any other FileBar files!)
  723.  
  724. -------------------------------------------------------------------------------
  725.  
  726.  
  727.   --------------------------------------------------------------------------
  728.   Remember if you like  FileBar and use  it or if you use or plan to use the
  729.     source code as a reference  for your own works, please register today!
  730.   --------------------------------------------------------------------------
  731.   My thanks to those of you who have registered!  I appreciate your support!
  732.  
  733.