From fec3796e076a18c269fd9c0047b2417efb14ea15 Mon Sep 17 00:00:00 2001
From: rfjakob
Date: Sun, 5 Jun 2016 15:18:11 +0200
Subject: Updated Compatibility (markdown)

---
 Compatibility.md | 23 +++++++++++++----------
 1 file changed, 13 insertions(+), 10 deletions(-)

diff --git a/Compatibility.md b/Compatibility.md
index a03465a..5320877 100644
--- a/Compatibility.md
+++ b/Compatibility.md
@@ -1,11 +1,14 @@
-gocryptfs tries to keep on-disk format compatibility and new versions can mount filesystems created by several older versions.
-From time to time, major revisions drop compatibility to very old filesystems to keep the gocryptfs code simple and maintainable. As seen on the table below, v1.0 will be the first version to drop support for very old filesystems.
+gocryptfs uses ext4-style *feature flags* to add new functionality or better security to the on-disk-format. These are stored in `gocryptfs.conf` as `FeatureFlags`. When a new feature flag is added, gocryptfs will continue to support mounting older filesystems that do not have this flag set.
 
-| can be mounted on  ▶ | v0.4 | v0.5 | v0.6 | v0.7 & v0.8 | v0.9 & v0.10 | v1.0 |
-|----------------------|------|------|------|-------------|--------------|------|
-| ▼ **filesystem version**     |      |      |      |             |              |      |
-| v0.4                 | Y    | Y    | Y    | Y           | Y            | -    |
-| v0.5                 | -    | Y    | Y    | Y           | Y            | -    |
-| v0.6                 | -    | -    | Y    | Y           | Y            | -    |
-| v0.7 & v0.8          | -    | -    | -    | Y           | Y            | Y    |
-| v0.9 & v0.10 & v1.0  | -    | -    | -    | -           | Y            | Y    |
\ No newline at end of file
+However, from time to time major gocryptfs revisions will drop support for very old filesystems. This keeps the gocryptfs code base clean and maintainable.
+
+As seen on the table below, v1.0 will be the first version to drop support for very old filesystems.
+
+|                   | can be mounted on ▶                  | v0.4 | v0.5 | v0.6 | v0.7 | v0.8 | v0.9 | v0.10 | v1.0 |
+|-------------------|--------------------------------------|------|------|------|------|------|------|-------|------|
+| ▼ **created by**  | ▼ **feature flags**                  |      |      |      |      |      |      |       |      |
+| v0.4              | -                                    | Y    | Y    | Y    | Y    | Y    | Y    | Y     | -    |
+| v0.5              | DirIV                                | -    | Y    | Y    | Y    | Y    | Y    | Y     | -    |
+| v0.6              | DirIV, EMENames                      | -    | -    | Y    | Y    | Y    | Y    | Y     | -    |
+| v0.7, v0.8        | DirIV, EMENames, GCMIV128            | -    | -    | -    | Y    | Y    | Y    | Y     | Y    |
+| v0.9, v0.10, v1.0 | DirIV, EMENames, GCMIV128, LongNames | -    | -    | -    | -    | -    | Y    | Y     | Y    |
\ No newline at end of file
-- 
cgit v1.2.3