home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / misc / configplus_1 / !ConfPatch / !Help < prev    next >
Text File  |  1995-01-06  |  4KB  |  73 lines
  1. Configure+ patcher
  2. Version 1.00 © Sam Kington September 1994
  3. See Configure+ documentation for more info
  4.  
  5. About this program
  6. ******************
  7.  
  8.    This program will add Configure+’s stuff to the standard Configure resources
  9. – Sprites, Sprites22, Templates and Messages. This is necessary for two
  10. reasons:
  11.    • There are (at least) two major versions of Configure, for respectively
  12.      RISC OS 3.1 (A5000 and later, and upgraded machines) and RISC OS 3.5
  13.      (RISC PC only). The windows and messages are quite different.
  14.    • Because Configure is © Acorn Computers Ltd., I cannot legally distribute
  15.      modified versions of the files. I *can*, however, use a program to patch
  16.      the files you already have.
  17.      
  18. How it works
  19. ************
  20.  
  21.    When you run the application, it will put up a window where you should
  22. drag the directory or application that contains Configure's files. For RISC OS
  23. 3.10 users this should be Resources:$.Resources.Configure, for RISC OS 3.50
  24. users this should be something like $.!Boot.Resources.!Configure – in other
  25. words, either a directory in the Resources filing system for RISC OS 3.10, or
  26. the main !Configure application itself for RISC OS 3.50.
  27.  
  28.    Once you’ve dragged the application to the window, it will be replaced by
  29. another window, where you should select the version of RISC OS you’re running
  30. – it should be correct, but if for some reason it isn’t you can change it.
  31. Clicking on “OK” will start the patching business. The first window will
  32. reappear, and will be continuously updated to show you what the program is
  33. doing. In addition, while it’s patching the windows (i.e. most of the time),
  34. the currently-patched window will be displayed on the screen. The hourglass
  35. percentage should give a pretty good idea of how much is left to do.
  36.      
  37. Which versions will it patch?
  38. *****************************
  39.  
  40.    Most programs that patch a module or something (Filer+, KeyMouse et al)
  41. will only work on one particular version of a module. Not only does this
  42. patcher support two versions, but because it is intelligently adding things
  43. to files rather than inserting code at a certain position, it will probably
  44. work with other versions as well.
  45.  
  46.    It has been tested with version 1.41 (14 April 1992), the RISC OS 3.10
  47. version, and with version 1.62 (25 February 1994), the RISC OS 3.50 version,
  48. running on a RISC OS 3.10 machine. If you are *not* running NewLook on RISC
  49. OS 3.10 – if the windows are all 2D and nasty, in other words – then the
  50. icons will not be aligned properly, but the program should still work, sort
  51. of. (I have no great plans to fix this bug: there are fewer and fewer people
  52. out there who have 2D windows and have RISC OS 3.1, and I think they’re wrong
  53. ;-). Most people with 2D windows also have RISC OS 2, and this won’t work on
  54. RISC OS 2 anyway). Otherwise I would be very surprised if this didn’t work on
  55. RISC OS 3.10 and RISC OS 3.50.
  56.  
  57.    I don't know how many intermediate versions are floating around (RISC OS
  58. 3.11, German RISC OS 3.15, etc.) and if they are any different – I think
  59. I’ve catered for the two main versions. The only real problem is if the
  60. number of icons in the main window (“Configuration”) is different – you might
  61. think there are only 12 icons in the window, but Acorn has a nasty habit of
  62. pushing old icons off to one side without actually deleting them. When
  63. ConfPatch patches the Messages file it assumes there will be a certain number
  64. of icons in the window; if it gets it wrong, interactive help will not work
  65. properly. If you know what you’re doing you can modify the Messages file (the
  66. added messages are at the end of the file), but it’s not *that* important to
  67. warrant a full explanation here.
  68.      
  69. Miscellanea
  70. ***********
  71.  
  72.    Yes, I know that the !Sprites23 aren’t monochrome (they’re the same as
  73. !Sprites22) but Acorn’s !Sprites23 aren’t all monochrome either...