c2b v121019  (C) 2009-2012  Lorence Lombardo.

c2b requires a 68020 or greater to run.

What the @#$% is c2b ?

c2b converts C ".h" files into Blitz compatible files.

The result is not always perfect and some hand modifications might need to
be made.

Usage:-

c2b <h_file> [output_file]


Why would we need c2b when we have "OpenBlitz" ?

"OpenBlitz" is no longer in developement nor is it open source. 
IMHO c2b is currently more advanced and has the potential for further
developement.

I also think its nice to have a choice.


Known things to be done by hand:-

1. "NEWTYPE" commands within "NEWTYPE" commands will need to be delt with.

2. "NEWTYPE" commands with a ".union_#?" or ".struct_#?" will need to have
   their variable names adjusted.

   Tip:- If the correct name is not on the right hand side of "End NEWTYPE"
         then it might be just underneath it.

3. Macro structures need to be delt with.

4. In line 751 of "xadmaster.h", I'm not quite sure how that should be
   represented. ie.:-  BOOL            (* xc_RecogData)();
   But I think that should be not'd within your own code.

5. It is possible that I am over using the "*" which does effect the size
   of the NEWTYPE.

6. For NEWTYPE's having a name at the top and bottom, so far I have found
   that the name on the bottom is usually the most correct.

7. Its not possible to have more than one dimension in array's within
   NEWTYPE's directly. But perhaps this can be substituted with a NEWTYPE
   array within a NEWTYPE array.

8. INT64 will use the ".d" type but will have a correct comment. You will
   need to do a creative work around for this.
 

Some experimental code has been added for ".c" files also, which can be of
some assistance in starting a port. However, this has only had limited
testing.

If you feel that the ".c" source conversion did not turn out as well as it
should of then it is recommended that you run it through "indent" from the
aminet before c2b. Personally I like indent version 1.9.1 from here:-
http://aminet.net/package/dev/gg/indent-bin
The latest version of indent can be found here:-
http://aminet.net/package/dev/gg/indent-2.2.9-bin-m68k
eg. indent non-compliant.c -o compliant.c -gnu

However, none of the provided examples required this.


Considerations for the future:-

1. Support for macro structures.

2. I have not encountered binary in C at this stage and I'm not sure how it
   is represented in C at this stage.


If you feel that I have left out any variable type or find any bugs, then
please let me know.  NB: ie. Bugs other than those mentioned. ;)

Suggestions are welcome also.


Working examples of c2b's usage can be found here:-

http://aminet.net/search?query=Blitz_


Feeling bored ?  :)
Why not check out this URL ?

http://home.iprimus.com.au/lombi/1/homepage.htm

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]                22919   23176  98.9% -lh5- dd6a Oct 19  2012 c2b
[unknown]                 1517    3022  50.2% -lh5- e6d6 Oct 19  2012 c2b.readme
[unknown]                 4775   18388  26.0% -lh5- db0e Oct 19  2012 examples/ahi.bb2
[unknown]                 4585   15499  29.6% -lh5- 1926 Nov 20  2005 examples/ahi.h
[unknown]                 3076   11353  27.1% -lh5- 6a60 Oct 19  2012 examples/avilib.bb2
[unknown]                 2987   10074  29.7% -lh5- db0a Jan 12  2004 examples/avilib.h
[unknown]                 3874   14060  27.6% -lh5- 09d0 Oct 19  2012 examples/bzlib.bb2
[unknown]                 3614   10785  33.5% -lh5- b977 Dec 11  2003 examples/bzlib.h
[unknown]                 2156    7606  28.3% -lh5- d0f0 Oct 19  2012 examples/hvl2wav.bb2
[unknown]                 2033    6491  31.3% -lh5- 293a Nov  9  2008 examples/hvl2wav.c
[unknown]                 1870    6011  31.1% -lh5- df2d Oct 19  2012 examples/mpega.bb2
[unknown]                 1820    5198  35.0% -lh5- 8b93 Jun 21  1998 examples/mpega.h
[unknown]                24204  136263  17.8% -lh5- e0fa Oct 19  2012 examples/mui.bb2
[unknown]                23193  126905  18.3% -lh5- e5b4 Feb 12  1997 examples/mui.h
[unknown]                 1670    4430  37.7% -lh5- 7c69 Oct 19  2012 examples/PlayTest.bb2
[unknown]                 1594    3942  40.4% -lh5- 367a Nov 20  2005 examples/PlayTest.c
[unknown]                 4389   15473  28.4% -lh5- 4663 Oct 19  2012 examples/pm.bb2
[unknown]                 4235   13443  31.5% -lh5- 6610 Jan 11  2001 examples/pm.h
[unknown]                 1200    3165  37.9% -lh5- f293 Oct 19  2012 examples/RecordTest.bb2
[unknown]                 1131    2712  41.7% -lh5- 1daf Nov 20  2005 examples/RecordTest.c
[unknown]                 1755    9789  17.9% -lh5- 0e45 Oct 19  2012 examples/replay.bb2
[unknown]                 1482    7301  20.3% -lh5- 7df1 Nov  9  2008 examples/replay.h
[unknown]                 5576   25352  22.0% -lh5- a4e9 Oct 19  2012 examples/reqtools.bb2
[unknown]                 5327   20950  25.4% -lh5- b4d3 Dec 14  1996 examples/reqtools.h
[unknown]                  752    2805  26.8% -lh5- a271 Oct 19  2012 examples/select.bb2
[unknown]                  717    2266  31.6% -lh5- 1e2d Jun 15  2000 examples/select.h
[unknown]                 2717    8118  33.5% -lh5- f0ef Oct 19  2012 examples/sndfile.bb2
[unknown]                 2738    7745  35.4% -lh5- dfc8 Aug 27  2000 examples/sndfile.h
[unknown]                  647    1984  32.6% -lh5- 2ed5 Oct 19  2012 examples/Sunrize.bb2
[unknown]                  573    1257  45.6% -lh5- 60e4 Apr 11  1997 examples/Sunrize.h
[unknown]                12404   47003  26.4% -lh5- 0baf Oct 19  2012 examples/xadmaster.bb2
[unknown]                12041   41231  29.2% -lh5- 8da9 Oct 13  2003 examples/xadmaster.h
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        32 files  163571  613797  26.6%            Oct 20  2012