bug#73917: 29.4; Doc string of `wdired-use-dired-vertical-motion'

bug#73917: 29.4; Doc string of `wdired-use-dired-vertical-motion'

[Drew Adams via Bug reports for GNU Emacs, the Swiss army knife of text editors]

I'm no expert on WDired mode.  But I don't notice any difference
depending on the value of option `track-eol'.

According to the doc, when the value of
`wdired-use-dired-vertical-motion' is `sometimes' the cursor is moved to
the beginning of a file name only if point is before it "and `track-eol'
is non-nil".  I question the "and `track-eol' is non-nil" part - it
seems incorrect.

What I think I see is that when the value is `sometimes' and point is
before the file name then the cursor is moved to the beginning of a
file name regardless of the value of `track-eol'.  IOW, it does that
even when `track-eol' is nil.

Am I reading the doc wrong somehow?


In GNU Emacs 29.4 (build 2, x86_64-w64-mingw32) of 2024-07-05 built on
 AVALON
Windowing system distributor 'Microsoft Corp.', version 10.0.19045
System Description: Microsoft Windows 10 Pro (v10.0.2009.19045.5011)

Configured using:
 'configure --with-modules --without-dbus --with-native-compilation=aot
 --without-compress-install --with-sqlite3 --with-tree-sitter
 CFLAGS=-O2'

Configured features:
ACL GIF GMP GNUTLS HARFBUZZ JPEG JSON LCMS2 LIBXML2 MODULES NATIVE_COMP
NOTIFY W32NOTIFY PDUMPER PNG RSVG SOUND SQLITE3 THREADS TIFF
TOOLKIT_SCROLL_BARS TREE_SITTER WEBP XPM ZLIB

(NATIVE_COMP present but libgccjit not available)

Important settings:
  value of $LANG: ENU
  locale-coding-system: cp1252

bug#73917: 29.4; Doc string of `wdired-use-dired-vertical-motion'

[Eli Zaretskii]

> Date: Sun, 20 Oct 2024 20:43:01 +0000
> From:  Drew Adams via "Bug reports for GNU Emacs,
>  the Swiss army knife of text editors" <bug-gnu-emacs@gnu.org>
> 
> I'm no expert on WDired mode.  But I don't notice any difference
> depending on the value of option `track-eol'.
> 
> According to the doc, when the value of
> `wdired-use-dired-vertical-motion' is `sometimes' the cursor is moved to
> the beginning of a file name only if point is before it "and `track-eol'
> is non-nil".  I question the "and `track-eol' is non-nil" part - it
> seems incorrect.
> 
> What I think I see is that when the value is `sometimes' and point is
> before the file name then the cursor is moved to the beginning of a
> file name regardless of the value of `track-eol'.  IOW, it does that
> even when `track-eol' is nil.

You are right.  I fixed the doc string on the emacs-30 branch to
remove the reference to 'track-eol', and I'm therefore closing this
bug.