diff --git a/doc/FORMAT.md b/doc/FORMAT.md
index c832a4bdd..2d83110da 100644
--- a/doc/FORMAT.md
+++ b/doc/FORMAT.md
@@ -18,3 +18,7 @@
 
 - Store default sections before file/link/path sections to avoid two passes on load.
 - Format backup labels using gmtime().
+
+## Options
+
+- Disable symlinks by default on `posix` repos. This is a convenience feature for manual access to the repo and it makes more sense to make it optional.