docs: Update readme

README.md

@@ -1,38 +1,53 @@
-GENERIC PLEX SALVAGE
-====================
+# LVM Salvage Tools
 
-Scan:
-  ./scan.sh '/Warez/Books'
-  ./scan.sh '/Warez/3D Printing'
-  ./scan.sh '/Media/Some Folder'
+Tools to scan and recover files from damaged LVM volumes.
 
-Recover:
-  ./recover.sh '/Warez/Books'
+## Scan:
 
-The source tree is mirrored beneath /mnt/recovery:
-  /Warez/Books -> /mnt/recovery/Warez/Books
+```bash
+  ./scan.sh '/lvm-vol/path1'
+  ./scan.sh '/lvm-vol/path2'
+  ./scan.sh '/lvm-vol/path3'
+```
 
-The scan creates uniquely named manifest/summary files under /mnt/recovery.
+## Recover:
+
+```bash
+  ./recover.sh '/lvm-vol/path1'
+```
+
+The source tree is mirrored beneath `/mnt/recovery`:
+
+```bash
+  /lvm-vol/path1 -> /mnt/recovery/lvm-vol/path1
+  /lvm-vol/path2 -> /mnt/recovery/lvm-vol/path2
+  /lvm-vol/path3 -> /mnt/recovery/lvm-vol/path3
+```
+
+The scan creates uniquely named manifest/summary files under `/mnt/recovery`.
 
 Classifications:
+
+```plain
   SAFE
   LOST
   ETB_LOST
   ETB_SURVIVES
   UNKNOWN
   OTHER
+```
 
-Only SAFE files are recovered.
+Only `SAFE` files are recovered.
 
 Safety:
 - damaged LV must remain kernel read-only;
-- /mnt/recovery must be a separate mounted filesystem;
-- filesystem root "/" is refused;
-- ".." is refused;
+- `/mnt/recovery` must be a separate mounted filesystem;
+- filesystem root `"/"` is refused;
+- `".."` is refused;
 - each file is dumped by inode;
 - dumped byte size must match inode size;
 - existing same-size recovered files are skipped;
-- at least 2 GiB free is preserved on /mnt/recovery.
+- at least 2 GiB free is preserved on `/mnt/recovery`.
 
 Known dead ext4 block range:
   3418636288 - 4395389951