From 719da16a0d59dbf287f49126f6e7650e0edf1f6b Mon Sep 17 00:00:00 2001
From: jeangeorge <roger_pierre2@DESKTOP-M1LKF1M>
Date: Wed, 5 Jul 2023 01:30:39 +0200
Subject: [PATCH] doc: about zathura with WSL on Windows

---
 doc/vimtex.txt | 32 ++++++++++++++++++++++++++++++--
 1 file changed, 30 insertions(+), 2 deletions(-)

diff --git a/doc/vimtex.txt b/doc/vimtex.txt
index 9d3df00029..0deeb3c69a 100644
--- a/doc/vimtex.txt
+++ b/doc/vimtex.txt
@@ -5775,8 +5775,8 @@ https://pwmt.org/projects/zathura/
 Zathura is, like MuPDF, a very fast and minimalistic viewer. Compared to
 MuPDF, it allows more user configuration. Zathura has full support for both
 forward and inverse search. Zathura should be straightforward to install and
-use on Linux with Xorg. It should also work on macOS, but users may want to
-read |vimtex-faq-zathura-macos|.
+use on Linux with Xorg. It should also work on macOS and WSL, but users may
+want to read |vimtex-faq-zathura-macos| or |vimtex-faq-zathura-windows-wsl|.
 
 Configuration: >vim
   " Main variant with xdotool
@@ -6083,6 +6083,7 @@ Contents:
 * |vimtex-faq-wsl|
 * |vimtex-faq-sumatrapdf-wsl|
 * |vimtex-faq-zathura-macos|
+* |vimtex-faq-zathura-windows-wsl|
 * |vimtex-faq-texshopviewer|
 * |vimtex-faq-treesitter|
 
@@ -6373,6 +6374,33 @@ A: Yes, it should work.  The following recipe has been reported to work [0],
    [2]: https://github.com/lervag/vimtex/issues/2391#issuecomment-1127678531
    [3]: https://github.com/zegervdv/homebrew-zathura/issues/99
 
+------------------------------------------------------------------------------
+                                               *vimtex-faq-zathura-windows-wsl*
+Q: Does Zathura + VimTeX work on WSL2 ?
+A: Yes, but `systemd` or `D-Bus` must be enabled in particular to make inverse
+   search work properly.
+
+   1. `systemd` is the default for Ubuntu 23.04 running on WSL 2.
+      In this case, there is nothing to do : Zathura and VimTeX should work
+      fine.
+
+   2. Otherwise, if WSL version is 0.67.6 or newer, enable `systemd` by adding
+      the following content to the config file `/etc/wsl.conf`
+      (create the file if it doesn't exist). >
+
+      [boot]
+      systemd=true
+<   
+      Then close WSL by using the command `wsl.exe --shutdown` in PowerShell to
+      restart all WSL instances [0].
+   
+   3. Another approach which also works with older version of WSL consists in
+      setting up `D-Bus` daemons that can be shared in all your WSL consoles.
+      These steps are described in [1].
+   
+   [0]: https://learn.microsoft.com/en-us/windows/wsl/systemd
+   [1]: https://x410.dev/cookbook/wsl/sharing-dbus-among-wsl2-consoles/
+
 ------------------------------------------------------------------------------
                                                         *vimtex-faq-treesitter*
 Q: How does VimTeX compare to Tree-sitter?