From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Sebastian Urban Newsgroups: gmane.emacs.bugs Subject: bug#35885: 25.2; Few mistakes in Emacs Manual (+ proposals) Date: Mon, 3 Jun 2019 00:50:55 +0200 Message-ID: References: Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 8bit Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="243077"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Mozilla/5.0 (Windows NT 6.1; rv:60.0) Gecko/20100101 Thunderbird/60.7.0 To: 35885@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jun 03 00:52: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 1hXZKp-00112y-9F for geb-bug-gnu-emacs@m.gmane.org; Mon, 03 Jun 2019 00:52:15 +0200 Original-Received: from localhost ([127.0.0.1]:54076 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hXZKm-0004mB-V3 for geb-bug-gnu-emacs@m.gmane.org; Sun, 02 Jun 2019 18:52:12 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:41162) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hXZKd-0004lv-Ut for bug-gnu-emacs@gnu.org; Sun, 02 Jun 2019 18:52:05 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hXZKc-0001nE-Id for bug-gnu-emacs@gnu.org; Sun, 02 Jun 2019 18:52:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:55750) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hXZKc-0001mx-FE for bug-gnu-emacs@gnu.org; Sun, 02 Jun 2019 18:52:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hXZKc-0003Or-B7 for bug-gnu-emacs@gnu.org; Sun, 02 Jun 2019 18:52:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Sebastian Urban Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 02 Jun 2019 22:52:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 35885 X-GNU-PR-Package: emacs X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.155951588113014 (code B ref -1); Sun, 02 Jun 2019 22:52:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 2 Jun 2019 22:51:21 +0000 Original-Received: from localhost ([127.0.0.1]:41061 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hXZJw-0003Np-QO for submit@debbugs.gnu.org; Sun, 02 Jun 2019 18:51:21 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:54895) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hXZJv-0003Na-Bs for submit@debbugs.gnu.org; Sun, 02 Jun 2019 18:51:19 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:47412) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hXZJo-0000tJ-J3 for submit@debbugs.gnu.org; Sun, 02 Jun 2019 18:51:14 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:41034) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hXZJj-0004S9-Ad for bug-gnu-emacs@gnu.org; Sun, 02 Jun 2019 18:51:12 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hXZJi-0000nj-0w for bug-gnu-emacs@gnu.org; Sun, 02 Jun 2019 18:51:07 -0400 Original-Received: from mail-lj1-x22e.google.com ([2a00:1450:4864:20::22e]:42694) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hXZJh-0000m9-PU for bug-gnu-emacs@gnu.org; Sun, 02 Jun 2019 18:51:05 -0400 Original-Received: by mail-lj1-x22e.google.com with SMTP id t28so3268993lje.9 for ; Sun, 02 Jun 2019 15:51:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:subject:to:references:message-id:date:user-agent:mime-version :in-reply-to:content-language:content-transfer-encoding; bh=UMWkUHrIknSb2U1QK/FvB7sATILqfuq58HITDesGiSk=; b=ngiORhi5R/zWosPsuDtF+JJTwiV4j8Z252tj/65PNPJ/74Lt5TgHHVL82g8ku72S8H /9Mu2dtsP/aItc8JEPwar4ZrhD6QaE6czHo4+kLJ7faqoGAw811GuWVa1TwDXm/NEnVs 83CnthAvufOVIwE4nPMxpdzuPbzmmQP8esOnPwzN00a5jPmL9dRGkTl9ZyBjpgUtLf+A 6PEnuCtEybloMhmdLEwCnYcsALNLp5I9km9aHpfh9gz1MzqF+aVQluaT14ihjZKiUuw0 mq4uHOr2lfzNdX2GPWSevNkHIRppR8ODlh5HuUn0lMh6Y5opBxr+hLW0gLxTvmkei1Lw 9rvw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:subject:to:references:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=UMWkUHrIknSb2U1QK/FvB7sATILqfuq58HITDesGiSk=; b=AE+vfexa4616qC4oZS8hc+a+vqd6N3qwVF9wMiqnJx7v84HgLJWxItkWcLOR+OnVtr 2vCe7Dr5UtJSKsReDmRfqVDMixeezveLQp2tPkZGIi5aZA3wRm+lHl7xbjHTbisuGyG8 lK4rD4V+VTa2wHU3AnDjnGbo17Hc/v6WyxOBNjswKvz8OY3nlaA6sEXjpK/GdXVO0/Pr LfHm97vni+Y5K1XZTqn8VKx/3t1c42g02f9llnio+oQFDjyWsBe6NmvWUwt2VE7elCKG 4yGcXny8JTLnWf3A9APn3K/BK0/E/KHI9MPW22XHYqRv5w3H+UqqqzoSltuZb8KSSAVF tpzA== X-Gm-Message-State: APjAAAUG5mGdv5mVBr3MYzuTI8ZiPtljOmxaTZkZn6RWbxegc0Fb33O9 De+uqk7SRAZDZSb1gOJrOW1f5Kic X-Google-Smtp-Source: APXvYqwiJKQrijT8QeL2kRyO4P4vvia7iImXnRBalIWhGJIjs2unlm9SYh6LYao5PLPDVy3AuD7k+g== X-Received: by 2002:a2e:9f52:: with SMTP id v18mr12082781ljk.176.1559515862779; Sun, 02 Jun 2019 15:51:02 -0700 (PDT) Original-Received: from ?IPv6:2a00:f41:1ccc:fe0f:9dfb:3440:977f:379f? ([2a00:f41:1ccc:fe0f:9dfb:3440:977f:379f]) by smtp.gmail.com with ESMTPSA id c5sm2787656lfm.7.2019.06.02.15.51.00 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sun, 02 Jun 2019 15:51:01 -0700 (PDT) In-Reply-To: Content-Language: en-GB X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x 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:160031 Archived-At: Few more for INFO... ==================== 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'. 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. 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. 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". 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. OR... perhaps desired way was: typewriter/verbatim for the code and small caps shape for the name? ... and for PDF... ================== 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. ALSO (addition) 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). ... and another proposal ======================== 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".