From d086995399a5cede331e746f7117524110ac9174 Mon Sep 17 00:00:00 2001
From: vikingowl <christian@nachtigall.dev>
Date: Mon, 29 Dec 2025 17:32:05 +0100
Subject: [PATCH] docs: update config.example.toml with accurate XDG paths
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add file locations header documenting all XDG paths
- Fix scripts path: $XDG_DATA_HOME not $XDG_CONFIG_HOME
- Document theme location for custom themes
- Document style.css for custom CSS overrides
- Document frecency.json storage location

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 data/config.example.toml | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/data/config.example.toml b/data/config.example.toml
index 42cf860..2b45f85 100644
--- a/data/config.example.toml
+++ b/data/config.example.toml
@@ -1,5 +1,12 @@
 # Owlry Configuration
 # Copy to ~/.config/owlry/config.toml
+#
+# File locations (XDG Base Directory compliant):
+#   Config:  $XDG_CONFIG_HOME/owlry/config.toml   (~/.config/owlry/)
+#   Themes:  $XDG_CONFIG_HOME/owlry/themes/*.css
+#   Style:   $XDG_CONFIG_HOME/owlry/style.css     (custom CSS overrides)
+#   Scripts: $XDG_DATA_HOME/owlry/scripts/        (~/.local/share/owlry/)
+#   Data:    $XDG_DATA_HOME/owlry/frecency.json
 
 [general]
 show_icons = true
@@ -24,8 +31,11 @@ font_size = 14
 border_radius = 12
 
 # Theme: "owl" for built-in dark theme, or leave unset for GTK default
+# Custom themes: place in $XDG_CONFIG_HOME/owlry/themes/{name}.css
 # theme = "owl"
 
+# Custom CSS: create $XDG_CONFIG_HOME/owlry/style.css for additional styling
+
 # Individual color overrides (CSS color values)
 # [appearance.colors]
 # background = "#1a1b26"
@@ -50,6 +60,7 @@ uuctl = true
 calculator = true
 
 # Frecency: boost frequently/recently used items in search results
+# Data stored in $XDG_DATA_HOME/owlry/frecency.json
 frecency = true
 frecency_weight = 0.3  # 0.0 = disabled, 1.0 = strong boost
 
@@ -74,7 +85,7 @@ bookmarks = true
 # Emoji picker (copies to clipboard)
 emoji = true
 
-# Custom scripts from ~/.config/owlry/scripts/
+# Custom scripts from $XDG_DATA_HOME/owlry/scripts/ (~/.local/share/owlry/scripts/)
 scripts = true
 
 # File search (requires fd or locate, trigger with "/ pattern" or "find pattern")