From cb852d115b0417ad0e256e6db6685428791b32ee Mon Sep 17 00:00:00 2001
From: Barrett Ruth <62671086+barrettruth@users.noreply.github.com>
Date: Fri, 6 Mar 2026 11:22:13 -0500
Subject: [PATCH] docs: document picker integration via `extra_filetypes`
 (#164)

## Problem

`extra_filetypes = { 'diff' }` enables highlighting in telescope,
snacks, and fzf-lua git preview buffers, but this was not documented
beyond a brief mention of `.diff` files.

## Solution

Add a README FAQ entry and expand the vimdoc `extra_filetypes` field
description to mention specific pickers and which previewer styles are
supported.
---
 doc/diffs.nvim.txt | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/doc/diffs.nvim.txt b/doc/diffs.nvim.txt
index f0205d5..e1541e2 100644
--- a/doc/diffs.nvim.txt
+++ b/doc/diffs.nvim.txt
@@ -184,6 +184,12 @@ Configuration is done via `vim.g.diffs`. Set this before the plugin loads:
                                    extra_filetypes = { 'diff' },
                                  }
 <
+                             Adding `'diff'` also enables highlighting in
+                             picker preview buffers that set `filetype=diff`:
+                             telescope.nvim (git_commits, git_bcommits,
+                             git_status), snacks.nvim (syntax style only),
+                             and fzf-lua (builtin previewer only). Terminal-
+                             based previewers are not supported.
 
         {highlights}         (table, default: see below)
                              Controls which highlight features are enabled.