###############################################################################
# README.aspi :: Information about this build of 'CDR-Tools' for OS/2         #
# --------------------------------------------------------------------------- #
# This is an ASPI-build of the 'CDR-Tools' for the OS/2 platform.             #
#                                                                             #
# This software is currently under development and thus in *ALPHA* state.     #
# Therefore, this README starts with a WARNING about that.                    #
# It will be removed when the software exits alpha state.                     #
#                                                                             #
# By using this software you implicitly agree none of its authors can be held #
# liable for any damages resulting of its use.                                #
###############################################################################

At this time, 20170403, there are issues with 'OS2CDROM.DMD' handling certain
SCSI commands when using USB devices. These issues first need to be resolved
before 'OS2CDROM.DMD' can function as the burner backend for CDR-Tools.

In the mean time, this ASPI-build is provided which uses 'ASPIROUT.SYS' by
default. Please note that this build does not support USB devices.


!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! CDR-Tools v3 for OS/2 -- *ALPHA LEVEL SOFTWARE*          [build:20170403] !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

THIS IS AN *ALPHA* ASPI-BUILD OF THE CDR-TOOLS VERSION 3 FOR OS/2.
IT USES THE 'ASPIROUT.SYS' DRIVER ('aspirou$') TO ACCESS DEVICES.

THE FOLLOWING REASONS MAKE THIS *ALPHA* SOFTWARE:
- A custom build-system is used, which has not been properly tuned yet
- Timing and buffer issues may occur
- More...

BEING *ALPHA* BURNER SOFTWARE, *** IT CAN FRY DISCS *** !
FIRST USE THE '-scanbus' OPTION TO SEE WHAT DEVICES IT FINDS.
BEST IS TO FIRST TRY BLANKING A DVD+RW DISC.
THEN TRY BURNING AN ISO ON THAT BLANK DVD+RW DISC.

THE 'mkisofs.exe' TOOL HAS HAD NO TESTING YET WHATSOEVER.
OTHER (DIAGNOSTIC) PROGRAMS OF THE PACKAGE ARE CURRENTLY ABSENT.

SINCE THIS IS *ALPHA* SOFTWARE, THE DEVELOPER IS MOST PROBABLY AWARE OF
VARIOUS ISSUES. HOWEVER, ANYONE IS FREE TO REPORT ISSUES AT THE E-MAIL
ADDRESS BELOW. A SUBJECT OF 'CDR-Tools -- my issue description' WOULD BE
APPRECIATED. PLEASE ALSO PROVIDE THE BLDLEVEL INFORMATION OF THE TOOL USED.


Ben Rietbroek,
  rdpe@gmx.com



===============================================================================
= THE INFORMATION BELOW IS FROM PREVIOUS (v2) PORTS TO THE OS/2 PLATFORM      =
= FOR NOW, IT HAS BEEN RETAINED IN THIS README FOR COMPLETENESS               =
===============================================================================

Compiling on OS/2:

1)	Install EMX

2)	You need /bin/sh, /bin/rm, /bin/mv

	Create a directory /bin and put /bin/sh into this directory
	mkdir /bin
	cp -p d:/emx/bin/sh.exe /bin
	cp -p d:/emx/bin/rm.exe /bin
	cp -p d:/emx/bin/mv.exe /bin




/*--------------------------------------------------------------------------*/
Note that the Joliet implementation on OS/2 is buggy:

It expects the file in the directories in the wrong order.
While Microsoft wants the files to be in ASCII (binary) order,
OS/2 likes to have the files in lexical order (uppercase and
lowercase together). This makes CD's with Joliet attributes
unreadable on OS/2 if there are files that start the same way
but differ in case.
/*--------------------------------------------------------------------------*/
