unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#51236: 27.2/28 small typos/faq correction?
@ 2021-10-16  5:03 Ian Nehera
  2021-10-16  7:46 ` Eli Zaretskii
  0 siblings, 1 reply; 11+ messages in thread
From: Ian Nehera @ 2021-10-16  5:03 UTC (permalink / raw)
  To: 51236

Hi, I found a couple small typos in 27.2 that are still present in the source for 28.1.

doc/lispref/searching.texi line 2174: missing ’s’ on "describe"
	- Because the match data normally describe[s] …

url-retrieve-synchronously doc-string
lisp/url/url.el line 229:
	- Original: ...or nil if there are no data associated with it (the …
		- Change V1: there [is] no data ...
		- Change V2: or nil if [the buffer contains] no data […] (the …

The other thing I found is that the Emacs FAQ.

doc/misc/efaq.texi line 1905:
Yanking text in isearch recommends ‘M-y’ for yanking text out of the kill
ring. This works, but the cross referenced manual page only mentions
the usual ‘C-y’ method with ‘M-y’ yanking previous kills. Is the manual 
out of date or should the FAQ be updated?

Thanks,
Ian




^ permalink raw reply	[flat|nested] 11+ messages in thread

* bug#51236: 27.2/28 small typos/faq correction?
  2021-10-16  5:03 bug#51236: 27.2/28 small typos/faq correction? Ian Nehera
@ 2021-10-16  7:46 ` Eli Zaretskii
  2021-10-16 22:01   ` Ian Nehera
  0 siblings, 1 reply; 11+ messages in thread
From: Eli Zaretskii @ 2021-10-16  7:46 UTC (permalink / raw)
  To: Ian Nehera; +Cc: 51236

> From: Ian Nehera <delta29@shaw.ca>
> Date: Fri, 15 Oct 2021 22:03:08 -0700
> 
> Hi, I found a couple small typos in 27.2 that are still present in the source for 28.1.

Thank you for your reports.

> doc/lispref/searching.texi line 2174: missing ’s’ on "describe"
> 	- Because the match data normally describe[s] …
> 
> url-retrieve-synchronously doc-string
> lisp/url/url.el line 229:
> 	- Original: ...or nil if there are no data associated with it (the …
> 		- Change V1: there [is] no data ...
> 		- Change V2: or nil if [the buffer contains] no data […] (the …

"Data" is plural, so I think using plural form here is non incorrect.

> The other thing I found is that the Emacs FAQ.
> 
> doc/misc/efaq.texi line 1905:
> Yanking text in isearch recommends ‘M-y’ for yanking text out of the kill
> ring. This works, but the cross referenced manual page only mentions
> the usual ‘C-y’ method with ‘M-y’ yanking previous kills. Is the manual 
> out of date or should the FAQ be updated?

What would you suggest to update and how?  Both C-y and M-y are
mentioned in the manual, and the manual is always more detailed than
any other documentation.  Could you state the problem you see with the
current text?

Thanks again for your interest in Emacs documentation.





^ permalink raw reply	[flat|nested] 11+ messages in thread

* bug#51236: 27.2/28 small typos/faq correction?
  2021-10-16  7:46 ` Eli Zaretskii
@ 2021-10-16 22:01   ` Ian Nehera
  2021-10-17  6:10     ` Eli Zaretskii
  0 siblings, 1 reply; 11+ messages in thread
From: Ian Nehera @ 2021-10-16 22:01 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: 51236

> On Oct 16, 2021, at 12:46 AM, Eli Zaretskii <eliz@gnu.org> wrote:
> "Data" is plural, so I think using plural form here is non incorrect.

It’s not incorrect, it just jumped out to me when I read it. Similar to:
	- There is no data on the disk.
as opposed to:
	- There are no data on the disk.
"Data is” and “data are" are both technically correct so I guess this
one's more of a style choice than a typo.

> What would you suggest to update and how?  Both C-y and M-y are
> mentioned in the manual, and the manual is always more detailed than
> any other documentation.  Could you state the problem you see with the
> current text?

