What was wrong in the last version ?
The dummy SPrintF-calls must not be removed !! Writing in PPC mode caused
severe mistakes again. See the source code !
Note for developers: If anybody has an ideaa, why the lib locks up, please
email me !

Notice:
This archive is EMAIL-WARE !!
..what da hell is dis ??
Simple... if you use it, simply send me a mail, so I know that
someone is using it !!
There is no copyright on it.

Requires:
* MC68020 or PPC-board with WarpOS V4 (powerpc.library 15.0 or better)

Introduction:
Many developer among you have used the asyncio.library, even me !
The latest version of that one was V39.2. It is now some years old but
still good for plain M68K Amigas.

I decided to continue developing the library for support of PPC-WOS.
I bumped the lib-version to V40.


Advantage of this enhanced asyncio.library:

*  You dont need a PPC to use this library. You can still access all
   V39 functions from a plain 68k-Amiga.

The library is split in two parts:
1. The original V39-M68k functions ! I.e V40 is (of course)
   100% compatible to V39 !
2. The V40 part contains all V39 functions but converted to WarpOS.
   The functions have simply a "PPC" added to the name, e.g
   OpenAsync (M68K) goes OpenAsyncPPC.


Contents of the archive:
The archive contains the FULL SOURCE code for StormC 3.0.
You can use as a tutorial or whatever.
I simply have taken the source from original V39 source and
made the WOS port. That's all.

Also provided are include files for StormC and VBCC !


Developer information.. How to use it ?

The big advantage of asyncio_ppc is, that you can access a file from
both CPU sides !!
Example:
* Open a file in 68k mode
* Read datas in PPC mode
* Close the file in 68k mode
or whatever you like !!


Usage of functions:
It is important, that you must only use the M68k (V39) functions from
the 68k side and you must only use the PPC-funtions (V40) from the PPC side.
Example:
M68k: file=OpenAsync("test",MODE_READ,8192);
PPC:  ReadAsyncPPC(file,buf,1000);
M68k: ReadAsync(file,buf,1000);
M68k: CloseAsync(file);
This one would be wrong:
PPC:  WriteAsync(file,buf,len);
or
M68K: CloseAsyncPPC(file);

Understood ? Simple...
So don't mix up the functions !!

Note: It is important that you use several kBytes of buffer space, to avoid
CPU switches ! The larger the buffer, the less switches !!
I recommend using buffer between 16 kB and 64 kB.
Larger buffers usually dont enhance speed anymore.


Using asyncio V40 will give you no improvement, if you only use the
V39 functions !!


Tests:
The asyncio.library has been successfully tested with the
following programs:
* Digital Almanac II
* Digital Almanac III
* AmigaAMP
* AMPlifier
* CyberQT
* CyberAVI
* ACTION (from OS 3.9)

Enhance your application NOW !!
Feel free to use asyncio V40 as you like !!

Credits:
* Sven Ottemann for StormC linker libs and bugfix.
* Oliver Roberts for VBCC includes.

Internet: http://soft-ware.de/dalmanac

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 1586    3127  50.7% -lh5- aa88 Jun 19  2001 asyncioppc/asyncioppc.readme
[generic]                  782    3812  20.5% -lh5- 2b1a Oct 23  2000 asyncioppc/include/stormc3/clib/asyncio_protos.h
[generic]                  490    2752  17.8% -lh5- 3715 Jun  1  2001 asyncioppc/include/stormc3/lib/asyncio000.lib
[generic]                  768    5900  13.0% -lh5- c057 Jun  1  2001 asyncioppc/include/stormc3/lib/asyncio603.lib
[generic]                  602    1142  52.7% -lh5- 65ff Oct 23  2000 asyncioppc/include/stormc3/libraries/asyncio.h
[generic]                  410    1699  24.1% -lh5- d167 Oct 23  2000 asyncioppc/include/stormc3/pragma/asyncio_lib.h
[generic]                  488    2121  23.0% -lh5- 6307 Jan 19  2001 asyncioppc/include/vbcc/clib/asyncio_protos.h
[generic]                  482    2537  19.0% -lh5- dbbf Jan 19  2001 asyncioppc/include/vbcc/inline/asyncio_protos.h
[generic]                  602    1142  52.7% -lh5- 65ff Jun  1  2001 asyncioppc/include/vbcc/libraries/asyncio.h
[generic]                  126     183  68.9% -lh5- 971f Jan 19  2001 asyncioppc/include/vbcc/proto/asyncio.h
[generic]                 6893   15884  43.4% -lh5- 1704 Jun 19  2001 asyncioppc/libs/asyncio.library
[generic]                 3118   12948  24.1% -lh5- 3f55 Jun 19  2001 asyncioppc/source/async.c
[generic]                  367     681  53.9% -lh5- d42e Jun 19  2001 asyncioppc/source/async.h
[generic]                  277     806  34.4% -lh5- e769 Jun  1  2001 asyncioppc/source/asyncio.fd
[generic]                  410    1700  24.1% -lh5- 3be7 Jun 19  2001 asyncioppc/source/asyncio_lib.h
[generic]                 3414   13098  26.1% -lh5- 7a3a Jun 19  2001 asyncioppc/source/async_ppc.c
[generic]                  144     211  68.2% -lh5- 60aa Jun 19  2001 asyncioppc/source/Lib.c
[generic]                  442    1034  42.7% -lh5- d0b3 Jun 19  2001 asyncioppc/source/ppcasyncio.¶
[generic]                  612    1862  32.9% -lh5- b7f8 Jun 19  2001 asyncioppc/source/ppcasyncio_ppc.¶
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        19 files   22013   72639  30.3%            Jun 23  2001