home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / programming / desklib / readme < prev    next >
Encoding:
Text File  |  1999-04-27  |  5.1 KB  |  180 lines
  1.  
  2.     ####             #    #     # #
  3.     #   #            #    #       #          
  4.     #   #  ##   ###  #  # #     # ###             
  5.     #   # #  # #     # #  #     # #  #
  6.     #   # ####  ###  ##   #     # #  #                                      
  7.     #   # #        # # #  #     # #  #    
  8.     ####   ### ####  #  # ##### # ###    
  9.  
  10.     The FreeWare Desktop C library for
  11.              RISC OS machines
  12.  
  13.               Release 2.30
  14.               02 Sep 1995
  15.  
  16.   If you have used previous version(s) of
  17.   DeskLib, please consult 'DeskLib.Docs.Updates' 
  18.   to see what has changed.
  19.  
  20.  
  21. DeskLib
  22. -------
  23.  
  24. DeskLib is a set of fully sourced C libraries for for writing desktop
  25. applications for Acorn RISC OS. The aim of DeskLib is to collect
  26. together useful little snippets of code to help the desktop programmer. 
  27. In this area, DeskLib already provides a full set of WIMP SWI veneers in
  28. assembler, a whole set of useful icon manipulation functions, etc. 
  29. Higher-level event managers, etc. are also provided but trade off
  30. efficiency and compactness to provide genericity.
  31.  
  32.  
  33. The completely installed DeskLib distribution looks something like:
  34.  
  35.  
  36. DeskLib.!Help        This file.
  37. DeskLib.!DeskLib...    Header files, the main DeskLib library,
  38.             DeskLib's StrongHelp file, dynamic-linking
  39.             libraries.
  40. DeskLib.!DLSources...    All source code, makefiles, scripts, etc.
  41. DeskLib.!DLUser...    Directory for user's extra sub-libraries.
  42. DeskLib.Docs...        Documentation files.
  43. DeskLib.Examples...    Example applications.
  44.  
  45.  
  46.  
  47.  
  48.  
  49. Recompiling DeskLib with different versions of cc and link
  50. ----------------------------------------------------------
  51.  
  52. This release of DeskLib has been compiled with cc version 4 (as supplied
  53. with Acorn's Desktop C) and objasm 2.00, because later versions of these
  54. tools (eg cc 5 supplied with Acorn's C/C++ system) produce code which
  55. link 4 can't cope with.
  56.  
  57. If you have Acorn C/C++ and want to re-make DeskLib using the new
  58. compiler (which will probably produce speed/space improvements in the
  59. compiled DeskLib code) then, after '!DeskLib' and '!DLSources' have been
  60. seen by your Filer, simply double-click on the file
  61. '!DLSources.Scripts.Static.MakeClean'.
  62.  
  63. This will completely remake the normal static-linking version of DeskLib
  64. in a task window, taking approximately half an hour.
  65.  
  66. NB You will need to have at least 1.5Mb RAM free to do this.
  67.  
  68. If you have also down-loaded the dynamic-linking version of DeskLib,
  69. double click on '!DLSources.Scripts.Static+DLL.MakeClean' instead. This
  70. will recompile both the static and dynamic-linking versions of DeskLib.
  71.  
  72.  
  73.  
  74.  
  75. Dynamic linking note
  76. --------------------
  77.  
  78. The dynamic-linking parts of this release of DeskLib need version 1.03
  79. of the Straylight Dynamic Linking System, which is available from the
  80. usual Acorn-related ftp sites.
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87. DeskLib distribution information
  88. --------------------------------
  89.  
  90. DeskLib is now rather large, so it has been split up to allow people to
  91. download just the parts they require.
  92.  
  93. The separate parts of DeskLib are in zip files in this directory. These
  94. can be extracted using Spark.
  95.  
  96. Each of the Zip files contains just those parts of the DeskLib directory
  97. structure needed to contain the zip file's particular selection of
  98. DeskLib's files. This allows you to simply extract the zip files into
  99. the same place to get the parts of the DeskLib tree that you require.
  100.  
  101. Here is which parts of the complete distribution each zip file in this
  102. directory contains:
  103.  
  104.  
  105. Zip File    What it contains
  106. ------------------------------------------------------------------------
  107.  
  108. Core        Everything need to compile and link programs which use
  109.         DeskLib (ie the header files and library file
  110.         !DeskLib.o.DeskLib), plus the documentation files and
  111.         release notes.
  112.         
  113.         DeskLib.!DeskLib...* except dynamic linking files.
  114.         DeskLib.Docs...*
  115.         DeskLib.!DLUser...*
  116.     
  117.  
  118. Sources        All the source code for DeskLib, plus makefiles and
  119.         scripts needed to make DeskLib. No .o files.
  120.         
  121.         DeskLib.!DLSources...* except *.o.* .
  122.  
  123.  
  124. Objects        All .o files needed to make the normal version of DeskLib.
  125.         
  126.         DeskLib.!DLSources...Static.o.*
  127.  
  128.  
  129. DLLObjs        All .o files needed to make the dynamic-linking versions
  130.         of DeskLib.
  131.         
  132.         DeskLib.!DLSources...DLL.o.*
  133.         DeskLib.!DLSources...DLLClient.o.*
  134.         
  135.  
  136. Examples    A few example programs with source, plus some random
  137.         source code.
  138.         
  139.         DeskLib.Examples...* except *.EasyC...* .
  140.  
  141.  
  142. EasyCEgs    Beebug EasyC-compatible versions of one of the example 
  143.         program.
  144.         
  145.         DeskLib.Examples.EasyC...*
  146.  
  147.  
  148. DLL        All files needed to make applications which use the
  149.         dynamically-linkable version of DeskLib.
  150.         
  151.         DeskLib.!DeskLib.o.DLL*
  152.         DeskLib.!DeskLib.!DLLs...*
  153.  
  154.  
  155. StrongHelp    This is a StrongHelp file which documents every
  156.         function, variable, typedef, macro etc in the DeskLib
  157.         header files.
  158.         Note that this needs version 2 of StrongHelp.
  159.         Also note that the extracted StrongHelp file is nearly
  160.         1Mb.
  161.         
  162.         DeskLib.!DeskLib.DeskLib
  163.  
  164.  
  165.  
  166.  
  167.  
  168. -------------------------------------------------------
  169.  
  170.  
  171. Julian Smith
  172.  
  173.  
  174. If you have any problems, please feel free to contact me:
  175.  
  176. Julian Smith                              Dept of Experimental Psychology
  177. julian.smith@psy.ox.ac.uk                 South Parks Road, Oxford, OX1 3UD
  178. http://cogsci1.psych.ox.ac.uk/~julians/   UK
  179.  
  180.