From 06e3ff6671b45ffde8cbfa98ce2743fb9d46319d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Zolt=C3=A1n=20Reegn?= <zoltan.reegn@gmail.com>
Date: Tue, 14 Mar 2023 11:42:27 +0100
Subject: [PATCH] docs(lsp): opt-out of default LSP "gq" #22615

close #22611
---
 runtime/doc/lsp.txt | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/runtime/doc/lsp.txt b/runtime/doc/lsp.txt
index ca65251a9f..25293eb9b2 100644
--- a/runtime/doc/lsp.txt
+++ b/runtime/doc/lsp.txt
@@ -137,7 +137,19 @@ FAQ                                                     *lsp-faq*
      " Auto-format *.rs (rust) files prior to saving them
      " (async = false is the default for format)
      autocmd BufWritePre *.rs lua vim.lsp.buf.format({ async = false })
+<
+- Q: How can I disable LSP formatting when using the |gq| command?
+  A: To use the default internal formatting method and bypass the LSP client's
+  'formatexpr', use |gw| instead.
+  Alternatively you can completely disable LSP formatting with gq by
+  unsetting 'formatexpr':
 
+>lua
+    vim.api.nvim_create_autocmd('LspAttach', {
+        callback = function(args)
+            vim.bo[args.buf].formatexpr = nil
+        end,
+    })
 <
                                                            *lsp-vs-treesitter*
 - Q: How do LSP and Treesitter compare?