home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 2 / DATAFILE_PDCD2.iso / utilities2 / desklib / Docs / !MakeNote next >
Encoding:
Text File  |  1993-05-13  |  4.7 KB  |  109 lines

  1. Notes on compiling DeskLib
  2. ==========================
  3.  
  4. Some of the sub-libraries need to include main DeskLib .h files. They expect
  5. the System Variable DeskLib$Path to be set up with the full pathname of the
  6. main desklib directory, as in:
  7.  
  8.   Set DeskLib$Path ADFS::4.$.C_Work.DeskLib.
  9.  
  10. (The fullstop at the end is vital)
  11. This is correctly set up if the filer has 'seen' the "!DeskLib" application
  12.  
  13. This should be used in your programs as in:
  14.   #include "DeskLib:Icon.h"
  15.  
  16. When linking, you can use "DeskLib:o.DeskLib"
  17. However, !DeskLib also adds itself onto the end of C$Path, so C:o.DeskLib
  18. will suffice.
  19.  
  20. ---
  21.  
  22. In every subdirectory of desklib that can be "made", there is a makefile
  23.  
  24. This can be modified slightly to make just that section of the library as a
  25. seperate library file, if you don't need all of the desklib functions. This
  26. is done using 'libfile'. WimpSWIs already uses this to produce a secondary
  27. library file (so to use WIMP swis you either include DeskLib OR WimpLib)
  28.  
  29. To make any portion of DeskLib, use amu on the MakeFile as normal.
  30. Note that these makefiles probably don't work with !Make, but does anybody
  31. really like !Make enough to use it anyway? Use !Edit... it's easier and
  32. quicker (oh, and amu takes much!! less memory than !Make).
  33.  
  34. ---
  35.  
  36. If you do not have the Acorn assembler, then be very careful not to delete
  37. any of the precompiled .o files, as you will not be able to re-make them
  38. without the assembler. If someone can be bothered, a TLA-compatible version
  39. of assembler libraries may be made available in the future.
  40.  
  41. All C portions of the library may be supplied as source only.
  42. The final DeskLib library is also provided so you can start using it without
  43. having to spend 20 minutes (or 37 seconds for A5000 owners ;-) compiling first!
  44. And as well as this, the WIMP SWI interface is supplied as a stand-alone
  45. library (in !DeskLib.o.WimpLib - use the name C:o.WimpLib)
  46.  
  47. Note that DeskLib relies on the directory structure as supplied: If you
  48. move (for example) either the !TestApp or WimpSWIs directories, then they
  49. (and other things) may fail to compile, as the source/libraries referenced
  50. by these things will not be available to the rest of the library.
  51. However, these dependencies are only caused by the layout of the makefiles,
  52. so if you wish to move stuff around, alter the MakeFiles to suit.
  53.  
  54. ---
  55.  
  56. The directory structure of DeskLib is as follows:
  57.  
  58. DeskLib
  59.  |
  60.  |________ !DeskLib   DeskLib compile-time resources
  61.  |                    This contains the header (.h) files, as well as the
  62.  |                    complete DeskLib library file. This is all that you NEED
  63.  |                    to have in an easy to reach place for compiling using
  64.  |                    DeskLib. (See it's !Help for more details)
  65.  |
  66.  |________ !TestApp   A Test/Example application for DeskLib. Full sources
  67.  |                    are included within.
  68.  |
  69.  |________ Docs       Documentation files
  70.  |          |
  71.  |          |________ ModuleNote  Extra notes (where necessary) on various
  72.  |          |                     DeskLib code modules
  73.  |          |
  74.  |          |________ QuickRefs   Quick reference files/charts to make 
  75.  |          |                     using DeskLib code easier.
  76.  |          |
  77.  |          |________ Blanks      Blank makefiles, headers, etc.
  78.  |
  79.  |________ Sources    Repository for any general source files that are not
  80.  |                    included in the DeskLib library file. These are for
  81.  |                    you to cut and paste into your own code in most cases
  82.  |                    (or in the case of Error.c for you to compile in
  83.  |                    yourself as you will most likely want more control of
  84.  |                    how errors are reported)
  85.  |
  86.  |________ Libraries
  87.             |________ !MakeDLib   An obey file that MAKEs each part of 
  88.             |                     DeskLib, and then compiles the DeskLib
  89.             |                     Library
  90.             |
  91.             |________ !Objects    This is a 'via' file of all the library
  92.             |                     objects for LibFile to include into DeskLib
  93.             |                     (so don't delete it!)
  94.             |
  95.             |________ Clean       An obey file that wipes all of the .o
  96.             |                     files (except those that were assembled,
  97.             |                     as some users may not have the assembler
  98.             |                     as well as the C compiler.
  99.             |
  100.             |________ ?           Each subdirectory in here contains the
  101.                                   source and makefile for a subset of the
  102.                                   DeskLib library.
  103.  
  104. To completely make DeskLib, simply open the 'Libraries' directory and
  105. double click on the obey file !MakeDLib.
  106.  
  107. To make the Test Application, change directory into the application directory
  108. and type 'amu'.
  109.