From 568a435af920fdf0bf7166661bb10bcad685109a Mon Sep 17 00:00:00 2001
From: Dmitry Gutov <dmitry@gutov.dev>
Date: Fri, 12 Jun 2026 06:28:10 +0300
Subject: [PATCH] * lisp/progmodes/project.el (project-vc-dir): Add clarifying
 comment.

---
 lisp/progmodes/project.el | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/lisp/progmodes/project.el b/lisp/progmodes/project.el
index 7e794330b1f..cea78437d20 100644
--- a/lisp/progmodes/project.el
+++ b/lisp/progmodes/project.el
@@ -1610,6 +1610,10 @@ The current buffer's `default-directory' is available as part of
 ;;;###autoload
 (defun project-vc-dir ()
   "Run VC-Dir in the current project's root."
+  ;; This is unfortunately inconsistent with `vc-dir' which calls
+  ;; `file-truename' on the directory.  But following symlink results in
+  ;; "mismatched" project for that buffer and any visited from it.  See
+  ;; <https://lists.gnu.org/archive/html/emacs-devel/2026-06/msg00196.html>.
   (interactive)
   (vc-dir (project-root (project-current t))))