home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / w / wptool05.zip / WPSBKP.TXT < prev    next >
Text File  |  1993-01-21  |  9KB  |  216 lines
  1.                          === DISCLAIMER ===
  2.  
  3.  
  4. I allow you to use and distribute WPSBKP and WPSREST freely under the 
  5. condition that I am in no way responsible for any damage or loss you 
  6. may suffer. 
  7.  
  8. Henk Kelder, Fidonet 2:512/47.339
  9.  
  10.  
  11.  
  12.            === IMPORTANT - READ THIS FIRST !===
  13.  
  14. You should take care when using this program on new versions of
  15. OS/2 since this program interprets data from the ini-files. 
  16. The internal structure of this data can change, and the
  17. program might fail or even corrupt information
  18. This was the case with the new OS/2 2.00.1 (or 2.01) version as well
  19. as the Service Pack release in october 1992.
  20.  
  21. The best way to test this is run checkini WITHOUT the /C option! 
  22. (Optionally use the /W option to write out all checkini's findings and 
  23. inspect the logfile)
  24. If Checkini reports un unusual amount of errors, the internal structure of
  25. the workplace shells data inside the ini-files might have changed. 
  26. Look in CHECKINI's logfile at the  
  27. "PM_Abstract:Objects & PM_Abstract:FldrContents" section with special care.
  28. If this section contains a lot of errors while your workplace shell seems to
  29. function properly there might have been a change, so:
  30.  
  31.          DO NOT USE CHECKINI.EXE or WPSBKP.EXE then!
  32.          ===========================================
  33.  
  34. (see DANGER.TXT about this)
  35. Note: The warning above does not apply to WPSREST.EXE and COPYINI.EXE!
  36.  
  37.  
  38.  
  39.  
  40.                   === NOTES ON WPSBKP & WPSREST ===
  41.  
  42.  
  43. DESCRIPTION:
  44.  
  45. WPSBKP.EXE and WPSREST.EXE are two programs that allow you to partially
  46. backup you workplace shell. Whenever you have to reinstall you desktop by
  47. either recreating the ini using MAKEINI or by re-installing OS/2 you can
  48. use the WPSREST program the recreate all your WPProgram and WPShadow objects.
  49.  
  50.  
  51. The approach I took is different from the WPSBKx.ZIP package found on 
  52. several BBS's. 
  53. The WPSBKn.ZIP program by Dave Lester actually makes copies of OS2.INI 
  54. and OS2SYS.INI and saves all extended attributes of files on the desktop
  55. (anyway WPSBK4 did this).
  56.  
  57. The programs in this package only backup's WPProgram and WPShadow objects 
  58. since these objects are mainly the things one adds to the WPS when 
  59. customising the desktop. 
  60. WPSBKP.EXE also backup's MOST, but not all, information of the folders
  61. these objects are located in. A folders background, sort options and some
  62. other things are not saved.
  63.  
  64. WPSBKP.EXE creates a text file (WPSBKP.DAT) the contains the instructions
  65. to recreate the objects mentioned above. This text file can be inspected
  66. or modified, and can be used by WPSREST to recreate program and shadow 
  67. objects. Also, all icons you have assigned to the objects are saved.
  68.  
  69. You are advised to run WPSBKP in a empty directory.
  70.  
  71.  
  72. WPSREST allows you to specify a alternate input file. If you do not specify
  73. an input file, WPSBKP.DAT in the current directory is used as default.
  74.  
  75.  
  76.                 === FURTHER INFORMATION ===
  77.  
  78.  
  79. When WPSBKP extracts information from your, all objects that do not have an
  80. unique OBJECTID are assigned one (after confirmation by the user). 
  81. An OBJECTID is a kind of reference to an object (e.g. <WP_DESKTOP> 
  82. for the desktop). 
  83. It is possible that there is a problem with these object id's:
  84. sometimes two objects contain the same objectid. WPSBKP will report 
  85. these problems: 
  86.  
  87.    PROBLEM: <objectid> is also in use by object: xxxxx.
  88.  
  89. When restoring the objects the WPSREST program checks for these OBJECTID's. 
  90. If an object with a given OBJECTID exists, only the settings are applied 
  91. to it, if it does not exist, you are asked if you want to create the object.
  92.  
  93. If a shadow object points to an abstract object (not a file or directory)
  94. and this abstract object does not have an unique OBJECTID, the shadow will
  95. NOT be backup'd. This will be reported.
  96.  
  97.  
  98. When you run the WPSREST program you must make shure you have no open
  99. folders or other objects. In some cases your system will hang when WPSREST
  100. tries to apply settings to open folders. This is due to a bug in the WPS:
  101.  
  102.  
  103.         WinSetObjectData(hObject, "ICONVIEW=FLOWED,NORMAL,VISIBLE");
  104.         will hang you PC when applied to an open folder.
  105.  
  106. NOTE: This problem is solved in the 'service pack' dated october 1992.
  107.  
  108.  
  109. WPSBKP does also save the icon position for objects on the desktop, 
  110. but not for objects in other folders. However these iconpositions are only
  111. handled properly when recreating the object and not when the object still
  112. exists. So you can NOT use WPSBKP as a backup-tool for you icon positions. 
  113. The same applies to the font information for folders.
  114. This is due to a bug (??) in the WPS:
  115.  
  116.         WinSetObjectData(hObject, "ICONPOS=x y") 
  117.         WinSetObjectData(hObject, "ICONFONT=8.Helv")
  118.           
  119.         are not processed for existing objects.
  120.  
  121. NOTE: Part of this problem (the font) is solved in the 'service pack' 
  122.       dated october 1992.
  123.  
  124.  
  125. If you have added objects and have not shutdown your system before making a
  126. backup it is possible that some settings are not extracted properly. This 
  127. because WPSBKP uses information in your ini-files and some values are only
  128. written to it when you shutdown. This applies aspecially to the ICONPOS. If
  129. WPSBKP cannot find a icon position for an object on the desktop, it will
  130. report so.
  131.  
  132.  
  133.  
  134. For WPSREST to work best, you should have installed the SOMFIX patch dated
  135. September 4, 1992. This patch solves a problem in the WinSetObjectData call
  136. the would not allow a setting string to be longer than 255 characters.
  137. Also, installing the service pack for OS/2 2.0 from october 1992, solves 
  138. this problem.
  139.  
  140.  
  141. CORRECTIONS in version 0.91:
  142.  
  143. o   In this version a problem has been corrected that ICONPOS setting was not
  144.     added for objects on the desktop other than WPFolder.
  145.  
  146. o   Another problem was that when restoring a WPShadow object for a folder, 
  147.     the TITLE=xxxx setting made that the original folder name was renamed.
  148.     The program than hung the desktop. This has been corrected so that a 
  149.     WPShadow object does not contain a TITLE=xxxx setting. Also when
  150.     restoring objects, a existing WPShadow object is not updated.
  151.  
  152. o   WPShadow objects are always backuped last.
  153.  
  154. o   Performance has been improved.
  155.  
  156.  
  157. CHANGES in version 0.92:
  158.  
  159. o   WPSBKP now accepts a directory name as parameter. This directory must
  160.     exist and is used to place the backup information in. If no parameter
  161.     is specified the current directory is used.
  162.  
  163. o   WPSBKP prompts the location where the backup information will be placed
  164.     and the user must confirm this with a 'Y'.
  165.  
  166. CHANGES in version 0.94:
  167.  
  168. o   WPSBKP now support OS/2 2.00.1 (beta version)
  169.  
  170. o   Since the needed PROGTYPE strings for WINOS231 (OS/2 2.00.1) programs 
  171.     are unknown WINOS231 programs will backup as WINOS2 (3.0) programs.
  172.  
  173. o   Template WPProgram objects are no longer backup'd.
  174.  
  175.  
  176. CHANGES is version 0.96:
  177.  
  178. o   WPSBKP now works properly after installing the october '92 service pack
  179.  
  180. CHANGES is version 0.97:
  181.  
  182. o   In some occasions a problem could occur that multiple objects have the
  183.     same OBJECTID assigned. WPSBKP now assigns a new OBJECTID id to the
  184.     object that incorrectly claims to have a duplicate OBJECTID.
  185.  
  186. o   Updated the documentation files (this file)
  187.  
  188. o   When creating the text file (WPSBKP.DAT) an existing version of this
  189.     file will be renamed to WPSBKP.OLD.
  190.  
  191. o   A simple test has been build in to see if OBJECTID's can be found
  192.     in the ini-files, to determine if the internal data structure of the
  193.     ini-files might have been changed and WPSBKP will fail completely.
  194.     This is however no guarantee that WPSBKP will function properly on
  195.     new versions of OS/2 2.0.
  196.  
  197. o   Whenever WPSBKP wants to assign an OBJECTID to an object, the user 
  198.     will be prompted for a confirmation to assign this OBJECTID to the 
  199.     object. Whatever the reply is, the new OBJECTID is always written to
  200.     the backup file.
  201.  
  202. CHANGES in version 0.98:
  203.  
  204. o   Due to an error in the OS/2 2.0 Toolkit the ICONVIEWPOS (size and
  205.     position of a folder) was incorrectly backup'd.  The positions were
  206.     backup's as ICONVIEWPOS=x1,y1,x2,y2 while they should have been backup'd
  207.     as ICONVIEWPOS=x,y,cx,cy (xpos, ypos, widht, height) in percentages.
  208.  
  209. CHANGES in version 0.99:
  210.  
  211. o   Trailing spaces in DOS settings and Objecttitles are removed
  212.  
  213. o   WIN-OS/2 3.1 program types are backup'd properly. (OS/2 BETA 2.1). 
  214.     So the problem mentioned with version 0.94 no longer exists.
  215.  
  216.