Short:    V2.158 create pragma, inline, ... files
Author:   stoecker@epost.de (Dirk Stoecker)
Uploader: stoecker@epost.de (Dirk Stoecker)
Type:     dev/misc
Version:  2.158

This is a utility to create:
  - following pragma statements for certain C compilers: amicall, libcall,
    flibcall, tagcall and syscall
  - proto files for C compilers
  - offset (LVO) files for assembler programs
  - stub functions for either tag-functions or all library functions
  - stub functions as assembler text
  - stub functions as useable link library file
  - FD files out of pragma files
  - stubs for C++ compilers (SPECIAL 11, 12 and CLIB)
  - the files with your own headers inserted
  - files for using local pointers for shared library bases in compilers
    which do not support this normally
  - stub functions for Pascal compilers
  - inline files for GCC
  - inline, pragma and stub libraries using FPU registers
  - files needed to develop for Phase5's PowerUP boards
  - unit texts for FPC Pascal compiler
  - BMAP files for AmigaBASIC and MaxonBASIC
  - VBCC assembler inline files
  - VBCC WOS stub texts and link library
  - VBCC PowerUP stub texts and link library
  - VBCC MorphOS stub texts and link library
  - Modules for AmigaE
  - FD files
  - CLIB files
  - SFD files
  - auto library open files for VBCC
  - MorphOS files

Therefor only the FD file giving the library information is needed. For
some SPECIAL options you may additionally supply the CLIB keyword (or you
need to supply it) giving fd2pragma the prototypes file in clib directory.
Better is to supply the all-in-one SFD format as input.

The command template you get with fd2pragma ? .

Calling the program seems to be (is) very difficult, but it offers you a
large set of functions. A lot of options need a lot of abilities to turn
them on/off!

The documentation contains lots of information about related topics, so
read it!

Short history (full history see source code):
 2.150 08.08.02 : fixed inline files a bit
 2.151 31.08.02 : fixed SPECIAL 46 files (error when no args, but return value)
 2.152 01.09.02 : bug-fix with SPECIAL 47
 2.153 11.09.02 : modified SPECIAl 46 varargs on request of Sebastian Bauer
        and Olaf Barthel
 2.154 03.10.02 : added VBCC MorphOS inlines (SPECIAL 122). Thanks Frank Wille
        for design help.
 2.155 04.10.02 : optimized VBCC MorphOS text (SPECIAL 93), fixed VBCC MorphOS
        inlines
 2.156 06.10.02 : added warning about obsolete types, fixed VBCC MorphOS Code
        (SPECIAL 78)
 2.157 12.10.02 : Fixed CLIB scan problem
 2.158 19.10.02 : added CLIB define in SPECIAL 46

This program is in the public domain. Use it as you want, but WITHOUT ANY
WARRANTY!

Please contact me:

*********************************************************************
* snail-mail:                  * e-mail:                            *
*   Dirk Stoecker              *   stoecker@epost.de                *
*   Geschwister-Scholl-Str. 10 *   dirk@dstoecker.de                *
*   01877 Bischofswerda        * world wide web:                    *
*   GERMANY                    *   http://www.dstoecker.de/         *
* phone:                       * pgp key:                           *
*   GERMANY +49 (0)3594/706666 *   get from WWW pages or keyservers *
*********************************************************************