dsktool 0.2.1 → 0.4.1

data/doc/classes/DSK.html

@@ -58,6 +58,10 @@
                 <a href="../files/lib/DSK_rb.html">
                 lib/DSK.rb
                 </a>
+        <br />
+                <a href="../files/test/backup/DSK_rb.html">
+                test/backup/DSK.rb
+                </a>
         <br />
             </td>
         </tr>
@@ -77,16 +81,11 @@
 
 
   <div id="contextContent">
-    <div id="diagram">
-      <map id="map" name="map">
-  <area shape="RECT" coords="5,5,77,53"      href="DSK.html" alt="DSK">
-</map>
-<img src="../dot/f_5.png" usemap="#map" border=0 alt="TopLevel">
-    </div>
 
     <div id="description">
       <p>
-For manipulating <a href="DSK.html">DSK</a> files, as created by ADT (<a
+For manipulating <a href="DSK.html">DSK</a> <a
+href="DSK.html#M000181">files</a>, as created by ADT (<a
 href="http://adt.berlios.de">adt.berlios.de</a>) and ADTPRo (<a
 href="http://adtpro.sourceforge.net">adtpro.sourceforge.net</a>) used by
 many Apple 2 emulators.
@@ -101,16 +100,51 @@ many Apple 2 emulators.
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000053">disassemble_sector</a>&nbsp;&nbsp;
-      <a href="#M000054">dump_disk</a>&nbsp;&nbsp;
-      <a href="#M000052">dump_sector</a>&nbsp;&nbsp;
-      <a href="#M000051">files</a>&nbsp;&nbsp;
-      <a href="#M000050">get_sector</a>&nbsp;&nbsp;
-      <a href="#M000046">is_dos33?</a>&nbsp;&nbsp;
-      <a href="#M000045">is_dsk_file?</a>&nbsp;&nbsp;
-      <a href="#M000047">is_nadol?</a>&nbsp;&nbsp;
-      <a href="#M000048">new</a>&nbsp;&nbsp;
-      <a href="#M000049">read</a>&nbsp;&nbsp;
+      <a href="#M000187">add_file</a>&nbsp;&nbsp;
+      <a href="#M000165">add_file</a>&nbsp;&nbsp;
+      <a href="#M000175">create_new</a>&nbsp;&nbsp;
+      <a href="#M000198">create_new</a>&nbsp;&nbsp;
+      <a href="#M000167">delete_file</a>&nbsp;&nbsp;
+      <a href="#M000189">delete_file</a>&nbsp;&nbsp;
+      <a href="#M000183">disassemble_sector</a>&nbsp;&nbsp;
+      <a href="#M000206">disassemble_sector</a>&nbsp;&nbsp;
+      <a href="#M000182">dump_sector</a>&nbsp;&nbsp;
+      <a href="#M000205">dump_sector</a>&nbsp;&nbsp;
+      <a href="#M000164">file_system</a>&nbsp;&nbsp;
+      <a href="#M000186">file_system</a>&nbsp;&nbsp;
+      <a href="#M000181">files</a>&nbsp;&nbsp;
+      <a href="#M000204">files</a>&nbsp;&nbsp;
+      <a href="#M000168">free_sector_list</a>&nbsp;&nbsp;
+      <a href="#M000190">free_sector_list</a>&nbsp;&nbsp;
+      <a href="#M000203">get_block</a>&nbsp;&nbsp;
+      <a href="#M000180">get_block</a>&nbsp;&nbsp;
+      <a href="#M000200">get_sector</a>&nbsp;&nbsp;
+      <a href="#M000177">get_sector</a>&nbsp;&nbsp;
+      <a href="#M000184">hex_dump</a>&nbsp;&nbsp;
+      <a href="#M000207">hex_dump</a>&nbsp;&nbsp;
+      <a href="#M000191">is_dos33?</a>&nbsp;&nbsp;
+      <a href="#M000169">is_dos33?</a>&nbsp;&nbsp;
+      <a href="#M000185">is_dsk_file?</a>&nbsp;&nbsp;
+      <a href="#M000163">is_dsk_file?</a>&nbsp;&nbsp;
+      <a href="#M000170">is_nadol?</a>&nbsp;&nbsp;
+      <a href="#M000192">is_nadol?</a>&nbsp;&nbsp;
+      <a href="#M000172">is_pascal?</a>&nbsp;&nbsp;
+      <a href="#M000194">is_pascal?</a>&nbsp;&nbsp;
+      <a href="#M000193">is_prodos?</a>&nbsp;&nbsp;
+      <a href="#M000171">is_prodos?</a>&nbsp;&nbsp;
+      <a href="#M000166">make_file</a>&nbsp;&nbsp;
+      <a href="#M000188">make_file</a>&nbsp;&nbsp;
+      <a href="#M000195">new</a>&nbsp;&nbsp;
+      <a href="#M000173">new</a>&nbsp;&nbsp;
+      <a href="#M000199">read</a>&nbsp;&nbsp;
+      <a href="#M000176">read</a>&nbsp;&nbsp;
+      <a href="#M000196">save_as</a>&nbsp;&nbsp;
+      <a href="#M000174">save_as</a>&nbsp;&nbsp;
+      <a href="#M000197">save_as_compressed</a>&nbsp;&nbsp;
+      <a href="#M000202">set_boot_track</a>&nbsp;&nbsp;
+      <a href="#M000179">set_boot_track</a>&nbsp;&nbsp;
+      <a href="#M000178">set_sector</a>&nbsp;&nbsp;
+      <a href="#M000201">set_sector</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -127,6 +161,51 @@ many Apple 2 emulators.
 
       <div class="name-list">
         <table summary="Constants">
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">FILE_SYSTEMS</td>
+          <td>=</td>
+          <td class="context-item-value">[:prodos,:dos33,:nadol,:pascal,:unknown,:none]</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">SECTOR_ORDERS</td>
+          <td>=</td>
+          <td class="context-item-value">[:physical,:prodos_from_dos]</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">DSK_IMAGE_EXTENSIONS</td>
+          <td>=</td>
+          <td class="context-item-value">[&quot;.dsk&quot;,&quot;.po&quot;,&quot;.do&quot;,&quot;.hdv&quot;]</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">INTERLEAVES</td>
+          <td>=</td>
+          <td class="context-item-value">{                 :physical=&gt;   [0x00,0x01,0x02,0x03,0x04,0x05,0x06,0x07,0x08,0x09,0x0A,0x0B,0x0C,0x0D,0x0E,0x0F],                 :prodos_from_dos=&gt;[0x00,0x0E,0x0D,0x0C,0x0B,0x0A,0x09,0x08,0x07,0x06,0x05,0x04,0x03,0x02,0x01,0x0F]</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">DSK_FILE_LENGTH</td>
+          <td>=</td>
+          <td class="context-item-value">143360</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">FILE_SYSTEMS</td>
+          <td>=</td>
+          <td class="context-item-value">[:prodos,:dos33,:nadol,:pascal,:unknown,:none]</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">SECTOR_ORDERS</td>
+          <td>=</td>
+          <td class="context-item-value">[:physical,:prodos_from_dos]</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">DSK_IMAGE_EXTENSIONS</td>
+          <td>=</td>
+          <td class="context-item-value">[&quot;.dsk&quot;,&quot;.po&quot;,&quot;.do&quot;,&quot;.hdv&quot;]</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">INTERLEAVES</td>
+          <td>=</td>
+          <td class="context-item-value">{                 :physical=&gt;   [0x00,0x01,0x02,0x03,0x04,0x05,0x06,0x07,0x08,0x09,0x0A,0x0B,0x0C,0x0D,0x0E,0x0F],                 :prodos_from_dos=&gt;[0x00,0x0E,0x0D,0x0C,0x0B,0x0A,0x09,0x08,0x07,0x06,0x05,0x04,0x03,0x02,0x01,0x0F]</td>
+        </tr>
         <tr class="top-aligned-row context-row">
           <td class="context-item-name">DSK_FILE_LENGTH</td>
           <td>=</td>
@@ -148,6 +227,31 @@ many Apple 2 emulators.
           <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
           <td class="context-item-desc"></td>
         </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">file_bytes</td>
+          <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
+          <td class="context-item-desc"></td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">sector_order</td>
+          <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
+          <td class="context-item-desc"></td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">sector_order</td>
+          <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
+          <td class="context-item-desc"></td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">track_count</td>
+          <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
+          <td class="context-item-desc"></td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">track_count</td>
+          <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
+          <td class="context-item-desc"></td>
+        </tr>
         </table>
       </div>
     </div>
@@ -158,12 +262,65 @@ many Apple 2 emulators.
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
 
-      <div id="method-M000045" class="method-detail">
-        <a name="M000045"></a>
+      <div id="method-M000175" class="method-detail">
+        <a name="M000175"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000175.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000175.html');return false;">
+          <span class="method-name">create_new</span><span class="method-args">(filesystem)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+create a <a href="DSK.html#M000173">new</a> <a href="DSK.html">DSK</a>
+initialised with specified filesystem
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000198" class="method-detail">
+        <a name="M000198"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000198.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000198.html');return false;">
+          <span class="method-name">create_new</span><span class="method-args">(filesystem)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+create a <a href="DSK.html#M000173">new</a> <a href="DSK.html">DSK</a>
+initialised with specified filesystem
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000185" class="method-detail">
+        <a name="M000185"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000185.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000185.html');return false;">
+          <span class="method-name">is_dsk_file?</span><span class="method-args">(filename)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+does this filename have a suitable extension?
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000163" class="method-detail">
+        <a name="M000163"></a>
 
         <div class="method-heading">
-          <a href="DSK.src/M000045.html" target="Code" class="method-signature"
-            onclick="popupCode('DSK.src/M000045.html');return false;">
+          <a href="DSK.src/M000163.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000163.html');return false;">
           <span class="method-name">is_dsk_file?</span><span class="method-args">(filename)</span>
           </a>
         </div>
@@ -175,48 +332,154 @@ does this filename have a suitable extension?
         </div>
       </div>
 
-      <div id="method-M000048" class="method-detail">
-        <a name="M000048"></a>
+      <div id="method-M000195" class="method-detail">
+        <a name="M000195"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000195.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000195.html');return false;">
+          <span class="method-name">new</span><span class="method-args">(file_bytes=&quot;\0&quot;*DSK_FILE_LENGTH,sector_order=:physical)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+create a <a href="DSK.html#M000173">new</a> <a href="DSK.html">DSK</a>
+structure (in memory, not on disk)
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000173" class="method-detail">
+        <a name="M000173"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000173.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000173.html');return false;">
+          <span class="method-name">new</span><span class="method-args">(file_bytes=&quot;\0&quot;*DSK_FILE_LENGTH,sector_order=:physical)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+create a <a href="DSK.html#M000173">new</a> <a href="DSK.html">DSK</a>
+structure (in memory, not on disk)
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000199" class="method-detail">
+        <a name="M000199"></a>
 
         <div class="method-heading">
-          <a href="DSK.src/M000048.html" target="Code" class="method-signature"
-            onclick="popupCode('DSK.src/M000048.html');return false;">
-          <span class="method-name">new</span><span class="method-args">(file_bytes=&quot;\0&quot;*DSK_FILE_LENGTH)</span>
+          <a href="DSK.src/M000199.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000199.html');return false;">
+          <span class="method-name">read</span><span class="method-args">(filename)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-create a new <a href="DSK.html">DSK</a> structure (in memory, not on disk)
+<a href="DSK.html#M000176">read</a> in an existing <a
+href="DSK.html">DSK</a> file (must exist)
 </p>
         </div>
       </div>
 
-      <div id="method-M000049" class="method-detail">
-        <a name="M000049"></a>
+      <div id="method-M000176" class="method-detail">
+        <a name="M000176"></a>
 
         <div class="method-heading">
-          <a href="DSK.src/M000049.html" target="Code" class="method-signature"
-            onclick="popupCode('DSK.src/M000049.html');return false;">
+          <a href="DSK.src/M000176.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000176.html');return false;">
           <span class="method-name">read</span><span class="method-args">(filename)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-read in an existing <a href="DSK.html">DSK</a> file (must exist)
+<a href="DSK.html#M000176">read</a> in an existing <a
+href="DSK.html">DSK</a> file (must exist)
 </p>
         </div>
       </div>
 
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000053" class="method-detail">
-        <a name="M000053"></a>
+      <div id="method-M000187" class="method-detail">
+        <a name="M000187"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000187.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000187.html');return false;">
+          <span class="method-name">add_file</span><span class="method-args">(new_file)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+<a href="DSK.html#M000165">add_file</a> takes a *File object (of a type
+compatible with the underlying file system) and adds it to the in-memory
+image of this <a href="DSK.html">DSK</a> this should be overridden in each
+*Disk type that has write support enabled
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000165" class="method-detail">
+        <a name="M000165"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000165.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000165.html');return false;">
+          <span class="method-name">add_file</span><span class="method-args">(new_file)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+<a href="DSK.html#M000165">add_file</a> takes a *File object (of a type
+compatible with the underlying file system) and adds it to the in-memory
+image of this <a href="DSK.html">DSK</a> this should be overridden in each
+*Disk type that has write support enabled
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000167" class="method-detail">
+        <a name="M000167"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000167.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000167.html');return false;">
+          <span class="method-name">delete_file</span><span class="method-args">(filename)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000189" class="method-detail">
+        <a name="M000189"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000189.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000189.html');return false;">
+          <span class="method-name">delete_file</span><span class="method-args">(filename)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000183" class="method-detail">
+        <a name="M000183"></a>
 
         <div class="method-heading">
-          <a href="DSK.src/M000053.html" target="Code" class="method-signature"
-            onclick="popupCode('DSK.src/M000053.html');return false;">
+          <a href="DSK.src/M000183.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000183.html');return false;">
           <span class="method-name">disassemble_sector</span><span class="method-args">(track,sector)</span>
           </a>
         </div>
@@ -228,29 +491,46 @@ return a formatted hex dump of a single 256 byte sector
         </div>
       </div>
 
-      <div id="method-M000054" class="method-detail">
-        <a name="M000054"></a>
+      <div id="method-M000206" class="method-detail">
+        <a name="M000206"></a>
 
         <div class="method-heading">
-          <a href="DSK.src/M000054.html" target="Code" class="method-signature"
-            onclick="popupCode('DSK.src/M000054.html');return false;">
-          <span class="method-name">dump_disk</span><span class="method-args">()</span>
+          <a href="DSK.src/M000206.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000206.html');return false;">
+          <span class="method-name">disassemble_sector</span><span class="method-args">(track,sector)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-return a formatted hex dump of all sectors on all tracks
+return a formatted hex dump of a single 256 byte sector
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000182" class="method-detail">
+        <a name="M000182"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000182.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000182.html');return false;">
+          <span class="method-name">dump_sector</span><span class="method-args">(track,sector)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+return a formatted hex dump of a single 256 byte sector
 </p>
         </div>
       </div>
 
-      <div id="method-M000052" class="method-detail">
-        <a name="M000052"></a>
+      <div id="method-M000205" class="method-detail">
+        <a name="M000205"></a>
 
         <div class="method-heading">
-          <a href="DSK.src/M000052.html" target="Code" class="method-signature"
-            onclick="popupCode('DSK.src/M000052.html');return false;">
+          <a href="DSK.src/M000205.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000205.html');return false;">
           <span class="method-name">dump_sector</span><span class="method-args">(track,sector)</span>
           </a>
         </div>
@@ -262,12 +542,54 @@ return a formatted hex dump of a single 256 byte sector
         </div>
       </div>
 
-      <div id="method-M000051" class="method-detail">
-        <a name="M000051"></a>
+      <div id="method-M000164" class="method-detail">
+        <a name="M000164"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000164.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000164.html');return false;">
+          <span class="method-name">file_system</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000186" class="method-detail">
+        <a name="M000186"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000186.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000186.html');return false;">
+          <span class="method-name">file_system</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000181" class="method-detail">
+        <a name="M000181"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000181.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000181.html');return false;">
+          <span class="method-name">files</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000204" class="method-detail">
+        <a name="M000204"></a>
 
         <div class="method-heading">
-          <a href="DSK.src/M000051.html" target="Code" class="method-signature"
-            onclick="popupCode('DSK.src/M000051.html');return false;">
+          <a href="DSK.src/M000204.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000204.html');return false;">
           <span class="method-name">files</span><span class="method-args">()</span>
           </a>
         </div>
@@ -276,27 +598,148 @@ return a formatted hex dump of a single 256 byte sector
         </div>
       </div>
 
-      <div id="method-M000050" class="method-detail">
-        <a name="M000050"></a>
+      <div id="method-M000168" class="method-detail">
+        <a name="M000168"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000168.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000168.html');return false;">
+          <span class="method-name">free_sector_list</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000190" class="method-detail">
+        <a name="M000190"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000190.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000190.html');return false;">
+          <span class="method-name">free_sector_list</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000203" class="method-detail">
+        <a name="M000203"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000203.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000203.html');return false;">
+          <span class="method-name">get_block</span><span class="method-args">(block_no)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000180" class="method-detail">
+        <a name="M000180"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000180.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000180.html');return false;">
+          <span class="method-name">get_block</span><span class="method-args">(block_no)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000200" class="method-detail">
+        <a name="M000200"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000200.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000200.html');return false;">
+          <span class="method-name">get_sector</span><span class="method-args">(track,requested_sector,sector_order=@sector_order)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000177" class="method-detail">
+        <a name="M000177"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000177.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000177.html');return false;">
+          <span class="method-name">get_sector</span><span class="method-args">(track,requested_sector,sector_order=@sector_order)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000184" class="method-detail">
+        <a name="M000184"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000184.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000184.html');return false;">
+          <span class="method-name">hex_dump</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+return a formatted hex dump of all sectors on all tracks
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000207" class="method-detail">
+        <a name="M000207"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000207.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000207.html');return false;">
+          <span class="method-name">hex_dump</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+return a formatted hex dump of all sectors on all tracks
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000191" class="method-detail">
+        <a name="M000191"></a>
 
         <div class="method-heading">
-          <a href="DSK.src/M000050.html" target="Code" class="method-signature"
-            onclick="popupCode('DSK.src/M000050.html');return false;">
-          <span class="method-name">get_sector</span><span class="method-args">(track,sector)</span>
+          <a href="DSK.src/M000191.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000191.html');return false;">
+          <span class="method-name">is_dos33?</span><span class="method-args">(sector_order)</span>
           </a>
         </div>
       
         <div class="method-description">
+          <p>
+does this <a href="DSK.html">DSK</a> have a standard Apple DOS 3.3 VTOC?
+</p>
         </div>
       </div>
 
-      <div id="method-M000046" class="method-detail">
-        <a name="M000046"></a>
+      <div id="method-M000169" class="method-detail">
+        <a name="M000169"></a>
 
         <div class="method-heading">
-          <a href="DSK.src/M000046.html" target="Code" class="method-signature"
-            onclick="popupCode('DSK.src/M000046.html');return false;">
-          <span class="method-name">is_dos33?</span><span class="method-args">()</span>
+          <a href="DSK.src/M000169.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000169.html');return false;">
+          <span class="method-name">is_dos33?</span><span class="method-args">(sector_order)</span>
           </a>
         </div>
       
@@ -307,13 +750,240 @@ does this <a href="DSK.html">DSK</a> have a standard Apple DOS 3.3 VTOC?
         </div>
       </div>
 
-      <div id="method-M000047" class="method-detail">
-        <a name="M000047"></a>
+      <div id="method-M000170" class="method-detail">
+        <a name="M000170"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000170.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000170.html');return false;">
+          <span class="method-name">is_nadol?</span><span class="method-args">(sector_order)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000192" class="method-detail">
+        <a name="M000192"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000192.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000192.html');return false;">
+          <span class="method-name">is_nadol?</span><span class="method-args">(sector_order)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000172" class="method-detail">
+        <a name="M000172"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000172.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000172.html');return false;">
+          <span class="method-name">is_pascal?</span><span class="method-args">(sector_order)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000194" class="method-detail">
+        <a name="M000194"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000194.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000194.html');return false;">
+          <span class="method-name">is_pascal?</span><span class="method-args">(sector_order)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000193" class="method-detail">
+        <a name="M000193"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000193.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000193.html');return false;">
+          <span class="method-name">is_prodos?</span><span class="method-args">(sector_order)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000171" class="method-detail">
+        <a name="M000171"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000171.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000171.html');return false;">
+          <span class="method-name">is_prodos?</span><span class="method-args">(sector_order)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000166" class="method-detail">
+        <a name="M000166"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000166.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000166.html');return false;">
+          <span class="method-name">make_file</span><span class="method-args">(filename,contents,file_options={})</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+<a href="DSK.html#M000166">make_file</a> creates a *File object (of a type
+compatible with the underlying file system) from filename, contents and
+options required for the underlying file system. The file is NOT added to
+the in-memory image of this <a href="DSK.html">DSK</a> (call <a
+href="DSK.html#M000165">add_file</a> to do that)
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000188" class="method-detail">
+        <a name="M000188"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000188.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000188.html');return false;">
+          <span class="method-name">make_file</span><span class="method-args">(filename,contents,file_options={})</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+<a href="DSK.html#M000166">make_file</a> creates a *File object (of a type
+compatible with the underlying file system) from filename, contents and
+options required for the underlying file system. The file is NOT added to
+the in-memory image of this <a href="DSK.html">DSK</a> (call <a
+href="DSK.html#M000165">add_file</a> to do that)
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000196" class="method-detail">
+        <a name="M000196"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000196.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000196.html');return false;">
+          <span class="method-name">save_as</span><span class="method-args">(filename)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+write out <a href="DSK.html">DSK</a> to file
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000174" class="method-detail">
+        <a name="M000174"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000174.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000174.html');return false;">
+          <span class="method-name">save_as</span><span class="method-args">(filename)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+write out <a href="DSK.html">DSK</a> to file
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000197" class="method-detail">
+        <a name="M000197"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000197.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000197.html');return false;">
+          <span class="method-name">save_as_compressed</span><span class="method-args">(filename)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+write out <a href="DSK.html">DSK</a> to file
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000202" class="method-detail">
+        <a name="M000202"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000202.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000202.html');return false;">
+          <span class="method-name">set_boot_track</span><span class="method-args">(contents)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+write supplied code to track 0 (from sector 0 to whatever is required) code
+should run from $0801 and can be up to 4KB (16 sectors) in length
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000179" class="method-detail">
+        <a name="M000179"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000179.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000179.html');return false;">
+          <span class="method-name">set_boot_track</span><span class="method-args">(contents)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+write supplied code to track 0 (from sector 0 to whatever is required) code
+should run from $0801 and can be up to 4KB (16 sectors) in length
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000178" class="method-detail">
+        <a name="M000178"></a>
+
+        <div class="method-heading">
+          <a href="DSK.src/M000178.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000178.html');return false;">
+          <span class="method-name">set_sector</span><span class="method-args">(track,sector,contents)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000201" class="method-detail">
+        <a name="M000201"></a>
 
         <div class="method-heading">
-          <a href="DSK.src/M000047.html" target="Code" class="method-signature"
-            onclick="popupCode('DSK.src/M000047.html');return false;">
-          <span class="method-name">is_nadol?</span><span class="method-args">()</span>
+          <a href="DSK.src/M000201.html" target="Code" class="method-signature"
+            onclick="popupCode('DSK.src/M000201.html');return false;">
+          <span class="method-name">set_sector</span><span class="method-args">(track,sector,contents)</span>
           </a>
         </div>