From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail
From: Sebastian Urban <mrsebastianurban@gmail.com>
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: <cf31e2b2-3ad4-57f0-8847-e5f01ff35fc8@gmail.com>
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: <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>
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 <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>)
	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 <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>)
	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 <Debian-debbugs@debbugs.gnu.org>) 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 <Debian-debbugs@debbugs.gnu.org>) 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 <Debian-debbugs@debbugs.gnu.org>)
	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 <Debian-debbugs@debbugs.gnu.org>) 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 <mrsebastianurban@gmail.com>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces@debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@gnu.org
Resent-Date: Fri, 24 May 2019 16:00:02 +0000
Resent-Message-ID: <handler.35885.B.15587135631481@debbugs.gnu.org>
Resent-Sender: help-debbugs@gnu.org
X-GNU-PR-Message: report 35885
X-GNU-PR-Package: emacs
X-Debbugs-Original-To: Bug GNU Emacs <bug-gnu-emacs@gnu.org>
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 <debbugs-submit-bounces@debbugs.gnu.org>)
	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 <mrsebastianurban@gmail.com>) 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 <mrsebastianurban@gmail.com>)
	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 <mrsebastianurban@gmail.com>) 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 <mrsebastianurban@gmail.com>) 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 <mrsebastianurban@gmail.com>)
	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 <bug-gnu-emacs@gnu.org>; 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 <bug-gnu-emacs@gnu.org>
	(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" <bug-gnu-emacs.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/bug-gnu-emacs>,
	<mailto:bug-gnu-emacs-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/bug-gnu-emacs/>
List-Post: <mailto:bug-gnu-emacs@gnu.org>
List-Help: <mailto:bug-gnu-emacs-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/bug-gnu-emacs>,
	<mailto:bug-gnu-emacs-request@gnu.org?subject=subscribe>
Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org
Original-Sender: "bug-gnu-emacs"
	<bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>
Xref: news.gmane.org gmane.emacs.bugs:159717
Archived-At: <http://permalink.gmane.org/gmane.emacs.bugs/159717>

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.