tools/FlexCat/developer.readme

   1
   2 Hello,
   3 ------
   4
   5 here you find the source code for the FlexCat.  It shall be fully
   6 portable and you should find no problems compiling it on the other
   7 platforms (as long as it's either Big or Little Endian though).
   8
   9
  10 Why did I release the sources?
  11 ---------------------------------------------------------------------
  12
  13 Formerly FlexCat was covered by GPL license, so it's now back to the
  14 roots somehow (I don't care all these GPL.readme etc files for now, so
  15 treat this all as freeware with source code available than GPL rather
  16 ;-).  Moreover few people asked about the version for other platforms
  17 (for many reasons), so now, having the source, you can compile it on
  18 whatever platform you need (but read above notes).
  19
  20 I am now busy with other Amiga projects, and as FlexCat seems to be
  21 almost finished (see TODO file), I don't plan to put much development
  22 in this project recently (it works quite fine, so I see no big need to
  23 do so anyway).
  24
  25
  26
  27 Do you have some ideas or features you would like to see in FlexCat?
  28 ---------------------------------------------------------------------
  29
  30 If you got any programming skill (no beginners pliz!) and some spare
  31 time you can add whatever you want.
  32
  33 But please don't release FlexCat yourself!  Please send me diff output
  34 (or the whole source) with description of your changes -> I'd
  35 integrate it in next release myself.  I just want to prevent anyone
  36 from duplicating others' work (mail me if you want to develope
  37 FlexCat!).
  38
  39
  40 Compiling FlexCat (AmigaOS)
  41 ---------------------------------------------------------------------
  42
  43 There's SAS/C makefile enclosed (smakefile), so if you own SAS/C just
  44 type 'smake' to have FlexCat compiled.  Using other compilers should
  45 also be very easy.
  46
  47 NOTE:  The source archive contains files which are not present in
  48        other archives of FlexCat distribution.  To make FlexCat
  49        compile, you will have to fetch #?.cd file (FlexCat_CatSrc.lha)
  50        as well as FlexCat itself (may be any of previous releases).
  51
  52
  53 Compiling FlexCat (other platforms)
  54 ---------------------------------------------------------------------
  55
  56 Version 2.4 comes with Hardcode.sd source descriptor that should be
  57 used to create necessary string arrays FlexCat uses while outputting
  58 any message.  Hardcode.sd makes all FlexCat.c needs to work.  It does
  59 not handle catalog files etc.  thus FlexCat compiled with Hardcode.sd
  60 based file will remain talk in English only.  Not a big problem
  61 anyway.  Good it works ;-) How to compile?  First, take the
  62 flexcat_cat.h.unix file and rename it flexcat_cat.h (it's Hardcode.sd
  63 based file).  Make sure there's no "__amigaos" defined (see the
  64 FlexCat.c file).  This would disable all AmigaOS native parts (few,
  65 but they are), like catalog flushing etc, which you won't find useful
  66 on non Amigas anyway.
  67
  68   cc FlexCat.c -o FlexCat
  69
  70 should be fine (and enough) to get FlexCat.
  71
  72
  73
  74 Marcin Orlowski <carlos@amiga.com.pl>
  75
  76 --
  77 $Id$