home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / bubpd103.zip / Readme < prev   
Text File  |  1998-11-16  |  10KB  |  311 lines
  1. Bubblepad V 1.03 (c) Chris Wohlgemuth 1997-98
  2. ----------------------------------------
  3.  
  4. Contents
  5. -------
  6. 0. Licence
  7.  
  8. 1. Overview
  9.  
  10. 2. Installation
  11.  
  12. 2b. Setup strings
  13.  
  14. 3. Deinstallation
  15.  
  16. 4. Usage
  17.  
  18. 5. Compiling
  19.  
  20. 6. History
  21.  
  22. 7. Known Problems
  23.  
  24. 8.  Author
  25.  
  26. -----------------------------------------
  27.  
  28. 0. Licence
  29. ------
  30. This package is provided 'as is' under the Gnu Public 
  31. Licence (GPL) and GNU Public Library Licence (GPLL) respectively.
  32. See the file 'Copying' fo further information.
  33.  
  34.  
  35. 1. Overview
  36. -------
  37. Welcome to Bubblepad V 1.03, a replacement class for the
  38. launchpad of OS/2 Warp 3 and above. This new class provides
  39. bubblehelp for all the buttons of your launchpad. With this
  40. enhancemant it is possible to distinguish all the 40 folders on
  41. the launchpad, which have all the same icon. Never click a
  42. wrong button again.
  43. Further more the class reduces the size of the launchpad by 
  44. reducing the distance between buttons and the size of the borders.
  45.  
  46. NEW with V1.02:
  47. New with that release is an option to remove the drawer buttons.
  48. Individual settings for different launchpads are possible now.
  49. No more flickering when opening drawers. The state of drawers
  50. is saved on schutdown. Reopening on next boot.
  51.  
  52. NEW with V1.03:
  53. See file changes.
  54.  
  55. Full online help is provided but I don't think you really need it. 
  56. All Features are selectable.
  57.  
  58. The package contains a german and an english version of the
  59. DLL and the help file. Feel free to translate the resource file
  60. and the strings in the file 'inst.cpp' and compile.
  61. If you send me the translations I put it together and compile 
  62. a new distribution.
  63.  
  64. You can find the Bubblepad homepage at
  65.  
  66.    http://www.geocities.com/SiliconValley/Sector/5785/bubblepd.htm
  67.  
  68.  
  69. 2. Installation
  70. ---------
  71. Unzip the files into a temporary directory but keep the
  72. directory structure! The installation program assumes this
  73. directory structure and gets probably confused if something
  74. is different.
  75.  
  76. The package contains the following files:
  77.  
  78. \Readme                        this file
  79. \FILE_ID.DIZ                     short description of the program
  80. \install.exe                     installation program
  81. \COPYING                      READ THIS FIRST
  82. \Changes
  83. \LPReplace.exe                 Utility to replace WPLaunchPad
  84. \source\bubblepd.ico
  85. \source\bubblepddeutsch.ipf
  86. \source\bubblepdenglish.ipf
  87. \source\deutsch.rc
  88. \source\english.rc
  89. \source\inst.cpp
  90. \source\inst.def
  91. \source\makefile
  92. \source\bubblepd.cpp
  93. \source\bubblepd.def
  94. \source\bubblepd.hh
  95. \source\bubblepd.h
  96. \source\lpreplace.cpp
  97. \Deutsch\BUBBLEPD.DLL
  98. \Deutsch\bubblepd.hlp
  99. \English\BUBBLEPD.DLL
  100. \English\bubblepd.hlp
  101.  
  102. FIRST OF ALL MAKE COPIES OF YOUR INI FILES!!
  103. I don't think it is really necessary but during installation the
  104. program registers a new WPS-class and it is always a
  105. good idea to have a backup of the ini files if anything goes
  106. wrong. You know, Murphy never sleeps...
  107.  
  108. If you are running an older version of BubblePad deinstall it first and
  109. restart the WPS.
  110.  
  111. Run the installation program 'install.exe'. After choosing the
  112. language you can select install, deinstall or exit.
  113. After selection of install you can choose the destination
  114. directory for the DLL. After copying the files, registering the
  115. new class and replacing the original launchpad class WPLaunchPad
  116. you must restart the WPS, so the changes can take effect. 
  117.  
  118. If you want to perform a customized installation, you can use
  119. REXX together with setup strings for the BubblePad features.
  120. Refer to the section 2b. for further information about the supported
  121. setup strings.
  122. For step by step installation do the following:
  123.  
  124. 1. Copy BUBBLEPAD.DLL to a directory of your choice.
  125.    Use the NLS-version you prefer.
  126. 2. Copy BUBBLEPAD.HLP to your help directory.
  127.    Use the NLS-version you prefer.
  128. 3. Register the new WPS-class WPLnchCW using REXX.
  129. 4. Use 'LPReplace 1' to replace the original Launchpad class
  130.    with WPLnchCW.
  131. 5. Restart the WPS
  132.  
  133.  
  134. 2b. Setup strings
  135. --------------
  136. With version V1.03 setup strings are supported for the bubblepad
  137. features so automatic installation using REXX is possible.
  138.  
  139. The following additional setup strings are supported:
  140.  
  141. LPNODRAWERS=1
  142.  
  143.    Hide the drawer buttons. The default is not to hide the buttons.
  144.  
  145. LPSMALL=0
  146.  
  147.    Disable resizing of the Launchpad. With this option LPNODRAWERS
  148.    has no effect. If omited the default is ENABLED.
  149.  
  150. LPDISTANCE=4-18                  
  151.  
  152.    Choose the distance of buttons on the pad. Possible values are 4-18.
  153.    The default value is 4. 
  154.  
  155. LPREOPENDRAWERS=1
  156.  
  157.    If set drawers are reopened on next boot. The default is disabled.
  158.  
  159. LPACTIONBUTTONS=1+2+4+8
  160.        
  161.    Enable each actionbutton. The value of this key is calculated by
  162.    adding the values of the actionbuttons:
  163.  
  164.    Shutdown:     1
  165.    Lock:          2
  166.    Windowlist:   4
  167.    Search:        8
  168.  
  169.    Example:
  170.             If you want to enable the lock button and the search button
  171.             use LPACTIONBUTTONS=10 (the key is decimal!).
  172.  
  173.    The default is to enable all action buttons.
  174.  
  175. LPBUBBLE=0
  176.  
  177.    Disable the bubblehelp. The default is ENABLED. 
  178.  
  179. LPDELAY=0-9999
  180.  
  181.    The delay for the help window. Choose values between
  182.    0 and 9999ms. The default is 250ms.
  183.  
  184. LPBGCOLOR=RGB
  185.  
  186.    Choose the background color of the help window. The value
  187.    is calculated in the following way:
  188.  
  189.    LPBGCOLOR=65536*R+256*G+B
  190.  
  191.    Be sure to use a decimal value. The default is a bright yellow.
  192.  
  193. LPFGCOLOR=RGB
  194.  
  195.    Choose the Foreground color of the help window.  The value
  196.    is calculated in the following way:
  197.  
  198.    LPFGCOLOR=65536*R+256*G+B
  199.  
  200.    Be sure to use a decimal value. The default color is black.
  201.  
  202.  
  203. Here's an example how to use setup strings:
  204.  
  205. ------------------------------------------------
  206. /* rexx - create Bubblepad */
  207.  
  208. call RxFuncAdd 'SysCreateObject','RexxUtil', 'SysCreateObject'
  209.  
  210. IF SYSCreateObject("WPLnchCW","Setup-Test","<WP_DESKTOP>","LPACTIONBUTTONS=8;LPNODRAWERS=1;LPREOPENDRAWERS=1","replace") THEN
  211.    Say 'OK. New Bubblepad created.'
  212. ------------------------------------------------
  213.  
  214. This example creates a new Bubblepad with only the search-button.
  215. The drawer buttons are hidden and the drawers are reopened on next
  216. reboot.
  217. This script works even if you haven't replaced WPLaunchPad with the
  218. new BubblePad-class WPLnchCW. If the replacement is in effect you
  219. can use WPLaunchPad as the classname.
  220.  
  221.  
  222. 3. Deinstallation
  223. -----------
  224. Run the installation program again and choose deinstall.
  225. The program deregisters the class and deletes all files.
  226. You have to reboot to finish deinstallation.
  227.  
  228. With REXX you can do the following:
  229.  
  230. 1. If you've replaced the original Launchpad class run
  231.    'LPReplace 0'. This will unreplace the class.
  232. 2. Deregister the class WPLnchCW using REXX.
  233. 3. Restart the WPS
  234. 4. Delete BUBBLEPAD.DLL and BUBBLEPAD.HLP
  235.  
  236.  
  237. 4. Usage
  238. -----
  239. The new class inserts four pages into the settings notebook.
  240. Two pages are for customizing the bubblehelp. It's possible to
  241. chose the colour of the bubble and the font. The delay is 
  242. adjustable, too. Changing colour and font is done by using the
  243. color and font palettes inside the configuration folder. You can
  244. open these palettes directly from the settings notebook by
  245. clicking on the appropriate buttons.
  246. On the third Option page you can disable each action button.
  247. Another options page let you choose if you want to minimize
  248. the size of the launchpad. The new distance of the buttons is
  249. adjustable.
  250. You have an option to remove the drawer buttons with V1.02
  251. and above. All settings are individual for every launchpad in
  252. the system.
  253.  
  254. Full online help is provided for the new settings pages.
  255.  
  256.  
  257. 5. Compiling
  258. --------
  259. Full source code is provided with this package. For compiling of
  260. the replacement class you need VAC++3.0 and the Warp 3 Toolkit
  261. (both from IBM, commercial). The install program is compiled
  262. with emx V0.9b, the OS/2 version of the free GCC compiler.
  263.  
  264. It's assumed that both compilers are properly installed.
  265.  
  266. 1. Create a new directory e.g. x:\bubblepad
  267. 2. Copy the directory 'source' of this package to the new directory.
  268. 3. cd x:\bubblepad\source
  269. 4. run 'nmake', the make utility of VAC++. That's all.
  270.  
  271. Run 'nmake clean' in the source directory to delete all temporary files.
  272. If you want to install directly after compiling run 'nmake install'. 
  273. This changes the directory and runs the installation program.
  274.  
  275.  
  276. 6. History
  277. ------
  278. See file 'Changes'. 
  279.  
  280.  
  281. 7. Known problems
  282. -------------
  283. With OS/2 Warp 4 (no FP) sometimes the WPS doesn't start. It loads
  284. the background picture and stops with the wait pointer. It's the same
  285. problem known with the warpcenter. Try a fixpack solving the
  286. warpcenter problem or as a workaround put the statement 
  287. SET RESTARTOBJECTS=NO in your config.sys.
  288. Remove the statement LAUNCHPAD from the AUTOSTART line. 
  289.  
  290. The state of open drawers is only saved on shutdown. So drawers are
  291. not reopened when the launchpad is closed and then reopened. 
  292.  
  293.  
  294. 8. Author
  295. -----
  296. (c) Chris Wohlgemuth 1997-98
  297.  
  298. Feel free to comment and enhance. You can reach me
  299. via E-Mail:
  300.  
  301. christopher.wohlgemuth@bch.siemens.de
  302. chris.wohlgemuth@cityweb.de
  303.  
  304. You can find the Bubblepad homepage at
  305.  
  306.    http://www.geocities.com/SiliconValley/Sector/5785/bubblepd.htm
  307.  
  308.  
  309. If you send me any enhancements or translations, I incorporate them
  310. into the distribution. 
  311.