From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#35885: 25.2; Few mistakes in Emacs Manual (+ proposals) Date: Mon, 03 Jun 2019 19:36:17 +0300 Message-ID: <83k1e2tym6.fsf@gnu.org> References: Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="80096"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 35885-done@debbugs.gnu.org To: Sebastian Urban Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jun 03 18:42:16 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1hXq2D-000KbE-QK for geb-bug-gnu-emacs@m.gmane.org; Mon, 03 Jun 2019 18:42:10 +0200 Original-Received: from localhost ([127.0.0.1]:37900 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hXq2C-0005Gz-H4 for geb-bug-gnu-emacs@m.gmane.org; Mon, 03 Jun 2019 12:42:08 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:34973) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hXpxH-0001Kh-VO for bug-gnu-emacs@gnu.org; Mon, 03 Jun 2019 12:37:05 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hXpxG-000055-MB for bug-gnu-emacs@gnu.org; Mon, 03 Jun 2019 12:37:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:57560) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hXpxG-0008WQ-Hi for bug-gnu-emacs@gnu.org; Mon, 03 Jun 2019 12:37:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hXpxG-0005L8-Dx for bug-gnu-emacs@gnu.org; Mon, 03 Jun 2019 12:37:02 -0400 Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Mon, 03 Jun 2019 16:37:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 35885 X-GNU-PR-Package: emacs Mail-Followup-To: 35885@debbugs.gnu.org, eliz@gnu.org, mrsebastianurban@gmail.com Original-Received: via spool by 35885-done@debbugs.gnu.org id=D35885.155957981220502 (code D ref 35885); Mon, 03 Jun 2019 16:37:02 +0000 Original-Received: (at 35885-done) by debbugs.gnu.org; 3 Jun 2019 16:36:52 +0000 Original-Received: from localhost ([127.0.0.1]:42870 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hXpx6-0005Kc-1K for submit@debbugs.gnu.org; Mon, 03 Jun 2019 12:36:52 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:48660) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hXpx1-0005KM-0H for 35885-done@debbugs.gnu.org; Mon, 03 Jun 2019 12:36:47 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:48014) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hXpwu-0007oL-O1; Mon, 03 Jun 2019 12:36:41 -0400 Original-Received: from [176.228.60.248] (port=1431 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hXpwg-0001uu-Dt; Mon, 03 Jun 2019 12:36:31 -0400 In-reply-to: (message from Sebastian Urban on Mon, 3 Jun 2019 00:50:55 +0200) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:160061 Archived-At: > From: Sebastian Urban > Date: Mon, 3 Jun 2019 00:50:55 +0200 > > 6. In INFO 15.1.1 Basics of Incremental Search: > - ‘ ’ (‘isearch-cancel’) or ‘C-g C-g’ (‘isearch-abort’). > + ‘ ’ (‘isearch-cancel’) or ‘C-g’ (‘isearch-abort’). > Because `view-lossage' and `describe-bindings' and the last paragraph > of 15.1.4 say: `C-g'. I left this unaltered, because in some cases you do need to type C-g twice, so doing it twice always is safer. > 7. In INFO 17.4 Executing Macros with Variations: > - ‘C-u C-x q’, which is ‘C-x q’ with a numeric argument, performs a > + ‘C-u C-x q’, which is ‘C-x q’ with a prefix argument, performs a > Help window of `kbd-macro-query' has prefix arg. > > 8. In INFO 17.5 Naming and Saving Keyboard Macros: > - If you give ‘insert-kbd-macro’ a numeric argument, it makes > + If you give ‘insert-kbd-macro’ a prefix argument, it makes > Help window of `insert-kbd-macro' has prefix arg. Fixed. > 9. In INFO 15.10.2 Regexp Replacement: > - Repeating our example to exchange ‘x’ and ‘y’, we can thus do it also > -this way: > + For example to exchange `x' and `y', we can do it this way: > Although I'm not sure of this, the sentence sounds like there is > another example of exchanging `x' and `y' (especially the word > ``also''), but I cannot find it, therefore or I missed it, or there was > something, but it was deleted and someone forgot to update the text. There was a previous example, but it was deleted in Emacs 24. I fixed the wording. > 10. In both INFO and PDF: > 10.1. INFO 15.9 Lax Matching During Searching: > - such as U+249C PARENTHESIZED LATIN SMALL LETTER A and U+2100 ACCOUNT OF > + such as `U+249C' PARENTHESIZED LATIN SMALL LETTER A and `U+2100' > ACCOUNT OF > AND > - matches U+FB00 LATIN SMALL LIGATURE FF. Character sequences that are > + matches `U+FB00' LATIN SMALL LIGATURE FF. Character sequences that are > In both cases in PDF (12.9) string from `U' to the end of character > name (except `+' and digits) is written as "small caps shape" while > it should be: code as "typewriter family" (or verbatim?) and name as > normal upcase letters - just like in chapter "Inserting Text". I don't see anything wrong with the current typeface, so I left it alone. > 10.2. INFO 25.5 Quotation Marks: > - (1) The curved single quote characters are U+2018 LEFT SINGLE > - QUOTATION MARK and U+2018 RIGHT SINGLE QUOTATION MARK; the curved > double > - quotes are U+201C LEFT DOUBLE QUOTATION MARK and U+201D RIGHT DOUBLE > - QUOTATION MARK. On text terminals which cannot display these characters > + (1) The curved single quote characters are `U+2018' LEFT SINGLE > + QUOTATION MARK and `U+2018' RIGHT SINGLE QUOTATION MARK; the curved > double > + quotes are `U+201C' LEFT DOUBLE QUOTATION MARK and `U+201D' RIGHT > DOUBLE > + QUOTATION MARK. On text terminals which cannot display these characters > Similar to the problem above, only this time in PDF (22.5), Unicode > should be written as typewriter/verbatim, the name is OK - all > uppercase. Like earlier, I didn't change anything about the quotes, because I think that was fixed already. Please try the latest Texinfo sources. > In PDF 22.5 Quotation Marks: > In 1st paragraph, 2nd line: 1st "like this" is surrounded with single > curved quotes, while they should be single straight quotes. > In 1st paragraph, 3rd&4th line: both "like this" are surrounded with > good quotes, but they have bad shape (normal text), while should be > typewriter/verbatim. > In 2nd paragraph, 2nd line: there should be straight quotes > followed by their curved types, but unfortunately straight quotes are > curved as well. Also curved have bad shape (normal text), should be > typewriter/verbatim. > In 2nd paragraph, "value" at the end: curved quotes have bad shape > (normal text), should be typewriter/verbatim. > In 4th paragraph, 5th line: curved quotes have bad shape (normal > text), should be typewriter/verbatim. Likewise. > In point 1 (previous message) in the same paragraph, line below, "(...) > C-x 8 [ and inserts (...)" and curved opening quote follows, which > is good, but it has shape of normal latex text, while it should has > typewriter/verbatim shape (bolder one). Likewise. > In INFO 15.6 and PDF 12.6 Syntax of Regular Expressions: > Perhaps slanting word "special" or "special constructs" (I would opt > for first one) in... > Regular expressions have a syntax in which a few characters are > special constructs and the rest are “ordinary”. An ordinary character > ... for (again) stronger visual connection with word "ordinary". Done. Thanks again for reviewing the manual. I'm marking this bug report done.