unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
From: Sebastian Urban <mrsebastianurban@gmail.com>
To: 35885@debbugs.gnu.org
Subject: bug#35885: 25.2; Few mistakes in Emacs Manual (+ proposals)
Date: Fri, 24 May 2019 17:59:09 +0200	[thread overview]
Message-ID: <cf31e2b2-3ad4-57f0-8847-e5f01ff35fc8@gmail.com> (raw)

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.





             reply	other threads:[~2019-05-24 15:59 UTC|newest]

Thread overview: 48+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2019-05-24 15:59 Sebastian Urban [this message]
2019-06-02 22:50 ` bug#35885: 25.2; Few mistakes in Emacs Manual (+ proposals) Sebastian Urban
2019-06-03 16:36   ` Eli Zaretskii
2019-06-04 10:48     ` Sebastian Urban
2019-06-04 15:12       ` Eli Zaretskii
2019-06-05 10:40         ` Sebastian Urban
2019-06-05 16:52           ` Eli Zaretskii
2019-06-06  9:49             ` Sebastian Urban
2019-06-06 21:19               ` Sebastian Urban
2019-06-09  8:31                 ` Eli Zaretskii
2019-06-09  8:22               ` Eli Zaretskii
2019-06-10 10:30                 ` Sebastian Urban
2019-06-10 17:01                   ` Eli Zaretskii
2019-06-11 10:32                     ` Sebastian Urban
2019-06-11 16:59                       ` Eli Zaretskii
2019-06-12  8:44                         ` Sebastian Urban
2019-06-12 13:25                           ` Drew Adams
2019-06-03 16:32 ` Eli Zaretskii
2020-05-10 20:02 ` Sebastian Urban
2020-08-13  9:11   ` Sebastian Urban
2020-08-13 13:20     ` Eli Zaretskii
2020-08-13 14:06       ` Sebastian Urban
2020-08-13 14:16         ` Eli Zaretskii
2020-08-14  0:01           ` Sebastian Urban
2020-08-15 13:18   ` Lars Ingebrigtsen
2020-08-15 13:34     ` Eli Zaretskii
2020-08-15 13:52       ` Lars Ingebrigtsen
2020-08-15 14:11     ` Sebastian Urban
2020-08-16 11:16       ` Lars Ingebrigtsen
2020-08-16 13:00         ` Sebastian Urban
2020-08-18 14:54           ` Lars Ingebrigtsen
2020-08-18 15:07             ` Eli Zaretskii
2020-08-19 10:15               ` Lars Ingebrigtsen
2020-08-19  8:44             ` Sebastian Urban
2020-08-19 10:19               ` Lars Ingebrigtsen
2020-08-19 12:14                 ` Sebastian Urban
2020-08-20 12:44                   ` Lars Ingebrigtsen
2020-08-20 13:35                     ` Eli Zaretskii
2020-08-20 18:24                     ` Sebastian Urban
2020-08-22  7:20                       ` Eli Zaretskii
2020-08-22 10:19                         ` Sebastian Urban
2020-10-19 18:52                           ` Sebastian Urban
2021-05-12 14:47                           ` Lars Ingebrigtsen
2021-05-13 11:48                             ` Sebastian Urban
2021-05-16 13:30                               ` Lars Ingebrigtsen
2021-05-18  9:17                                 ` Sebastian Urban
2021-05-18 13:15                                   ` bug#42199: " Lars Ingebrigtsen
     [not found] <<cf31e2b2-3ad4-57f0-8847-e5f01ff35fc8@gmail.com>
     [not found] ` <<f2fff09b-fc97-795b-dc3b-4175c48234db@gmail.com>
     [not found]   ` <<83k1e2tym6.fsf@gnu.org>
     [not found]     ` <<e083f8bd-8c77-3558-c373-a8d9d9ef6079@gmail.com>
     [not found]       ` <<835zpltme6.fsf@gnu.org>
     [not found]         ` <<d1695e2e-7f87-7493-fbd9-97cd6347d837@gmail.com>
     [not found]           ` <<83muiwrn2u.fsf@gnu.org>
     [not found]             ` <<1583c6b3-2421-794d-8c8b-86287ef3fd5a@gmail.com>
     [not found]               ` <<83tvczb236.fsf@gnu.org>
     [not found]                 ` <<616312d4-0faf-0382-3f21-5b66327d8d8b@gmail.com>
     [not found]                   ` <<83tvcx9xyl.fsf@gnu.org>
2019-06-10 17:44                     ` Drew Adams

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.gnu.org/software/emacs/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=cf31e2b2-3ad4-57f0-8847-e5f01ff35fc8@gmail.com \
    --to=mrsebastianurban@gmail.com \
    --cc=35885@debbugs.gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
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).