From: Drew Adams <drew.adams@oracle.com>
To: 63875@debbugs.gnu.org
Subject: bug#63875: 26.3; Doc of `dired-guess-shell-alist-user'
Date: Sat, 3 Jun 2023 16:08:11 +0000 [thread overview]
Message-ID: <SJ0PR10MB5488D253196272FA746700FFF34FA@SJ0PR10MB5488.namprd10.prod.outlook.com> (raw)
The doc string doesn't say what REGEXP is, e.g., what it's intended to
match. It should say that up front and explicitly.
Manual (dired-x) `Shell Command Guessing' sort of says it, if you read
carefully and guess a bit.
Please say explicitly that REGEXP is a regexp that's used to match file
names. And say how the alist entries are used. All that's said, so
far, is that this is a "User-defined alist of rules for suggested
commands."
Rules used how? What does matching file names have to do with using a
command? Again, the manual does say this somewhat, but not the doc
string.
The doc refers to `dired-guess-shell-alist-default', but the doc for
that variable doesn't explain anything, so it doesn't help with the
missing info for `dired-guess-shell-alist-user'.
FWIW, the comment in file dired-x.el that introduces these variables
describes them better than the doc in some ways: what they're for, how
they're used.
In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32)
of 2019-08-29
Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd
Windowing system distributor `Microsoft Corp.', version 10.0.19045
Configured using:
`configure --without-dbus --host=x86_64-w64-mingw32
--without-compress-install 'CFLAGS=-O2 -static -g3''
next reply other threads:[~2023-06-03 16:08 UTC|newest]
Thread overview: 11+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-06-03 16:08 Drew Adams [this message]
2023-06-03 16:14 ` bug#63875: 26.3; Doc of `dired-guess-shell-alist-user' Drew Adams
2023-06-04 16:44 ` Juri Linkov
2023-06-03 16:16 ` Eli Zaretskii
2023-06-03 16:21 ` Drew Adams
2023-06-03 16:24 ` Eli Zaretskii
2023-06-03 16:26 ` Drew Adams
2023-06-03 16:29 ` Eli Zaretskii
2023-06-03 17:20 ` Drew Adams
2023-06-03 18:50 ` Eli Zaretskii
2023-06-03 19:29 ` Drew Adams
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=SJ0PR10MB5488D253196272FA746700FFF34FA@SJ0PR10MB5488.namprd10.prod.outlook.com \
--to=drew.adams@oracle.com \
--cc=63875@debbugs.gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.