home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 2 / RISC_DISC_2.iso / pd_share / program / tools / templaof / ReadMe
Encoding:
Text File  |  1995-04-08  |  3.4 KB  |  88 lines
  1. Title  : Template to AOF
  2. Purpose: Embedding templates in executables
  3. Author : © George K. Saliaris
  4. Version: 1.00 (March 95)
  5. Status : Freeware
  6.  
  7.  
  8. Q: Well, what is that?
  9. ======================
  10. A: First of all, if you don't know what is AOF or RISC_OSLib, you can safely
  11. ignore the whole matter :-)
  12.  
  13. Here is a small program that will allow you to embed Template files in an
  14. executable when using RISC_OSLib. Also with slight modifications it can be
  15. used for relocatable module tasks that need to encapsulate templates in
  16. their code.
  17.  
  18.  
  19. Q: And why would I like to use something like that?
  20. ===================================================
  21. A: Perhaps you don't want people to fiddle with your template files; or you
  22. really need such a facility in order to write a stand-alone relocatable
  23. module task in assembler (ala Filers, Menon, PalleteUtil etc). Also there
  24. are some desirable side-effects: less memory is required for templates and
  25. when programming in assembler you can access indirected data easier.
  26.  
  27. In general, embedding Templates in the executable is not a common practice,
  28. but for one reason or another, some programs like Eureka, Revelation,
  29. Digital Symphony, Dissi etc use similar techniques.
  30.  
  31.  
  32. Q: What about the rest of the files?
  33. ====================================
  34. A: 'c.template' contains the C source code of the modified RISC_OSLib
  35. template module. Use it as a replacement of the original template module. No
  36. special handling is required (ie call in your initialisation template_init()
  37. etc as normal)
  38.  
  39. 's.Templ>AOF' makes the actual conversion of a template file to a
  40. relocatable AOF that should be linked with the rest of your object files
  41. (probably in a Makefile). Please note that in order to compile this source,
  42. you will need BasicAOF utility, available from Oregan Developments.
  43.  
  44. 'dat.Templates' is just a sample template file. Incidentally it contains the
  45. templates of !Paint, as distributed in !Newlook for RISC OS 3.10.
  46.  
  47. 'o.Templ>AOF' is the output of the 's.Templ>AOF' and represents the AOF
  48. equivalent of the 'dat.Templates' file.
  49.  
  50.  
  51. Q: Can I use the code in my own programs?
  52. =========================================
  53. A: Certainly, feel free to do so.
  54.  
  55.  
  56. Q: Don't you think that RISC_OSLib is a bit outdated?
  57. =====================================================
  58.  
  59. A: It's true; as of March 1995, RISC_OSLib is officially dead! Long live the
  60. new Toolbox suite: much more elegant, much more friendly and hopefully more
  61. bug-free ;-)
  62.  
  63. But wait a minute: RISC_OSLib is a good piece of software. I personally find
  64. almost nothing wrong with it, but admittedly after having access to its
  65. source code.
  66.  
  67. Unlike all the other similar Wimp libraries (DeskLib, Spirit and the like),
  68. RISC_OSLib is widely used in many successful commercial applications, not to
  69. mention the standard RISC OS applications suite we all hate and love: Edit,
  70. Draw, Paint, Configure, Squash, FilerAct, FrontEnd etc etc. Consequently
  71. RISC_OSLib will be with us for a long time, because much code has been
  72. written with it and obviously there is no justifiable reason to completely
  73. rewrite everything with the new Toolbox. However it is apparent that new
  74. applications, will be preferably designed with the new nice Toolbox instead
  75. of RISC_OSLib.
  76.  
  77.  
  78. Q: OK, and how can I contact you if I feel like?
  79. ================================================
  80. A: Bug reports, comments or suggestions welcome:
  81.  
  82. Mail:   George Saliaris
  83.         Veriti 7
  84.         Chios  821 00
  85.         GREECE
  86. Fax:   +30 271 41355
  87. Email:  gsal@posidon.servicenet.ariadne-t.gr
  88.