Better autogenerated documentation.

doc/disk-apple2.md

@@ -1,5 +1,7 @@
+apple2
+====
+## Prodos, Appledos, and CP/M
 <!-- This file is automatically generated. Do not edit. -->
-# Prodos, Appledos, and CP/M
 
 Apple II disks are nominally fairly sensible 40-track, single-sided, 256
 bytes-per-sector jobs. However, they come in two varieties: DOS 3.3/ProDOS and
@@ -42,7 +44,7 @@ volume.
 
 ## Options
 
-  - Format variant:
+  - Format variants:
       - `140`: 140kB 5.25" 35-track SS
       - `640`: 640kB 5.25" 80-track DS
   - Filesystem and sector skew:
@@ -52,6 +54,18 @@ volume.
       - `cpm`: use CP/M soft sector skew and filesystem
   - `side1`: for AppleDOS file system access, read the volume on side 1 of a disk
 
+## Examples
+
+To read:
+
+  - `fluxengine read apple2 --140 -s drive:0 -o apple2.img`
+  - `fluxengine read apple2 --640 -s drive:0 -o apple2.img`
+
+To write:
+
+  - `fluxengine write apple2 --140 -d drive:0 -i apple2.img`
+  - `fluxengine write apple2 --640 -d drive:0 -i apple2.img`
+
 ## References
 
   - [Beneath Apple DOS](https://fabiensanglard.net/fd_proxy/prince_of_persia/Beneath%20Apple%20DOS.pdf)