doc: add theme inheritance example (#4096)

1 files changed, 15 insertions, 0 deletions

diff --git a/book/src/themes.md b/book/src/themes.md
index b92b6d7b..4cded68f 100644
--- a/book/src/themes.md
+++ b/book/src/themes.md
@@ -89,6 +89,21 @@ Less common modifiers might not be supported by your terminal emulator.
 | `hidden`       |
 | `crossed_out`  |
 
+### Inheritance
+
+Extend upon other themes by setting the `inherits` property to an existing theme.
+
+```toml
+inherits = "boo_berry"
+
+# Override the theming for "keyword"s:
+"keyword" = { fg = "gold" }
+
+# Override colors in the palette:
+[palette]
+berry = "#2A2A4D"
+```
+
 ### Scopes
 
 The following is a list of scopes available to use for styling.