The cross-referenced manual page (Isearch Yanking) doesn’t mention that
`isearch-yank-pop’ (27.2) can yank text when the previous command wasn’t
a yank. The only place it gets mentioned is in a comment in the source:

	;; Fall back on `isearch-yank-kill' for the benefits of people
	;; who are used to the old behavior of `M-y' in isearch mode. In
	;; future, this fallback may be changed if we ever change
	;; `yank-pop' to do something like the kill-ring-browser.

A separate function was made for the `kill-ring-browser’ functionality in 28.1
(isearch-yank-pop) but the old behaviour is still the default (isearch-yank-pop-only).
If that’s going to be the case long term, there should be a note of it in the manual.
Maybe something like:

	…usual ‘M-y’ (‘yank-pop’) command (see Yanking).  [However unlike the usual
	‘M-y’, ‘isearch-yank-pop’ will act like ‘C-y’ when the previous command wasn’t
	a yank. That is, it will yank the most recent kill.]  Clicking ‘mouse-2’ in the…

If the old `M-y’ behaviour WON’T be the default long term, then the FAQ should be
change to something along the lines of:

	[‘C-y’ and ‘M-y’ work the same in searches as they do in normal editing.]  See…

Thanks,
Ian

> On Oct 16, 2021, at 12:46 AM, Eli Zaretskii <eliz@gnu.org> wrote:
> 
>> From: Ian Nehera <delta29@shaw.ca>
>> Date: Fri, 15 Oct 2021 22:03:08 -0700
>> 
>> Hi, I found a couple small typos in 27.2 that are still present in the source for 28.1.
> 
> Thank you for your reports.
> 
>> doc/lispref/searching.texi line 2174: missing ’s’ on "describe"
>> 	- Because the match data normally describe[s] …
>> 
>> url-retrieve-synchronously doc-string
>> lisp/url/url.el line 229:
>> 	- Original: ...or nil if there are no data associated with it (the …
>> 		- Change V1: there [is] no data ...
>> 		- Change V2: or nil if [the buffer contains] no data […] (the …
> 
> "Data" is plural, so I think using plural form here is non incorrect.
> 
>> The other thing I found is that the Emacs FAQ.
>> 
>> doc/misc/efaq.texi line 1905:
>> Yanking text in isearch recommends ‘M-y’ for yanking text out of the kill
>> ring. This works, but the cross referenced manual page only mentions
>> the usual ‘C-y’ method with ‘M-y’ yanking previous kills. Is the manual 
>> out of date or should the FAQ be updated?
> 
> What would you suggest to update and how?  Both C-y and M-y are
> mentioned in the manual, and the manual is always more detailed than
> any other documentation.  Could you state the problem you see with the
> current text?
> 
> Thanks again for your interest in Emacs documentation.






^ permalink raw reply	[flat|nested] 11+ messages in thread

* bug#51236: 27.2/28 small typos/faq correction?
  2021-10-16 22:01   ` Ian Nehera
@ 2021-10-17  6:10     ` Eli Zaretskii
  2021-10-18  7:35       ` Lars Ingebrigtsen
  0 siblings, 1 reply; 11+ messages in thread
From: Eli Zaretskii @ 2021-10-17  6:10 UTC (permalink / raw)
  To: Ian Nehera; +Cc: 51236

> From: Ian Nehera <delta29@shaw.ca>
> Date: Sat, 16 Oct 2021 15:01:22 -0700
> Cc: 51236@debbugs.gnu.org
> 
> > On Oct 16, 2021, at 12:46 AM, Eli Zaretskii <eliz@gnu.org> wrote:
> > "Data" is plural, so I think using plural form here is non incorrect.
> 
> It’s not incorrect, it just jumped out to me when I read it. Similar to:
> 	- There is no data on the disk.
> as opposed to:
> 	- There are no data on the disk.
> "Data is” and “data are" are both technically correct so I guess this
> one's more of a style choice than a typo.

Yes.

> > What would you suggest to update and how?  Both C-y and M-y are
> > mentioned in the manual, and the manual is always more detailed than
> > any other documentation.  Could you state the problem you see with the
> > current text?
> 
> The cross-referenced manual page (Isearch Yanking) doesn’t mention that
> `isearch-yank-pop’ (27.2) can yank text when the previous command wasn’t
> a yank. The only place it gets mentioned is in a comment in the source:
> 
> 	;; Fall back on `isearch-yank-kill' for the benefits of people
> 	;; who are used to the old behavior of `M-y' in isearch mode. In
> 	;; future, this fallback may be changed if we ever change
> 	;; `yank-pop' to do something like the kill-ring-browser.
> 
> A separate function was made for the `kill-ring-browser’ functionality in 28.1
> (isearch-yank-pop) but the old behaviour is still the default (isearch-yank-pop-only).
> If that’s going to be the case long term, there should be a note of it in the manual.
> Maybe something like:
> 
> 	…usual ‘M-y’ (‘yank-pop’) command (see Yanking).  [However unlike the usual
> 	‘M-y’, ‘isearch-yank-pop’ will act like ‘C-y’ when the previous command wasn’t
> 	a yank. That is, it will yank the most recent kill.]  Clicking ‘mouse-2’ in the…

I see no reason to have those details in the manual.  Many Emacs
commands have some DWIM-ish aspects, and we don't always document all
of them in such detail.

Does anyone else think it's important to have those details in the
manual?





^ permalink raw reply	[flat|nested] 11+ messages in thread

* bug#51236: 27.2/28 small typos/faq correction?
  2021-10-17  6:10     ` Eli Zaretskii
@ 2021-10-18  7:35       ` Lars Ingebrigtsen
  2021-10-18 21:44         ` Ian Nehera
  0 siblings, 1 reply; 11+ messages in thread
From: Lars Ingebrigtsen @ 2021-10-18  7:35 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: 51236, Ian Nehera

Eli Zaretskii <eliz@gnu.org> writes:

> I see no reason to have those details in the manual.  Many Emacs
> commands have some DWIM-ish aspects, and we don't always document all
> of them in such detail.
>
> Does anyone else think it's important to have those details in the
> manual?

I think documenting this would go beyond what's useful for somebody
reading the manul.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no





^ permalink raw reply	[flat|nested] 11+ messages in thread

* bug#51236: 27.2/28 small typos/faq correction?
  2021-10-18  7:35       ` Lars Ingebrigtsen
@ 2021-10-18 21:44         ` Ian Nehera
  2021-10-19  2:34           ` Eli Zaretskii
  0 siblings, 1 reply; 11+ messages in thread
From: Ian Nehera @ 2021-10-18 21:44 UTC (permalink / raw)
  To: Lars Ingebrigtsen; +Cc: 51236

Understandable,

What about the FAQ section? Should it be changed to ‘C-y’ to fit with the
manual?

Thanks,
Ian

> On Oct 18, 2021, at 12:35 AM, Lars Ingebrigtsen <larsi@gnus.org> wrote:
> 
> Eli Zaretskii <eliz@gnu.org> writes:
> 
>> I see no reason to have those details in the manual.  Many Emacs
>> commands have some DWIM-ish aspects, and we don't always document all
>> of them in such detail.
>> 
>> Does anyone else think it's important to have those details in the
>> manual?
> 
> I think documenting this would go beyond what's useful for somebody
> reading the manul.
> 
> -- 
> (domestic pets only, the antidote for overdose, milk.)
>   bloggy blog: http://lars.ingebrigtsen.no






^ permalink raw reply	[flat|nested] 11+ messages in thread

* bug#51236: 27.2/28 small typos/faq correction?
  2021-10-18 21:44         ` Ian Nehera
@ 2021-10-19  2:34           ` Eli Zaretskii
  2021-10-19 18:13             ` Ian Nehera
  0 siblings, 1 reply; 11+ messages in thread
From: Eli Zaretskii @ 2021-10-19  2:34 UTC (permalink / raw)
  To: Ian Nehera; +Cc: 51236, larsi

> From: Ian Nehera <delta29@shaw.ca>
> Date: Mon, 18 Oct 2021 14:44:10 -0700
> Cc: Eli Zaretskii <eliz@gnu.org>,
>  51236@debbugs.gnu.org
> 
> Understandable,
> 
> What about the FAQ section? Should it be changed to ‘C-y’ to fit with the
> manual?

I thought you said that what it said wasn't incorrect?  Then why
change it?





^ permalink raw reply	[flat|nested] 11+ messages in thread

* bug#51236: 27.2/28 small typos/faq correction?
  2021-10-19  2:34           ` Eli Zaretskii
@ 2021-10-19 18:13             ` Ian Nehera
  2021-10-20 18:27               ` Stefan Kangas
  0 siblings, 1 reply; 11+ messages in thread
From: Ian Nehera @ 2021-10-19 18:13 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: 51236, Lars Ingebrigtsen

> I thought you said that what it said wasn't incorrect?  Then why
> change it?

I just thought it was odd that the manuals/tutorial all listed ‘C-y’ as the
main way to yank text but then the FAQ suddenly says ‘M-y’. If you
see no issue with it then forget I said anything.

Thanks,
Ian




^ permalink raw reply	[flat|nested] 11+ messages in thread

* bug#51236: 27.2/28 small typos/faq correction?
  2021-10-19 18:13             ` Ian Nehera
@ 2021-10-20 18:27               ` Stefan Kangas
  2021-10-20 20:44                 ` Ian Nehera
  0 siblings, 1 reply; 11+ messages in thread
From: Stefan Kangas @ 2021-10-20 18:27 UTC (permalink / raw)
  To: Ian Nehera; +Cc: 51236, Lars Ingebrigtsen

Ian Nehera <delta29@shaw.ca> writes:

>> I thought you said that what it said wasn't incorrect?  Then why
>> change it?
>
> I just thought it was odd that the manuals/tutorial all listed ‘C-y’ as the
> main way to yank text but then the FAQ suddenly says ‘M-y’. If you
> see no issue with it then forget I said anything.

I think this is just a keybinding in isearch that is more convenient to
use than C-y/M-y.

Are there any other issues to resolve here, or can this bug be closed?





^ permalink raw reply	[flat|nested] 11+ messages in thread

* bug#51236: 27.2/28 small typos/faq correction?
  2021-10-20 18:27               ` Stefan Kangas
@ 2021-10-20 20:44                 ` Ian Nehera
  2021-10-20 21:02                   ` Stefan Kangas
  0 siblings, 1 reply; 11+ messages in thread
From: Ian Nehera @ 2021-10-20 20:44 UTC (permalink / raw)
  To: Stefan Kangas; +Cc: 51236, Lars Ingebrigtsen

It can be closed, thanks for the responses.
Ian

> On Oct 20, 2021, at 11:27 AM, Stefan Kangas <stefan@marxist.se> wrote:
> 
> Ian Nehera <delta29@shaw.ca> writes:
> 
>>> I thought you said that what it said wasn't incorrect?  Then why
>>> change it?
>> 
>> I just thought it was odd that the manuals/tutorial all listed ‘C-y’ as the
>> main way to yank text but then the FAQ suddenly says ‘M-y’. If you
>> see no issue with it then forget I said anything.
> 
> I think this is just a keybinding in isearch that is more convenient to
> use than C-y/M-y.
> 
> Are there any other issues to resolve here, or can this bug be closed?






^ permalink raw reply	[flat|nested] 11+ messages in thread

* bug#51236: 27.2/28 small typos/faq correction?
  2021-10-20 20:44                 ` Ian Nehera
@ 2021-10-20 21:02                   ` Stefan Kangas
  0 siblings, 0 replies; 11+ messages in thread
From: Stefan Kangas @ 2021-10-20 21:02 UTC (permalink / raw)
  To: Ian Nehera; +Cc: 51236, Lars Ingebrigtsen

close 51236 28.1
thanks

Ian Nehera <delta29@shaw.ca> writes:

> It can be closed, thanks for the responses.

I'm therefore closing this bug report.

Thanks again for the bug report!





^ permalink raw reply	[flat|nested] 11+ messages in thread

end of thread, other threads:[~2021-10-20 21:02 UTC | newest]

Thread overview: 11+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2021-10-16  5:03 bug#51236: 27.2/28 small typos/faq correction? Ian Nehera
2021-10-16  7:46 ` Eli Zaretskii
2021-10-16 22:01   ` Ian Nehera
2021-10-17  6:10     ` Eli Zaretskii
2021-10-18  7:35       ` Lars Ingebrigtsen
2021-10-18 21:44         ` Ian Nehera
2021-10-19  2:34           ` Eli Zaretskii
2021-10-19 18:13             ` Ian Nehera
2021-10-20 18:27               ` Stefan Kangas
2021-10-20 20:44                 ` Ian Nehera
2021-10-20 21:02                   ` Stefan Kangas

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).