From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Sat, 21 Aug 2021 14:20:30 +0000 (+0200)
Subject: Clarify dired-jump doc string
X-Git-Tag: emacs-28.0.90~1379
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=7ee5d36008b99358748630631a7525c44d3ee147;p=emacs.git

Clarify dired-jump doc string

* lisp/dired.el (dired-jump): Make the doc string say what happens
in buffers not visiting files (bug#14733).
---

diff --git a/lisp/dired.el b/lisp/dired.el
index 0add0ab3887..3789bef0efb 100644
--- a/lisp/dired.el
+++ b/lisp/dired.el
@@ -4495,11 +4495,18 @@ Ask means pop up a menu for the user to select one of copy, move or link."
 ;;;###autoload
 (defun dired-jump (&optional other-window file-name)
   "Jump to Dired buffer corresponding to current buffer.
-If in a file, Dired the current directory and move to file's line.
+If in a buffer visiting a file, Dired the current directory and
+move to that file's line.
+
+If the current buffer isn't visiting a file, jump to the
+`default-directory' Dired buffer.
+
 If in Dired already, pop up a level and goto old directory's line.
 In case the proper Dired file line cannot be found, refresh the dired
 buffer and try again.
+
 When OTHER-WINDOW is non-nil, jump to Dired buffer in other window.
+
 When FILE-NAME is non-nil, jump to its line in Dired.
 Interactively with prefix argument, read FILE-NAME."
   (interactive