From 952b66fca6d7f8111bd2e13a5199ffbab251ea28 Mon Sep 17 00:00:00 2001
From: Peter Ferrie <peter.ferrie@gmail.com>
Date: Mon, 27 Aug 2018 21:10:10 -0700
Subject: [PATCH] clarify a corner-case comment

---
 PRORWTS2.S | 7 +++----
 readme.md  | 8 ++++----
 2 files changed, 7 insertions(+), 8 deletions(-)

diff --git a/PRORWTS2.S b/PRORWTS2.S
index eae3fd6..49606d3 100644
--- a/PRORWTS2.S
+++ b/PRORWTS2.S
@@ -41,6 +41,7 @@ ver_02 = 1
                                         ;not compatible with allow_subdir, allow_saplings
                 detect_treof = 0        ;detect EOF during read of tree files
                 allow_sparse = 0        ;enable support for reading sparse files
+                                        ;recommended if enable_write is enabled, to prevent writing to sparse blocks
                 bounds_check = 0        ;set to 1 to prevent access beyond the end of the file
                                         ;but limits file size to 64k-2 bytes.
                 no_interrupts= 0        ;set to 1 to disable interrupts across calls
@@ -499,8 +500,6 @@ unrhddblockhi = *
                 lda     #0
 hddreaddir1     jsr     hddreaddirsel
 
-                ;include volume directory header in count
-
 hddreaddir
 hddfirstent     lda     #NAME_LENGTH
                 sta     bloklo
@@ -629,7 +628,7 @@ unrblockhi = unrelocdsk + (* - reloc)
 
                 ;include volume directory header in count
 
-readdir
+readdir         ;note that calling this location directly limits subdirectories to 14 entries!
   !if might_exist = 1 {
                 ldx     dirbuf + FILE_COUNT ;assuming only 256 files per subdirectory
                 inx
@@ -1912,7 +1911,7 @@ hddreaddir1     jsr     hddreaddirsel
 
                 ;include volume directory header in count
 
-hddreaddir
+hddreaddir      ;note that calling this location directly limits subdirectories to 14 entries!
   !if might_exist = 1 {
                 ldx     hdddirbuf + FILE_COUNT ;assuming only 256 files per subdirectory
                 inx
diff --git a/readme.md b/readme.md
index 0fdb861..f6ba5ff 100644
--- a/readme.md
+++ b/readme.md
@@ -13,10 +13,10 @@ lda #<file_to_read<br>
 sta namlo<br>
 lda #>file_to_read<br>
 sta namhi<br>
-lda #6 ;bytes
-sta sizelo
-lda #0
-sta sizehi
+lda #6 ;bytes<br>
+sta sizelo<br>
+lda #0<br>
+sta sizehi<br>
 jsr opendir ;open and read file into memory at its load address<br>
 <br>
 ;write to an open file with address override<br>