home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / program / formexpnd / !FormExpnd / !Help / Readme < prev    next >
Encoding:
Text File  |  1991-05-03  |  6.9 KB  |  198 lines
  1. ***************************** Copyright Notice ****************************
  2. *                                                                         *
  3. *                          (C)1991 Duco Fennema                           *
  4. *                                                                         *
  5. *    Read the 'Terms of Use' chapter at the end of this file to know      *
  6. *             what you may and may not do with this program.              *
  7. *                                                                         *
  8. ***************************************************************************
  9.  
  10.  
  11.                     ReadMe file for !FormExpnd v1.10
  12.  
  13.  
  14.       Makes template files ready for direct loading by applications
  15.  
  16.        Windows can then be created and deleted by programs at will
  17.  
  18.  
  19.  
  20.         Contents___________________________________________________
  21.  
  22.         This file contains 5 chapters in this order.
  23.           -Why !FormExpnd
  24.           -Using !FormExpnd
  25.           -How it works
  26.           -Error messages
  27.           -Using expanded template files
  28.           -Acknowledgements
  29.           -Terms of use
  30.           -Release information
  31.           -Correspondence
  32.  
  33.  
  34.  
  35.         Why !FormExpnd_____________________________________________
  36.  
  37.         When you make a program that uses a lot of windows and
  38.         dialogue boxes you should not create them all at startup
  39.         and claim windowhandles for them.
  40.         Instead they should be created when needed and deleted as
  41.         soon as possible.
  42.         Loading lots of templates with 'Wimp_LoadTemplate' is not
  43.         very convenient because it requires repeated disc access.
  44.         Furtermore you need twice the space used by indirected data
  45.         to facilitate its relocation.
  46.         Loading the template file as a whole would do away with
  47.         these drawbacks but sadly the format saved by the template
  48.         editor is not suitable for doing this.
  49.         !FormExpnd tries to overcome this problem by converting the
  50.         template file to a format that can be loaded directly.
  51.  
  52.  
  53.  
  54.         Using !FormExpnd___________________________________________
  55.  
  56.         First install !FormExpnd on the iconbar.
  57.  
  58.         Using !FormExpnd couldn't be simpler, just drag the
  59.         template file to be expanded upon the !FormExpnd Icon it
  60.         will then be expanded.
  61.  
  62.         While !FormExpnd is doing its stuff the hourglass may be
  63.         displayed.
  64.  
  65.         When the template file is expanded a 'save as:' dialogue
  66.         box will pop up just above the !FormExpnd iconbar icon.
  67.  
  68.         You may now save the expanded template file in the normal
  69.         RiscOs fashion.
  70.  
  71.         _________________WARNING WARNING WARNING___________________
  72.  
  73.         The new template file has the same leafname as your
  74.         original template file.
  75.  
  76.         Dragging it to the same directory as the original template
  77.         file or clicking on the 'OK' icon will overwrite your
  78.         original template file.
  79.  
  80.  
  81.  
  82.         How it works_______________________________________________
  83.  
  84.         !FormExpnd works by analysing the template file and expand
  85.         all indirected data space to the exact amount needed by the
  86.         window.
  87.         This needs to be done because !FormEd only saves the data
  88.         actualy given when the window was defined not the amount
  89.         specified as the 'max size'.
  90.  
  91.         While expanding the file every window definition is aligned
  92.         on a word boundary from the file start.
  93.         This is required to be able to use the file directly with
  94.         'Wimp_CreateWindow'
  95.  
  96.  
  97.  
  98.         Error messages_____________________________________________
  99.  
  100.         There are six errors generated by !FormExpnd.
  101.  
  102.         These are:
  103.  
  104.           -Save or discard other template file first
  105.              You have tried to load a new template file without
  106.              saveing the former one.
  107.           -Template file '<filename>' not found
  108.              This will happen if you manage to delete the file you
  109.              just dragged onto the !FormExpnd icon before
  110.              !FormExpnd could load it.
  111.              A Template file with zero lenght will also cause this
  112.              error to be reported.
  113.           -Could not load '<filename>' : <reason>
  114.              !FormExpnd could not load the specified file, the
  115.              reason given is the error message returned by the
  116.              filer.
  117.           -Could not save '<filename>' : <reason>
  118.              !FormExpnd could not save the specified file, the
  119.              reason given is the error message returned by the
  120.              filer.
  121.           -Unable to claim enough memory
  122.              !FormExpnd could not obtain enough memory to load or
  123.              expand the template file.
  124.           -Wimp_SlotSize failed
  125.              This should not normaly happen, it means that
  126.              Wimp_SlotSize itself caused an error.
  127.              Although it will not crash this program it means that
  128.              something is seriously wrong. 
  129.  
  130.  
  131.  
  132.         Using expanded template files______________________________
  133.  
  134.         In this application directory you find a basic file with
  135.         all procedures needed to get this system working.
  136.         These are extracted from one of my own programs and should
  137.         work ok.
  138.         Should you encounter any problems using the routines, or if
  139.         you have other related questions write to me at the adress
  140.         stated below.
  141.  
  142.  
  143.  
  144.         Acknowledgements___________________________________________
  145.  
  146.         Thanks to:
  147.           -Joris Roling for his !Help application.
  148.           -Freddy Huttner for his excellent !NewModes module.
  149.           -Acorn for developing this tremendous machine.
  150.           -My girlfriend for being understanding.
  151.  
  152.  
  153.  
  154.         Terms of Use_______________________________________________
  155.  
  156.         You may freely copy as long as:
  157.           -all files in this application directory are included.
  158.           -this is not for commercial purposes
  159.           -you do not charge for copying.
  160.           -you do not put this program or parts of it on a disc for
  161.            which you are charging (other than the costs of the disc
  162.            itself).
  163.           -the application is not tampered with.
  164.           -this Readme file is always included without any change
  165.            made to its contents.
  166.           -you do not upload this on a bulletin board which charges
  167.            for its downloads.
  168.  
  169.  
  170.         The author reserves the right to amend these terms in cases
  171.         where he deems misuse.
  172.  
  173.  
  174.  
  175.         Release information________________________________________
  176.  
  177.         v1.00 (23 Nov 1990) First public release.
  178.         v1.10 (03 May 1991) Changed the error handling.
  179.                             Added the procedure file.
  180.  
  181.  
  182.  
  183.         Correspondence_____________________________________________
  184.  
  185.         Send remarks, bugs and praise to:
  186.  
  187.           Duco Fennema
  188.           Eursingerweg 34
  189.           9411 BB  BEILEN
  190.           HOLLAND
  191.  
  192.           Telephone: 
  193.           05930-22277
  194.  
  195.           From outside Holland:
  196.           <International entry code> 031 5930 22277
  197.  
  198.