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