* bug#20654: 25.0.50; doc string of `query-replace': Describe interactive behavior first
@ 2015-05-25 21:35 Drew Adams
2016-04-30 19:29 ` Lars Ingebrigtsen
0 siblings, 1 reply; 2+ messages in thread
From: Drew Adams @ 2015-05-25 21:35 UTC (permalink / raw)
To: 20654
Describe the command first of all from the point of view of an
interactive user, and only secondarily from the point of view of a Lisp
programmer.
The description starts out correctly, in that vein. But it does not
describe the use of a prefix arg. An Emacs user must wade through the
entire description, including specifics about each of the Lisp
parameters, before getting to the info about the prefix arg. And even
then s?he must read attentively or s?he will miss it.
This StackExchange question, as well as comments and answers provided by
fairly experienced Emacs[Lisp] users, supports the need to fix this:
http://emacs.stackexchange.com/q/12688/105
In GNU Emacs 25.0.50.1 (i686-pc-mingw32)
of 2014-10-20 on LEG570
Bzr revision: 118168 rgm@gnu.org-20141020195941-icp42t8ttcnud09g
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
`configure --enable-checking=yes,glyphs CPPFLAGS=-DGLYPH_DEBUG=1'
^ permalink raw reply [flat|nested] 2+ messages in thread
* bug#20654: 25.0.50; doc string of `query-replace': Describe interactive behavior first
2015-05-25 21:35 bug#20654: 25.0.50; doc string of `query-replace': Describe interactive behavior first Drew Adams
@ 2016-04-30 19:29 ` Lars Ingebrigtsen
0 siblings, 0 replies; 2+ messages in thread
From: Lars Ingebrigtsen @ 2016-04-30 19:29 UTC (permalink / raw)
To: Drew Adams; +Cc: 20654
Drew Adams <drew.adams@oracle.com> writes:
> Describe the command first of all from the point of view of an
> interactive user, and only secondarily from the point of view of a Lisp
> programmer.
>
> The description starts out correctly, in that vein. But it does not
> describe the use of a prefix arg. An Emacs user must wade through the
> entire description, including specifics about each of the Lisp
> parameters, before getting to the info about the prefix arg. And even
> then s?he must read attentively or s?he will miss it.
>
> This StackExchange question, as well as comments and answers provided by
> fairly experienced Emacs[Lisp] users, supports the need to fix this:
> http://emacs.stackexchange.com/q/12688/105
I've now moved it earlier and rephrased it.
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog: http://lars.ingebrigtsen.no
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2016-04-30 19:29 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2015-05-25 21:35 bug#20654: 25.0.50; doc string of `query-replace': Describe interactive behavior first Drew Adams
2016-04-30 19:29 ` Lars Ingebrigtsen
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).