home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / compress / xfh132.lzh / XFH / src / README < prev    next >
Text File  |  1993-01-19  |  3KB  |  78 lines
  1.     XFH compressing file system handler.
  2.     Copyright (C) 1991, 1992, 1993 Kristian Nielsen.
  3.  
  4.     This program is free software; you can redistribute it and/or modify
  5.     it under the terms of the GNU General Public License as published by
  6.     the Free Software Foundation; either version 2 of the License, or
  7.     (at your option) any later version.
  8.  
  9.     This program is distributed in the hope that it will be useful,
  10.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  11.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12.     GNU General Public License for more details.
  13.  
  14.     You should have received a copy of the GNU General Public License
  15.     along with this program; if not, write to the Free Software
  16.     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  17.  
  18.  
  19. This directory contains the following:
  20.  
  21. In the root: Source code for the XFH handler.
  22. In libmy/: Source for special support library.
  23. In libmygcc: Source for a small subset of the GCC ANSI C library (to
  24. avoid using ixemul.library).
  25.  
  26.  
  27. Compiling the handler:
  28.  
  29. The source was compiled with the excellent GCC port by Markus Wild and
  30. BMake by Ben Eng. I've tried isolating all GCC-specific code between
  31. #ifdef / #endif, so it should not be too hard to make it compile with
  32. e.g. SAS C, but I may have missed something here and there. You'll
  33. also need to change the makefiles; remember to compile without startup
  34. code, and use large data model to be safe (XFH uses no global data
  35. anyway except library base pointers). The libmygcc.a is meant to
  36. replace ixemul.library, you can probably get away with any old C library.
  37.  
  38. If you are using GCC and BMake (and have everything set up correctly),
  39. you should be able to use the supplied makefile. You will first need
  40. to build the libraries. The makefile assumes a setup with the includes
  41. in libmy/ accessible as mys:myinclude/#?.h, and the XFH distribution
  42. (minus source) placed in dist/.
  43.  
  44. The source also contains an assembler file (DoDOS.asm). I use the
  45. Devpac assembler myself, but I would assume that most standard Amiga
  46. assemblers would do.
  47.  
  48. A note about debugging: Debug messages are sent out by a debug((...))
  49. call. The messages can be received by the program 'DebugPrc', supplied
  50. in the 'src/' directory (binary only).
  51.  
  52. Note: The source uses <proto/libname.h> for compatibility; GCC users
  53. can link this to gcc:os-include/inline/.
  54.  
  55. If you have any questions or problems compiling this source, I can be
  56. reached by the address given below. I'd be very interested in hearing
  57. from people who have tried compiling XFH, and I'm always willing to
  58. try to answer questions (time permitting...). Also, if you make any
  59. changes to XFH, either new features or just ports to other compilers,
  60. I would appreciate it if you sent me the changes so that I can
  61. incorporate them in never versions.
  62.  
  63.  
  64.    Kristian Nielsen
  65.    Groenjordskollegiet
  66.    room 6111
  67.    Groenjordsvej
  68.    DK-2300 Koebenhavn S
  69.    Denmark.
  70.  
  71.    E-Mail: bombadil@diku.dk
  72.  
  73.  
  74. [Local variables for Emacs:]
  75. Local Variables:
  76. mode: text
  77. End:
  78.