From ee923c682232153e39d9c4a94810cedb9f771d2b Mon Sep 17 00:00:00 2001
From: Thomas Harmon <thomas.alan.harmon@gmail.com>
Date: Thu, 2 Apr 2020 09:40:30 -0400
Subject: [PATCH] Add note to README about fix for v0.2->v0.3 db
 incompatability error (#53)

---
 README.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/README.md b/README.md
index 516e2c6..088092a 100644
--- a/README.md
+++ b/README.md
@@ -130,3 +130,22 @@ NOTE: PWD hooks are currently not supported for POSIX shells.
 - `$_ZO_MAXAGE`: sets the maximum total rank after which entries start getting deleted
 
 [`dirs` documentation]: https://docs.rs/dirs/latest/dirs/fn.data_local_dir.html
+
+## Notes
+
+If you recently updated `zoxide` from an older version to `v0.3` and are 
+seeing the following error:
+
+```
+Error: could not deserialize old database
+
+Caused by:
+    io error: failed to fill whole buffer
+```
+
+It is because v0.2 and v0.3 databases are incompatible. There is a script to 
+automatically migrate your database to the new format, but it seems to be 
+failing on some systems.
+
+For a quick fix, you can try removing the old database file: `rm ~/.zo`
+