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:32:27 +0300 Message-ID: <83lfyitysk.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="43465"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 35885@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:34:27 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 1hXpuj-000BAv-BX for geb-bug-gnu-emacs@m.gmane.org; Mon, 03 Jun 2019 18:34:25 +0200 Original-Received: from localhost ([127.0.0.1]:37724 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hXpuh-0007Qf-U4 for geb-bug-gnu-emacs@m.gmane.org; Mon, 03 Jun 2019 12:34:23 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:33918) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hXpuZ-0007Mh-AU for bug-gnu-emacs@gnu.org; Mon, 03 Jun 2019 12:34:16 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hXptO-0008NR-Ks for bug-gnu-emacs@gnu.org; Mon, 03 Jun 2019 12:33:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:57547) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hXptO-0008N3-GS for bug-gnu-emacs@gnu.org; Mon, 03 Jun 2019 12:33:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hXptO-0005Ee-CC for bug-gnu-emacs@gnu.org; Mon, 03 Jun 2019 12:33:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 03 Jun 2019 16:33:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 35885 X-GNU-PR-Package: emacs Original-Received: via spool by 35885-submit@debbugs.gnu.org id=B35885.155957956820103 (code B ref 35885); Mon, 03 Jun 2019 16:33:02 +0000 Original-Received: (at 35885) by debbugs.gnu.org; 3 Jun 2019 16:32:48 +0000 Original-Received: from localhost ([127.0.0.1]:42858 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hXptA-0005EB-4C for submit@debbugs.gnu.org; Mon, 03 Jun 2019 12:32:48 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:47545) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hXpt5-0005Dv-4Z for 35885@debbugs.gnu.org; Mon, 03 Jun 2019 12:32:46 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:47939) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hXpsz-0007R2-WC; Mon, 03 Jun 2019 12:32:38 -0400 Original-Received: from [176.228.60.248] (port=1191 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hXpsz-0007mU-AJ; Mon, 03 Jun 2019 12:32:37 -0400 In-reply-to: (message from Sebastian Urban on Fri, 24 May 2019 17:59:09 +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:160058 Archived-At: > From: Sebastian Urban > Date: Fri, 24 May 2019 17:59:09 +0200 > > 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. Thanks. I fixed most of the issues, see below. > 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. Fixed these. > 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". I used a different wording, like "move point's line to ...". > 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? The current text is correct, but it's confusing. I reworded it. > 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. I believe you saw these in the Emacs 25 manual. We did a lot of fixes regarding these special characters in preparation for Emacs 26 release, so please be sure to look in the latest version (it is best to checkout the current emacs-26 branch and produce PDF from its sources). I didn't change any of the issues with quotes, as I don't have a PDF version of the manual handy, and couldn't myself check whether there are leftovers. > 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". I did that. > 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. These are beyond our control (well, unless we want to write a lot of TeX glue in the manual): this is how Texinfo works. Thanks.