home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / c1 / configplus / !Config+ / !Help < prev    next >
Encoding:
Text File  |  1996-11-09  |  7.3 KB  |  178 lines
  1.                                    ConfigPlus
  2.                                    ==========
  3.      
  4. Introduction
  5. ------------
  6.    One of the main advantages of using an Acorn computer as opposed to, say a
  7. Mac or a PC is the way in which almost the entire system can be patched an
  8. modified. If you've followed any of my programs you can probably see how
  9. useful this can be; filters, Wimp bypass routines vectors, service calls,
  10. upcalls and tasks which can communicate to help one another.
  11.    However, sometimes (only sometimes) you can see something which is
  12. destinctly unecconomical. The prime example of this is the text editor. So
  13. many applications require a text editor, from OLR's to code editors to
  14. compilers to display programs. Hence, the External Edit protocol was
  15. developed.
  16.    This is not it's story.
  17.    But it is similar…
  18.    
  19.    Once, there was a program called Configure. This came on a disc and could
  20. graphically set almost the entire system configuration. However as time
  21. passed and the facilities grew, Configure did not grow with them; it did
  22. eventually move into the ROM but decided that it much prefered the confines
  23. of the harddisc before eventually deciding that perhaps it had been mistaken
  24. and the ROM had been nice after all.
  25.    Whilst being a pretty story it doesn't explain much. Except…
  26.    Somewhere along the way, Configure found a friend in Sam Kington. Sam had
  27. created another program called Config+ which could help Configure keep up
  28. with the times. Config+ gave much more functionality to what was becoming an
  29. out-dated application.
  30.    Because of the features of RO3 Sam was able to patch Configure
  31. transparently so that all the original functionality remained, but new
  32. options were available.
  33.  
  34.    In the midst of this, another application called Config+ was being
  35. developed from scratch. The idea behind this third application was that if
  36. the code for configuring one part of the machine was identical to that for
  37. another part, then why split it up ? In fact, why seperate applications from
  38. Configure settings ? Why not instead build an engine which could drive all
  39. applications configure operations ?
  40.    And after speaking to Niall Douglas, Justin decided that perhaps a textual
  41. configuration description file would make life so much easier.
  42.    Thus, the modular configuration application Config+ was born.
  43.    
  44.  
  45. Usage
  46. -----
  47.    Hmm. I'm not really sure if I should explain this.
  48.    It's easy.
  49.    Run it.
  50.    Click the icons.
  51.    OK on the main window means close window
  52.    Save means Save all CMOS settings. Reload them by double clicking a saved
  53. file, or dragging it to the ConfigPlus icon. Note: This loads all
  54. configuration settings, unlike Configue.
  55.    OK on module windows means confirm settings.
  56.    If you don't understand something, use !Help. If you still don't
  57. understand it then the author probably doesn't either, so I should leave the
  58. option.
  59.  
  60.     
  61. How it works
  62. ------------
  63. Right, now for a description of the routines which modules should use to
  64. interface with the Config+ hub refer to either the Impression document
  65. Help.Instruct, or for preference (ie it's more up to date) the StrongHelp
  66. manual Help.ConfigPlus
  67.  
  68. The whole application is based around the use of Basic Libraries for the
  69. individual configuration programs (called modules). These libraries are
  70. loaded and controlled by the main !RunImage file which is termed the hub
  71. (because everthing revolves around it). The hub deals with creating windows
  72. and icons and dealing with mouse clicks, help requests and menus before
  73. passing them on to the appropriate module. Therefore, the modules only have
  74. to worry about the setting of their options and updating the windows.
  75.  
  76. All the window movement, including pane movement and resizing is dealt with
  77. by the hub and the modules never need to worry about any part of the actual
  78. wimp operations unless they wish to load or save data via the wimp interface
  79. (saving currently under development).
  80.  
  81. Note also that if the tool sprites change so do the panes. At least, if the
  82. Wimp broadcasts the correct message they ought to.
  83.  
  84. Note: I would have liked to use Overlays, but it seems that I cannot add
  85. modules at any old time to the array as the space needs to be reserved prior
  86. to any switching. Otherwise, this would be a perfect use for them.
  87.  
  88.  
  89. Help and message files
  90. ----------------------
  91. This application is fully !Help compliant and it is recommended that when
  92. getting to grips with it the help should be used if only to give it some
  93. purpose! It also supports the use of MessageTrans and therefore translation
  94. to another language or changing the messages for the fun of it is much easier
  95. than it might have been.
  96.  
  97.  
  98. <BasicLibrary$File>
  99. -------------------
  100. This application requires Justin Fletcher's JFShared library to function.
  101. This can be obtained from Arcade and possibly other bulletin boards. A
  102. version is currently being carried by Hensa, but for the latest version you
  103. would be best off looking at Justin's web page (see below), or contacting him
  104. by one of the other means below.
  105.  
  106.  
  107. Compatibility
  108. -------------
  109. This application has been tested on the author's A5000, but due to the lack
  110. of friends with Acorns has not been tested on other systems. Therefore, it
  111. ought to work on any RO3.1 machine, and with a RO2 machine if it is
  112. recognised in JFShared and uses no specific RO3 features.
  113.  
  114.  
  115. Disclaimer
  116. ----------
  117. The author accepts no responsibility for any problems which this application
  118. may cause or loss of data resulting in its use. This application is Public
  119. Domain Freeware. This means that it may be distributed, so long as no charge
  120. other than copying costs are charged for it. The copyright remains with
  121. myself (Justin Fletcher).
  122.  
  123.  
  124. Contact
  125. -------
  126. Any comments, queries, donations or bug reports can be sent to Justin
  127. Fletcher at :
  128.  
  129. E-Mail : Gerph@essex.ac.uk
  130. URL    : http://users.essex.ac.uk/users/gerph
  131. IRC    : On #Acorn as Gerph
  132. Finger : finger jrflet@postman.essex.ac.uk
  133. Tel    : (01842) 813979
  134.  
  135. Snail Mail :
  136.     Justin Fletcher
  137.     “Galadriel”
  138.     17b Cromwell Road,
  139.     Weeting,
  140.     Brandon,
  141.     Suffolk.
  142.     IP27 0QT
  143.  
  144.  
  145. History
  146. -------
  147. Version 1.00 : 08 Jan 1995
  148.                First version written
  149. Version 1.01 : 06 May 1995
  150.                Added facilities to alter external status files
  151. Version 1.02 : 07 May 1995
  152.                Added status file facilities
  153.                Updated manual to current specification
  154. Version 1.03 : 29 Jun 1995
  155.                Added panes to configuration windows
  156. Version 1.04 : 12 Aug 1995
  157.                More modifications for opening pane windows.
  158. Version 1.05 : 14 Aug 1995
  159.                Modules information window, and module improvements involved
  160. Version 1.06 : 17 Aug 1995
  161.                ConfigPlus command added to access program externally
  162. Version 1.07 : 10 Sep 1995
  163.                Proportional bars added
  164.                Scroll bars added
  165.                Null, B and C sprites
  166.                Tool changes
  167. Version 1.08 : 27 Sep 1995
  168.                Load icon, documentation in StrongHelp manual.
  169.                Save button now does something other than look good!
  170.                Adjust size icon added to panes
  171. Version 1.09 : 11 May 1996
  172.                Hourglass whilst loading modules
  173. Version 1.10 : 03 Sep 1996
  174.                A few more modules added, taking the total up to 11 now.
  175. Version 1.11 : 17 Oct 1996
  176.                ConfigPlus_SettingsSaved message added, for notifying
  177.                applications that their configuration has changed.
  178.