home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / Cruncher / XPK416SR.LHA / xpk_Source / AboutSources
Encoding:
Text File  |  1997-09-06  |  3.9 KB  |  92 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. At least two of these programs use undocumented features (mentioned in
  21. source code) and thus should never be used in distributed programs. That's
  22. why the test utilities are not distributed as binaries!
  23.  
  24. If you want to write a sublibrary in C, the best place to start with are
  25. the sources of xpkRLEN.library.
  26.  
  27. Assembler programmers should take a look at the sources of xpkFAST.library.
  28. I tried to separate the .library bureaucrazy from the other stuff and
  29. generally tried to write elegant and readable code while writing FAST.
  30.  
  31. People with a hang to monolitic assembler sources or a distaste for linkers
  32. will be pleased by what they'll find in the directory with the sources of
  33. xpkHUFF.library.
  34.  
  35. xpkmaster contains the cleanedup sources of the xpkmaster.library. Do not
  36. try to understand the inner workings of xpkmaster.library without first
  37. having read all the documentation. Do not think after reading the docs you
  38. understand them. (It took me a half year to really understand some parts. :-)
  39.  
  40. The SDI includes are replacements of standard ANSI functions. These includes
  41. mostly reduce the size of the executable, but they are not fully compatible
  42. to the ANSI C ones. You may use them or replace the include line with
  43. <stdlib>, <stdio.h> and <string.h>.
  44. The SDI defines define things I often use (f.e. CTRL_C and the version
  45. string).
  46.  
  47. For those, who want to code their own sublibrary:
  48. --------------------------------------------------
  49.  
  50. How has the version string to be like?
  51. --> see how the standard or the example libraries handle this:
  52.  
  53. xpk<name of library> <version>.<revision> (<date>) <comments>\r\n\0
  54.  
  55. example: "xpkFAST 1.7 (07.09.96)\r\n\0" (NOTE: \r = 0x13; \n = 0x10)
  56.  
  57. You do not need to add a "$VER: " somewhere in the text and the library
  58. name should be without ".library"! Also the date format should be the above
  59. form, because Commodore defined this form as an nearly standard. Please
  60. make the work and include an correct library header, because this makes
  61. updating a lot easier! This means also a correct initialisation of the
  62. corresponding fields in the Resident (RomTag) structure. An example library
  63. header handling this you find in the xpk_Develop archive in the ASM-include
  64. directory. (If you have problems in doing this, contact me! - Dirk Stöcker)
  65.  
  66. How to compile the asm only stuff:
  67. ----------------------------------
  68.  
  69. Run your assembler over the master file (mostly xpk____.a) and you get the
  70. final output file.
  71.  
  72. How to compile with SAS-C:
  73. --------------------------
  74.  
  75. Call smake in the directory. You may have to change the assembler line
  76. to your assembler before doing this!. I use everytime PhxAss assembler,
  77. because it seems to be powerful and it is freely distributable.
  78.  
  79. How to compile with Maxon's compiler:
  80. -------------------------------------
  81.  
  82. xpkmaster.library:
  83.  (C++ V3) Use the MakeFile with Maxon's Make
  84.  (DEV V4) Compile library using xpkmaster.project.
  85.  
  86. other programs and libraries:
  87.  Use assembler to get object files of asm-sources.
  88.  Compile C files (mostly large data mode!) and link together with .o files
  89.  made with assembler.
  90.  
  91.                         Dirk and Christian.
  92.