home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 16 / amigaformatcd16.iso / -in_the_mag- / top100_shareware / archivers / xpk / xpk_source / aboutsources next >
Text File  |  1997-04-12  |  4KB  |  89 lines
  1. IMPORTANT: As long as any of the authors are reachable via mail/e-mail
  2. contact them first, before you make somehow changed/patched versions.
  3.  
  4. Also the sources of main xpk library are offered, but this doesn't give
  5. you the right to create your own version of xpkmaster.library (it is not
  6. public domain software). Everytime you have to contact either Dirk Stöcker,
  7. Christian von Roques or Urban Dominik Müller. We may give you the OK to
  8. do further development!
  9.  
  10. ----------------------------------------------------------------------------
  11.  
  12. You should begin your tour to these sources in the examples directory, which
  13. contains some simple examples of how to write applications using xpk.
  14.  
  15. The directory Shell contains the sources of what I think are the basic shell
  16. utilities for xpk.
  17.  
  18. The directory test contains some test programs (in C) which were needed
  19. during development of some features. These files may be useful for you too.
  20.  
  21. If you want to write a sublibrary in C, the best place to start with are
  22. the sources of xpkRLEN.library.
  23.  
  24. Assembler programmers should take a look at the sources of xpkFAST.library.
  25. I tried to separate the .library bureaucrazy from the other stuff and
  26. generally tried to write elegant and readable code while writing FAST.
  27.  
  28. People with a hang to monolitic assembler sources or a distaste for linkers
  29. will be pleased by what they'll find in the directory with the sources of
  30. xpkHUFF.library.
  31.  
  32. xpkmaster contains the cleanedup sources of the xpkmaster.library. Do not
  33. try to understand the inner workings of xpkmaster.library without first
  34. having read all the documentation. Do not think after reading the docs you
  35. understand them. (It took me a half year to really understand some parts. :-)
  36.  
  37. The SDI includes are replacements of standard ANSI functions. These includes
  38. mostly reduce the size of the executable, but they are not fully compatible
  39. to the ANSI C ones. You may use them or replace the include line with
  40. <stdlib>, <stdio.h> and <string.h>.
  41. The SDI defines define things I often use (f.e. CTRL_C and the version
  42. string).
  43.  
  44. For those, who want to code their own sublibrary:
  45. --------------------------------------------------
  46.  
  47. How has the version string to be like?
  48. --> see how the standard or the example libraries handle this:
  49.  
  50. xpk<name of library> <version>.<revision> (<date>) <comments>\r\n\0
  51.  
  52. example: "xpkFAST 1.7 (07.09.96)\r\n\0" (NOTE: \r = 0x13; \n = 0x10)
  53.  
  54. You do not need to add a "$VER: " somewhere in the text and the library
  55. name should be without ".library"! Also the date format should be the above
  56. form, because Commodore defined this form as an nearly standard. Please
  57. make the work and include an correct library header, because this makes
  58. updating a lot easier! This means also a correct initialisation of the
  59. corresponding fields in the Resident (RomTag) structure. An example library
  60. header handling this you find in the xpk_Develop archive in the ASM-include
  61. directory. (If you have problems in doing this, contact me! - Dirk Stöcker)
  62.  
  63. How to compile the asm only stuff:
  64. ----------------------------------
  65.  
  66. Run your assembler over the master file (mostly xpk____.a) and you get the
  67. final output file.
  68.  
  69. How to compile with SAS-C:
  70. --------------------------
  71.  
  72. Call smake in the directory. You may have to change the assembler line
  73. to your assembler before doing this!. I use everytime PhxAss assembler,
  74. because it seems to be powerful and it is freely distributable.
  75.  
  76. How to compile with Maxon's compiler:
  77. -------------------------------------
  78.  
  79. xpkmaster.library:
  80.  (C++ V3) Use the MakeFile with Maxon's Make
  81.  (DEV V4) Compile library using xpkmaster.project.
  82.  
  83. other programs and libraries:
  84.  Use assembler to get object files of asm-sources.
  85.  Compile C files (mostly large data mode!) and link together with .o files
  86.  made with assembler.
  87.  
  88.                         Dirk and Christian.
  89.