document differences between 2.1/3.2 and 3.3

This commit is contained in:
Bradley Bell 2023-10-21 15:42:23 -07:00
parent b4b947dba7
commit 836917b283

View File

@ -37,14 +37,14 @@ import com.webcodepro.applecommander.util.TextBundle;
/** /**
* Manages a disk that is in the RDOS format. * Manages a disk that is in the RDOS format.
* <p> * <p>
* Note that the RDOS block interleave is different than the standard DOS 3.3 format. * Note that the RDOS 2.1/3.2 block interleave is different than the standard DOS 3.3 format.
* Thus, when the image is made, the sectors are skewed differently - use readRdosBlock * Thus, when the image is made, the sectors are skewed differently - use readRdosBlock
* to read the appropriate block number. * to read the appropriate block number.
* <p> * <p>
* Also note that the operating system is itself the first file. Block #0 is really * Also note that the operating system is itself the first file. Block #0 is really
* track 0, sector 0 - meaning that the first file should not (cannot) be deleted. * track 0, sector 0 - meaning that the first file should not (cannot) be deleted.
* <p> * <p>
* RDOS appears to have been placed on 13 sector disks. This limits the number of blocks * RDOS 2.1/3.2 was placed on 13 sector disks. This limits the number of blocks
* to 455. It also may also cause incompatibilities with other formats and other cracks. * to 455. It also may also cause incompatibilities with other formats and other cracks.
* <p> * <p>
* Date created: Oct 7, 2002 2:03:58 PM * Date created: Oct 7, 2002 2:03:58 PM
@ -53,7 +53,7 @@ import com.webcodepro.applecommander.util.TextBundle;
public class RdosFormatDisk extends FormattedDisk { public class RdosFormatDisk extends FormattedDisk {
private TextBundle textBundle = StorageBundle.getInstance(); private TextBundle textBundle = StorageBundle.getInstance();
/** /**
* The RDOS disks are structured in a different order than DOS 3.3. * RDOS 2.1/3.2 disks are structured in a different order than DOS 3.3.
* This table interpolates between the RDOS ordering and the DOS * This table interpolates between the RDOS ordering and the DOS
* ordering. It appears that RDOS may use the physical sector number * ordering. It appears that RDOS may use the physical sector number
* instead of the logical sector. * instead of the logical sector.
@ -142,12 +142,12 @@ public class RdosFormatDisk extends FormattedDisk {
} }
/** /**
* Read an RDOS block. The sector skewing for RDOS seems to be different. * Read an RDOS block. The sector skewing for RDOS 2.1/3.2 is different.
* This routine will convert the block number to a DOS track and sector, * This routine will convert the block number to a DOS track and sector,
* handling the sector change-over. The readSector method then should * handling the sector change-over. The readSector method then should
* take care of various image formats. * take care of various image formats.
* <p> * <p>
* Note that sectorSkew has the full 16 sectors, even though RDOS * Note that sectorSkew has the full 16 sectors, even though RDOS 2.1/3.2
* itself is a 13 sector format. * itself is a 13 sector format.
*/ */
public byte[] readRdosBlock(int block) { public byte[] readRdosBlock(int block) {
@ -157,7 +157,7 @@ public class RdosFormatDisk extends FormattedDisk {
} }
/** /**
* Write an RDOS block. The sector skewing for RDOS seems to be different. * Write an RDOS block. The sector skewing for RDOS2.1/3/2 is different.
* This routine will convert the block number to a DOS track and sector, * This routine will convert the block number to a DOS track and sector,
* handling the sector change-over. The writeSector method then should * handling the sector change-over. The writeSector method then should
* take care of various image formats. * take care of various image formats.
@ -438,6 +438,7 @@ public class RdosFormatDisk extends FormattedDisk {
* would be) and executes that code for the directory. * would be) and executes that code for the directory.
* AppleCommander will need to either clone the code or write * AppleCommander will need to either clone the code or write
* its own routine. This is RDOS block #25. * its own routine. This is RDOS block #25.
* FIXME - Doesn't handle native 16-sector (RDOS 3.3) format.
* @see com.webcodepro.applecommander.storage.FormattedDisk#format() * @see com.webcodepro.applecommander.storage.FormattedDisk#format()
*/ */
public void format() { public void format() {