Bringing flexcat 2.15 into the main branch
[AROS.git] / tools / flexcat / README
blob293c99390ebe30edd6bde7fee810f3e00083e173
2 Hello,
3 ------
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).
10 Why did I release the sources?
11 ---------------------------------------------------------------------
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).
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).
27 Do you have some ideas or features you would like to see in FlexCat?
28 ---------------------------------------------------------------------
30 If you got any programming skill (no beginners pliz!) and some spare
31 time you can add whatever you want.
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!).
40 Compiling FlexCat (AmigaOS)
41 ---------------------------------------------------------------------
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.
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).
53 Compiling FlexCat (other platforms)
54 ---------------------------------------------------------------------
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.
68   cc FlexCat.c -o FlexCat 
70 should be fine (and enough) to get FlexCat.
74 Marcin Orlowski <carlos@amiga.com.pl>
77 $Id: README 74 2007-01-01 02:55:05Z tactica $