* Forwarded from fidosoft.husky by andrew clarke (3:633/267.1{at}fidonet).
* Originally by: andrew clarke (3:633/267.1), 17 Jan 03 16:41.
* Originally to: All (0/0).

---------- Forwarded message ----------
A new version of Scott Dudley's MSGAPI has been released and supports A LOT
of compilers.  It is based on SMAPI 2.2 and is essentially
backward-compatible with both MSGAPI and SMAPI.

The following file is available for FREQ from 3:633/267 (BinkD only) or on
the web at http://blizzard.dnsalias.org/fidonet/xmsgapi/ .

xmsgap11.zip  164K  XMSGAPI; eXtended MSGAPI - version 1.1. C library to
                    access Squish & *.MSG format message bases for 32-bit
                    DOS, OS/2, Windows, Linux, FreeBSD & BeOS.  Maintained
                    by Andrew Clarke.  E-mail: mail{at}ozzmosis.com  FidoNet:
                    3:633/267.


XMSGAPI; eXtended MSGAPI - version 1.1
Readme

Maintained by Andrew Clarke
E-mail: mail{at}ozzmosis.com
FidoNet: 3:633/267

Squish MSGAPI is copyright Scott J. Dudley.  All rights reserved.
Modifications released to the public domain.

This archive contains the source code for an "extended" Squish MSGAPI
which can be used to access Squish and SDM (*.MSG or Star Dot MSG)
format message bases.  It is based heavily on the SMAPI 2.2 source code,
which was based on MSGAPI38, which was based on Scott Dudley's original
Squish MsgAPI revision 0.0 (dated 1991-11-17) and portions of the Squish
Developers Kit 2.00 (dated 1994-05-23).

The aim of the XMSGAPI project is to produce a library of highly-
portable functions for accessing Squish and SDM format message bases,
while aiming to provide backward-compatibility with the original MSGAPI
(where practical).

The following is an incomplete list of people who have contributed to
the project (either directly or indirectly):

Tobias Ernst, Paul Edwards, David Begley, Andrew Clarke, Jim Nutt, John
Dennis, Sreenath Chary, Pavel Gulchouck, Fedor Lizunkov, Oliver Grimm,
Alex S. Aganichev

All source code modifications are in the public domain, however some of
the source files in this archive are subject to the restrictions
contained in the MSGAPI licensing agreement.  The licensing agreement is
contained in this archive in the file named LICENCE.  In no event should
you proceed to use any of the source files in this archive without
having accepted the terms of the MSGAPI licensing agreement, or such
other agreement as you are able to reach with the author.


Trademarks

Squish, SquishMail and Maximus are trademarks of Scott J. Dudley.


Release notes

This is the first release of XMSGAPI.  Some new bugs may be introduced.
SDM support has not been tested thoroughly.

Essentially this library is almost identical to smapi-2.2, however the
code has been cleaned up and ported to a number of additional compilers.
Note that due to unresolved bugs and/or incomplete code in api_jam.c,
JAM support is currently not compiled into the library by default. 
Also, it is not yet possible to generate a DLL of the XMSGAPI.  These
issues may be corrected in a future release.


Installation

See the file INSTALL for compilation and installation instructions.


Support

You can reach the current maintainer of XMSGAPI, Andrew Clarke, at
FidoNet node 3:633/267, in the FidoNet MAXDEV (Maximus Development) or
FIDOSOFT.HUSKY (Husky Support) conferences, or send e-mail to 
mail{at}ozzmosis.com.

Please send any changes, bug reports or fixes to Andrew via the above
channels.  When sending code changes, context diffs (eg. `diff -c
oldfile.c newfile.c') are prefered.  Please include an explicit public
domain notice in your code.


Porting

If you are currently porting, or wish to port, XMSGAPI to other
compilers operating environments, you may wish to contact Andrew via the
above channels.


Obtaining XMSGAPI

The latest release of XMSGAPI is currently available at
http://blizzard.dnsalias.org/fidonet/xmsgapi/


XMSGAPI; eXtended MSGAPI - version 1.1
Installation Notes

Maintained by Andrew Clarke
E-mail: mail{at}ozzmosis.com
FidoNet: 3:633/267

Please refer to the file named LICENCE for licencing and copyright
information.


Supported Compilers

The following makefiles can be used to compile this release of XMSGAPI:

Compiler                               Target       Makefile
-------------------------------------- ------------ ------------------------
Borland C++ (32-bit OS/2)              xmsgapi.lib  os232\borland\makefile
Borland C++ (32-bit Windows)           xmsgapi.lib  win32\borland\makefile
Digital Mars (32-bit Windows)          xmsgapi.lib  win32\digimars\makefile
DJGPP 2.0                              xmsgapi.a    dos32\djgpp\makefile
EMX 0.9 (32-bit OS/2)                  xmsgapi.a    os232\emx\makefile
GNU C (MingW32) (32-bit Windows)       libxmsgapi.a win32\mingw32\makefile
GNU C (UNIX or BeOS)                   libxmsgapi.a unix\gnu-c\makefile
Intel C++ (32-bit Windows)             xmsgapi.lib  win32\intel\makefile
lcc-win32 (32-bit Windows)             xmsgapi.lib  win32\lcc\makefile
Metaware High C++                      xmsgapi.lib  os232\metaware\makefile
Microsoft Visual C++ 2.0 (32-bit Win)  xmsgapi.lib  win32\msvc20\makefile
Microsoft Visual C++ 6.0 (32-bit Win)  xmsgapi.lib  win32\msvc60\makefile
Watcom C++ (32-bit DOS)                xmsgapi.lib  dos32\watcom\makefile
Watcom C++ (32-bit OS/2)               xmsgapi.lib  os232\watcom\makefile
Watcom C++ (32-bit Windows)            xmsgapi.lib  win32\watcom\makefile

Notes

- 16-bit DOS and OS/2 will not be supported.

- To compile XMSGAPI for UNIX or BeOS, the UNIX makefile and all related
  source files should be in UNIX text file format (linefeeds only, no
  carriage returns).

- There is no makefile to generate a DLL version of XMSGAPI.  This may
  be added in a future version.

- For applications that do not require SDM support, you may define
  MSGAPI_NO_SDM and recompile the library (remember to do "make clean"
  first).  Similarly, for applications that do not require Squish or JAM
  support, you may define MSGAPI_NO_SQUISH or MSGAPI_NO_JAM
  respectively.  This will result in a smaller executable.

- JAM support has been disabled by default in this version due to
  unresolved bugs and/or incomplete code in api_jam.c.  To reenable,
  remove -DMSGAPI_NO_JAM from your makefile.


Compiling

To generate the XMSGAPI library for your compiler/platform, chdir to the
appropriate directory run your make utility (called "make" for most
environments; "nmake" for Microsoft or use "wmake -ms"
for Watcom).  If
your C compiler is unsupported, please contact the XMSGAPI maintainer.

-+- Msged/NT 6.1.1
 + Origin: Blizzard of Ozz, Mt Eliza, Victoria, Australia (3:633/267.1)

--- Msged/NT 6.1.1