IMPORTANT
=========

If you want to run ADE program under pOS you need this beta ixemul-47.0.
However, since this library is still a *beta* version I hereby explicitly
reserve the right to change ixemul-47.0 in ways that may not be backwards
compatible with this beta version.

I also request that you do not upload this beta library to Internet sites.
Once this library is out of beta, it will be uploaded to Aminet as the
official, final version.

                        Hans Verkuil    (hans@wyst.hobby.nl)




Starting with ixemul 46.0 some basic support for pOS has been added.
Ixemul-47.0 contains full pOS support, but at the moment this version
is less stable than 46.1, so it shouldn't be used except on pOS.

It turns out that the link formats are identical between AmigaOS and pOS,
and that pOS will set the d0 register to 'pOS\0' when your program is first
called. So the ixemul startup code can test under which OS it is running by
testing the d0 register and use the appropriate code for each OS. This way
you can run the same program under both AmigaOS and pOS, as long as no
kernel calls are used by your program, only ixemul calls are allowed.

If you nevertheless want to use kernel calls, you must test the "int ix_os;"
global variable which is set to 0 when running under AmigaOS and to
OS_IS_POS (see ix.h for the OS_IS_AMIGAOS and OS_IS_POS macros) when
running under pOS.

If your program only supports AmigaOS for example, then you should test
this global like this:

        if (ix_os != OS_IS_AMIGAOS)
        {
          ix_req(NULL, "Abort", NULL, "%s supports only AmigaOS!", __progname);
          exit(20);
        }

The function ix_req is an OS independent function that will show a
requester with the given format string, title and buttons.  See ix.h
for the prototypes.

Finally, the libc.a debug function KPrintF() has been adapted to work on both
OSes.

There is one class of programs that will not (yet) work on both OSes, and
that are the programs that use the shared ixlibraries. E.g. all the X
clients will for now only work on AmigaOS.

But all other programs, as long as they don't use kernel calls, will work
on both OSes.

As I said, to run them under pOS, you will need ixemul-47.0, which is
currently in beta. I had to change a lot of things, often lowlevel
functions, so if you don't use pOS ixemul-46.1 is the best choice. There
are no functional differences between 46.1 and 47.0, so you don't lose
anything.

                     Hans Verkuil (30-3-1997)