Add installation notes to source files.

I added comments to all patch files explaining their function and how to install them. Installation instructions were also added to some of the code files as well.

10 files changed, 36 insertions, 0 deletions

diff --git a/Kernel/BlkDev/DskFDC.HC b/Kernel/BlkDev/DskFDC.HC
index 80856b5..4012627 100644
--- a/Kernel/BlkDev/DskFDC.HC
+++ b/Kernel/BlkDev/DskFDC.HC
@@ -4,6 +4,8 @@
     License. See the Copying.TXT file for details.
 */
 
+// TO INSTALL: #include this file after DskATA in MakeBlkDev.HC.
+
 interrupt U0 FDCInt()
 {
   // On IRQ6, set a semaphore for anything waiting for an FDC int
diff --git a/Kernel/KFloppyA.HH b/Kernel/KFloppyA.HH
index 7d0fe4d..63e7b80 100644
--- a/Kernel/KFloppyA.HH
+++ b/Kernel/KFloppyA.HH
@@ -4,6 +4,9 @@
     License. See the Copying.TXT file for details.
 */
 
+// TO INSTALL: #include this file in Kernel.PRJ, before MakeBlkDev is #included.
+// Also #include it in ::/StartOS.HC.
+
 // FDC uses IRQ6 = int 26h
 #define I_FDC	0x26
 #define IRQ_FDC	6
diff --git a/Kernel/KFloppyB2.HH b/Kernel/KFloppyB2.HH
index 09e5326..0af3047 100644
--- a/Kernel/KFloppyB2.HH
+++ b/Kernel/KFloppyB2.HH
@@ -4,6 +4,9 @@
     License. See the Copying.TXT file for details.
 */
 
+// TO INSTALL: #include this file after KernelA.HH in Kernel.PRJ.
+// Also #include it in StartOS.HC.
+
 public extern U0 FDCDMAInit(U16 len);
 public extern U0 FDCDMAPrepWrite();
 public extern U0 FDCDMAPrepRead();
diff --git a/Kernel/Patches/BlkDevAddFDC.HC b/Kernel/Patches/BlkDevAddFDC.HC
index 3a9d749..1f9e75a 100644
--- a/Kernel/Patches/BlkDevAddFDC.HC
+++ b/Kernel/Patches/BlkDevAddFDC.HC
@@ -1,3 +1,7 @@
+// PATCH: Add the ability to create floppy drvs
+// FILE: ::/Kernel/BlkDev/DskAddDev.HC
+// TO INSTALL: #include this file at the end of the switch statement.
+
 case BDT_FLOPPY:
   dv->dv_signature=DRV_SIGNATURE_VAL;
   if (!BlkDevInit(bd))
diff --git a/Kernel/Patches/BlkDevInitFDC.HC b/Kernel/Patches/BlkDevInitFDC.HC
index 3fbe709..630bad8 100644
--- a/Kernel/Patches/BlkDevInitFDC.HC
+++ b/Kernel/Patches/BlkDevInitFDC.HC
@@ -1,3 +1,7 @@
+// PATCH: Add the ability to init floppy BlkDevs
+// FILE: ::/Kernel/BlkDev/DskBlkDev.HC
+// TO INSTALL: #include this file at the end of the switch statement.
+
 case BDT_FLOPPY:
   bd->max_writes=bd->max_reads=bd->spt;
   res=FDCInit(bd);
diff --git a/Kernel/Patches/CBlkDevFDC.HC b/Kernel/Patches/CBlkDevFDC.HC
index d7115f3..82c167c 100644
--- a/Kernel/Patches/CBlkDevFDC.HC
+++ b/Kernel/Patches/CBlkDevFDC.HC
@@ -1,3 +1,7 @@
+// PATCH: Add floppy params to the CBlkDev class
+// FILE: ::/Kernel/KernelA.HH
+// TO INSTALL: #include this file after the second U32 declaration.
+
 U8	cyls,heads,spt,
 	srt,hut,hlt,
 	bps,gpl1,gpl2,
diff --git a/Kernel/Patches/KDefineBDTs.HC b/Kernel/Patches/KDefineBDTs.HC
index 1d55522..1ddeebf 100644
--- a/Kernel/Patches/KDefineBDTs.HC
+++ b/Kernel/Patches/KDefineBDTs.HC
@@ -1,2 +1,6 @@
+// PATCH: Add str for floppy BlkDev type to BlkDev str tbl
+// FILE: ::/Kernel/KDefine.HC
+// TO INSTALL: Comment out the old DefineLstLoad call, then #include this file.
+
 DefineLstLoad("ST_BLKDEV_TYPES",
 	"NULL\0RAM\0ATA\0FILE_READ\0FILE_WRITE\0ATAPI\0FLOPPY\0");
\ No newline at end of file
diff --git a/Kernel/Patches/KFloppyDMA.HC b/Kernel/Patches/KFloppyDMA.HC
index ce673cf..3f01bdb 100644
--- a/Kernel/Patches/KFloppyDMA.HC
+++ b/Kernel/Patches/KFloppyDMA.HC
@@ -4,6 +4,10 @@
     License. See the Copying.TXT file for details.

 */

 

+// PATCH: Adds a buf for floppy DMA xfers.

+// FILE: ::/Kernel/KStart32.HC

+// TO INSTALL: #include this file at the end.

+

 //U8 FDC_DMA[0x4800]; // Floppy DMA buffer

 

 U8 FDC_DMA[0x2400]; // Smaller buffer for one-track-at-a-time ops
\ No newline at end of file
diff --git a/Kernel/Patches/KernelABDTs.HH b/Kernel/Patches/KernelABDTs.HH
index 16cde0b..b300333 100644
--- a/Kernel/Patches/KernelABDTs.HH
+++ b/Kernel/Patches/KernelABDTs.HH
@@ -1,3 +1,7 @@
+// PATCH: Add floppy BlkDev type
+// FILE: ::/Kernel/KernelA.HH
+// TO INSTALL: Comment out the old #defines, then #include this file.
+
 #define BDT_NULL		0
 #define BDT_RAM 		1
 #define BDT_ATA 		2
diff --git a/Kernel/Patches/Let2BlkDevTypeFDC.HC b/Kernel/Patches/Let2BlkDevTypeFDC.HC
index 0632b88..3a2afc3 100644
--- a/Kernel/Patches/Let2BlkDevTypeFDC.HC
+++ b/Kernel/Patches/Let2BlkDevTypeFDC.HC
@@ -1,3 +1,7 @@
+// PATCH: Remaps ltrs W-Z for floppy drives
+// FILE: ::/Kernel/BlkDev/DskDrv.HC
+// TO INSTALL: Comment out the original function, then #include this file.
+
 I64 Let2BlkDevType(U8 drv_let)
 {//Drv letter to BlkDev Type. drv_let=0 not allowed. See BDT_NULL.
   drv_let=Let2Let(drv_let);