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: Fri, 24 May 2019 17:59:09 +0200 Message-ID: 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="94663"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Mozilla/5.0 (Windows NT 6.1; rv:60.0) Gecko/20100101 Thunderbird/60.6.1 To: 35885@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri May 24 18:03:10 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 1hUCez-000OTM-Kb for geb-bug-gnu-emacs@m.gmane.org; Fri, 24 May 2019 18:03:09 +0200 Original-Received: from localhost ([127.0.0.1]:56814 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hUCey-00053N-BR for geb-bug-gnu-emacs@m.gmane.org; Fri, 24 May 2019 12:03:08 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:36761) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hUCc0-0002cE-Qy for bug-gnu-emacs@gnu.org; Fri, 24 May 2019 12:00:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hUCbz-0000TP-Ds for bug-gnu-emacs@gnu.org; Fri, 24 May 2019 12:00:04 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:33577) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hUCbz-0000TD-AW for bug-gnu-emacs@gnu.org; Fri, 24 May 2019 12:00:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hUCbz-0000Pc-6c for bug-gnu-emacs@gnu.org; Fri, 24 May 2019 12:00:03 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Sebastian Urban Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 24 May 2019 16:00:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 35885 X-GNU-PR-Package: emacs X-Debbugs-Original-To: Bug GNU Emacs Original-Received: via spool by submit@debbugs.gnu.org id=B.15587135631481 (code B ref -1); Fri, 24 May 2019 16:00:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 24 May 2019 15:59:23 +0000 Original-Received: from localhost ([127.0.0.1]:47117 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hUCbK-0000Nn-VR for submit@debbugs.gnu.org; Fri, 24 May 2019 11:59:23 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:50500) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hUCbF-0000NI-ES for submit@debbugs.gnu.org; Fri, 24 May 2019 11:59:17 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:37148) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hUCbA-0007Tm-8I for submit@debbugs.gnu.org; Fri, 24 May 2019 11:59:12 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:36646) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hUCb8-0002Xh-VW for bug-gnu-emacs@gnu.org; Fri, 24 May 2019 11:59:12 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hUCb7-0007Q0-OD for bug-gnu-emacs@gnu.org; Fri, 24 May 2019 11:59:10 -0400 Original-Received: from mail-lj1-x230.google.com ([2a00:1450:4864:20::230]:35956) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hUCb7-0007OU-GP for bug-gnu-emacs@gnu.org; Fri, 24 May 2019 11:59:09 -0400 Original-Received: by mail-lj1-x230.google.com with SMTP id z1so3634822ljb.3 for ; Fri, 24 May 2019 08:59:09 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=to:from:subject:message-id:date:user-agent:mime-version :content-language:content-transfer-encoding; bh=g5JCR2f/qNfRP0QDzjytcOHJXKC/o/H0+zJFEXNCQEs=; b=bwIXLzazfhsJHkNXopjO+tLxrIY4o66dKjxDIMzCSWZijzGq6NNu2pQmnkgczt6tNQ 4NanD7Kw4ZU4cVvZL4lOJji6Jd3+RCf69bqjpdOVkXiVjv87JqKsV8OKHxsWYslu71xy fugo+G/eUeCQFLBmZ3JhfpMpQh+NUG7m2xXmJyqnKs8CfD8TBKylokTqamMUTPTAYzXC dnrYV1rN/Se68fE8hc9kXiIwJwDJ5FqV2nennSgz9rV7KKe+aLno5S+cmiuhdzIkITWS 9MeoWlhvsPF+prq5nohneY3a/Dxz+GAu8rIHHK2nPaipG6H/ra5O34WDDS2GDyWABsaT i5UA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:to:from:subject:message-id:date:user-agent :mime-version:content-language:content-transfer-encoding; bh=g5JCR2f/qNfRP0QDzjytcOHJXKC/o/H0+zJFEXNCQEs=; b=bDlXRlxksiHkS48PiZCfDukzuYsUZz4wIG3gJ2/AP7oGeu0Bty1eOnO9SMk2ipZhh7 Wu+55BjIo36GUZfTYtHOnStrwO10oKDxWtNzNCqydL+zVOnFtQeqGwCtKkAcd1aC+Imu 9oN8yYjLEHmoURaaOSbXJ0swYduegu6rgR4toHsmdlgOV1bQNotk+XumTcVkqTTSdqJe +L8MX31v4BWLKq9T55vF3p6DKfeZnvm6GtBZ1s3llleMkK6MLvh4zPqiWWhW3+p4ze2e t+yxMgSdjrE6RutmrkN+uqND/xemt8uuSPvSG6wasSnulGWvLbqlUzmt38Gk89sYkbrG c7jA== X-Gm-Message-State: APjAAAWrdfmlYgCeo7Jx1bV3NgYjgjR/TzmO0jGK8keB6jj4hLv2Wz+n rLKbsHX6m0/XMNFSvygPUxhSOho8 X-Google-Smtp-Source: APXvYqwy8skxjQIWoKgJajR7qF9kP/3/Nb27P1Uc1NHSCOiNLX7B95aHYWstunTMZgKS80ZtdNq1NQ== X-Received: by 2002:a2e:9581:: with SMTP id w1mr38510649ljh.88.1558713547318; Fri, 24 May 2019 08:59:07 -0700 (PDT) Original-Received: from [89.161.9.216] (ip-89-161-9-216.tel.tkb.net.pl. [89.161.9.216]) by smtp.gmail.com with ESMTPSA id y27sm680730lfg.33.2019.05.24.08.59.06 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 24 May 2019 08:59:06 -0700 (PDT) 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:159717 Archived-At: Hello, I gathered few mistakes in the manual and 3 proposals for it, in one report, because they are small (maybe except 2nd and 3rd proposal) and sending them one by one would be spam-ish. I found them in GNU Emacs 25.2.1 (i686-w64-mingw32) of 2017-04-24 and PDFs updated for 25.2 and 26.2. * INFO ==================== 1. In INFO 11.7 Disabling Transient Mark Mode: - ‘M-x transient-mark-mode’, or with the ‘Active Region Highlighting’ menu + ‘M-x transient-mark-mode’, or with the ‘Highlight Active Region’ menu This is correct name of menu item. 2. In INFO 13.2 Saving Text in Registers: - activating it. With a numeric argument, it instead puts point before + activating it. With a prefix argument, it instead puts point before Help window of 'insert-register' has prefix arg. 3. In INFO 13.3 Saving Rectangles in Registers: - (‘copy-rectangle-to-register’). With numeric argument, delete it + (‘copy-rectangle-to-register’). With prefix argument, delete it Help window of 'copy-rectangle-to-register' has prefix arg. 4. In INFO 14.2 Recentering: in paragraph starting with "You can also give ‘C-l’ a prefix argument.", expressions: - "recenters point" should be "recenters line" - "puts point" (3 occurrences) should rather be "moves current line", because point is moved this way by 'M-r' ('move-to-window-line-top-bottom') and also in help window for 'recenter-top-bottom' we have "move current line". 5. In INFO 14.19 How Text Is Displayed: - have an integer value between 1 and 1000, inclusive. Note that how the + have an integer value between 1 and 1000, inclusive. Note how the I think "that" is unnecessary, "Note that how the tab character (...)", will change into "Note how the tab character (...)". Although I'm not sure of it, maybe current form is correct? * PDF ==================== 1. In PDF 4.1 Inserting Text: in paragraph starting with "A few common Unicode characters can be inserted (...)" (near word "respectively"), "left double quotation mark" (curved) is displayed as "backslash" and "right double quotation mark" (curved) is displayed as "straight double quotes". In INFO it looks ok. 2. In PDF 4.1 Inserting Text: in paragraph starting with "In some contexts, if you type a quotation (...)", display of quotes is messed up, quotes surrounding Nth occurrence of "like this" should be: - 1st - "grave accent" and "apostrophe", - 2nd - is ok, - 3rd - 2x "grave accent" and 2x "apostrophe", - 4th - "left double quotation mark" (curved) and "right double quotation mark" (curved) Or just look into INFO, it's ok there. 3. In PDF 11.19 How Text Is Displayed: in last paragraph, first line, "left double quotation mark" (curved) is displayed as "backslash" and "right double quotation mark" (curved) is displayed as "straight double quotes". In INFO it looks ok. * Small proposals ==================== 1. Emphasize a word In both INFO(7.10 Numeric arguments) and PDF(4.10 Numeric Arguments), in last paragraph, there is a word "before", I suggest to emphasize this word (or maybe make it slanted, up to you). It will have stronger (visual) connection to slanted "prefix argument". 2. Header style should be changed. It shows page number in right upper corner on every page, but it should show it in right upper corner for odd (right-side) pages and in left upper corner for even (left-side) pages - just like in normal book. 3. Add numbers to sections (& subsect.) for bookmark/navigation pane. When you open it in any PDF reader with manual loaded, it only shows names of sections, and without numbers it's difficult to navigate. --- S. U.