Better autogenerated documentation.

doc/disk-mac.md

@@ -1,5 +1,7 @@
+mac
+====
+## 400kB/800kB 3.5" GCR
 <!-- This file is automatically generated. Do not edit. -->
-# 400kB/800kB 3.5" GCR
 
 Macintosh disks come in two varieties: the newer 1440kB ones, which are
 perfectly ordinary PC disks you should use the `ibm` profile to read them, and
@@ -36,11 +38,23 @@ standard for disk images is to omit it. If you want them, specify that you want
 
 ## Options
 
-  - Format variant:
+  - Format variants:
       - `400`: 400kB 80-track SSDD
       - `800`: 800kB 80-track DSDD
   - `metadata`: read/write 524 byte sectors
 
+## Examples
+
+To read:
+
+  - `fluxengine read mac --400 -s drive:0 -o mac.dsk`
+  - `fluxengine read mac --800 -s drive:0 -o mac.dsk`
+
+To write:
+
+  - `fluxengine write mac --400 -d drive:0 -i mac.dsk`
+  - `fluxengine write mac --800 -d drive:0 -i mac.dsk`
+
 ## References
 
   - [MAME's ap_dsk35.cpp file](https://github.com/mamedev/mame/blob/4263a71e64377db11392c458b580c5ae83556bc7/src/lib/formats/ap_dsk35.cpp),