home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 4 / AUCD4.iso / utils / programing / silofer / !Siolfer / !Help next >
Text File  |  1998-08-28  |  8KB  |  178 lines
  1. ==========================================================================
  2.                         _____ _       ______
  3.                        / ___/(_)___  / / __/__  _____
  4.                        \__ \/ / __ \/ / /_/ _ \/ ___/
  5.                       ___/ / / /_/ / / __/  __/ /
  6.                      /____/_/\____/_/_/  \___/_/
  7.  
  8. v.1.17 (28-Aug-1998)                                         Iain Truskett
  9. ==========================================================================
  10. Contents
  11.  
  12.  (1) Overview
  13.  (2) How to use
  14.  (3) Obtaining Updates
  15.  (4) Versions
  16.  (5) Contacting the Author
  17.  (6) Credits and Thanks
  18.  (7) Disclaimer
  19.  (8) Licence Conditions
  20.  
  21. ==========================================================================
  22. /// 1. Overview
  23. ==========================================================================
  24.  
  25. A program which  merely exports configuration settings.  It can save  them
  26. into the Boot sequence of  a machine utilising Acorn new  !Boot structure.
  27. It can  save the  Config files  as  Utilities which  can later  be run  by
  28. themselves to set the  configuration. It can also save as  a normal Config
  29. file. Its final feature is that it can load CMOS files.
  30.  
  31. Other useful and related programs by the same author:
  32.    + SaveCMOS, a command  line based utility which  can save both  Utility
  33.      and Config style CMOS files.
  34.    + SaveCMOS, a  desktop based  program which behaves  just like  Acorn's
  35.      program by the name !SaveCMOS, except that mine utilises the features
  36.      of the new !Boot structures.
  37.    + ViewCMOS, a  program which,  when given  a Config  file, gives you  a
  38.      report that is identical  to what you would get if  you typed *Status
  39.      with that Config file loaded into CMOS.
  40.    + LoadCMOS, a  command line based utility which  loads in Config files.
  41.      Written because Acorn's program  of the same name didn't appear to do
  42.      it properly.
  43.  
  44.  
  45. ==========================================================================
  46. /// 2. How to Use
  47. ==========================================================================
  48.  
  49. Run it.
  50.  
  51. To load a Config file:
  52.    + Drag a Config file onto the icon bar icon and it will load it.
  53.  
  54. To save a Config/Utility:
  55.    + Click MENU over the icon bar icon and use the standard  Save dialogue
  56.      boxes from the menu.
  57.  
  58. To save into !Boot:
  59.    + Click MENU over the icon bar icon and click on 'Save inside !Boot'.
  60.  
  61. Other than those, it doesn't really do a lot.
  62.  
  63. ==========================================================================
  64. /// 3. Obtaining Updates
  65. ==========================================================================
  66.  
  67. Either mail me, or join the mailing list.
  68.  
  69. The mailing list is a mailing list to which all notices of software update
  70. are posted. Usually a  very low volume mailing  list you should note.  One
  71. can join  this list by mailing koschei@ozemail.com.au and requesting to be
  72. placed on it.
  73.  
  74. ==========================================================================
  75. /// 4. Versions
  76. ==========================================================================
  77.  
  78.  * 0.01 (19-Apr-1998)
  79.    * Exports Config files. And it does it very nicely.
  80.  * 0.02 (19-Apr-1998)
  81.    * Exports Utility and !Boot-appropriate files.
  82.    * Loads Config files.
  83.  * 0.03 (21-Apr-1998)
  84.    * Modified to  work  on  RISC  OS  3.1 and  above  with  various  !Boot
  85.      structures.
  86.    * Which means  that  on machines  with RiscPC600Mk1  boot  applications
  87.      (supplied   with  RISC   OS   3.5),   the  CMOS   is   saved   inside
  88.      <Boot$ToBeLoaded>  as  'SavedCMOS'  when one  clicks  on  'Save  into
  89.      !Boot', which looks like:
  90.          ADFS::Sigma.$.!Boot.Choices.Boot.Predesk.SavedCMOS
  91.    * If the system uses Acorn's  boot structure, as released with RISC  OS
  92.      3.6, 3.7  and on their  beta CD,  then it  will be saved  in the  PRM
  93.      recommended place of:
  94.          <Boot$Dir>.MchConfig.<Boot$Unique>.!RO<Boot$OSVersion>CMOS
  95.      Which usually resolves to something like the following:
  96.          ADFS::Sigma.$.!Boot.MchConfig.Local.!RO360CMOS
  97.    * The choice of which to use out of the above is determined  by whether
  98.      or not the system variable Boot$Unique exists or not.  Whether or not
  99.      the 'Save into  !Boot' option is selectable  or not is  determined by
  100.      whether or not Boot$ToBeTasks exists or not.
  101.    * Renamed to Siolfer. Why? I've too many programs called 'SaveCMOS'.
  102.  * 0.04 (9-Jul-1998)
  103.    * Previous versions were written  in BASIC Assembler. This version  has
  104.      been written in extASM Assembler. Due to this, the file size has been
  105.      reduced by  around 400 bytes.  No functions  have been impaired,  and
  106.      some code redundancies have been removed.
  107.    * Help file reformatted to 74 columns.
  108.  * 0.05 (14-Jul-1998)
  109.    * Source tidied, commented a bit more. Output made a bit smaller.
  110.    * Little things.
  111.    * Reversed load and  save order which saved  an instruction by  putting
  112.      the 'S' flag  on the subtract operation.  Program now stands at  1212
  113.      bytes
  114.  * 0.06 (15-Jul-1998)
  115.    * Code optimised in some places. Resulted in code size now  1180 bytes.
  116.      May reach 0  bytes by  the millennium. [ie  be rendered redundant  by
  117.      Acorn including the relevant bits in the operating system].
  118.  * 1.17 (28-Aug-1998)
  119.    * Major stack bug fixed.
  120.    * Neatened up for AUCD.
  121.    * I lost track of numbers for a bit and just counted the last number of
  122.      additions.
  123.    * Code at 1214 bytes, including a version string =)
  124.  
  125. ==========================================================================
  126. /// 5. Contacting the Author
  127. ==========================================================================
  128.  
  129.    - email
  130.      - koschei@ozemail.com.au
  131.    - web
  132.      - http://www.ozemail.com.au/~koschei/
  133.  
  134. ==========================================================================
  135. /// 6. Credits and Thanks
  136. ==========================================================================
  137.  
  138. Neville Truskett, my dad, who wanted the program =)
  139.  
  140. I will definitely thank Dominic Symes,  Tim Tyler and the others for  Zap,
  141. the fastest, the most  polyglottal[?], the nicest, the  most configurable,
  142. program, text, memory, whatever, you name it Zap can  edit it, editor type
  143. program. Who needs emacs? =).Downloadable from <http://www.mandala.co.uk/>
  144.  
  145.  
  146. New thanks since version 0.04 - the authors of extAsm. Marvellous.
  147.  
  148. ==========================================================================
  149. /// 7. Disclaimer
  150. ==========================================================================
  151.  
  152. This program is used entirely at your own risk. I, Iain Truskett,  can not
  153. be held responsible for any loss  of data, revenue or goodwill due  to the
  154. use or misuse of this or any other version of the program.
  155.  
  156. ==========================================================================
  157. /// 8. Licence Conditions
  158. ==========================================================================
  159.  
  160. This program is free  software; you can  redistribute it and/or modify  it
  161. under the terms of the GNU General Public License as published by the Free
  162. Software Foundation; either version 2 of the License,  or (at your option)
  163. any later version.
  164.  
  165. This program  is  distributed in  the hope  that  it will  be useful,  but
  166. WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  167. or FITNESS  FOR A PARTICULAR PURPOSE.  See the GNU  General Public License
  168. for more details.
  169.  
  170. You should  have received a copy  of the GNU General  Public License along
  171. with  this program; if not,  write to the Free  Software Foundation, Inc.,
  172. 675 Mass Ave, Cambridge, MA 02139, USA.
  173.  
  174. ==========================================================================
  175.                                                      Author: Iain Truskett
  176.                                            Last update at: Fri,28 Aug 1998
  177. ==========================================================================
  178.