From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail
From: Eli Zaretskii <eliz@gnu.org>
Newsgroups: gmane.emacs.bugs
Subject: bug#35885: 25.2; Few mistakes in Emacs Manual (+ proposals)
Date: Sat, 22 Aug 2020 10:20:37 +0300
Message-ID: <83sgcf9mey.fsf@gnu.org>
References: <c27a8c46-68d3-f9f4-2e92-05e0b6496b53@gmail.com>
 <87v9hkvygw.fsf@gnus.org> <47224e43-28c1-04d0-4418-b8f069a48b0c@gmail.com>
 <87d03qx2mm.fsf@gnus.org> <9d2594a9-8632-eb3b-18aa-359584c96753@gmail.com>
 <87k0xwj97f.fsf@gnus.org> <dcedcf66-a2ce-f88c-6952-ee34d92081c1@gmail.com>
 <87r1s37xb2.fsf@gnus.org> <5047e985-673d-1c3c-4f97-0353e83285a9@gmail.com>
 <87o8n5xz9t.fsf@gnus.org> <b74cb116-4f49-5c4b-fcf5-ac622c3ee4d8@gmail.com>
Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214";
	logging-data="17922"; mail-complaints-to="usenet@ciao.gmane.io"
Cc: larsi@gnus.org, 35885@debbugs.gnu.org
To: Sebastian Urban <mrsebastianurban@gmail.com>
Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Aug 22 09:21:11 2020
Return-path: <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org>
Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org
Original-Received: from lists.gnu.org ([209.51.188.17])
	by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org>)
	id 1k9Npu-0004YD-Ln
	for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 22 Aug 2020 09:21:10 +0200
Original-Received: from localhost ([::1]:56542 helo=lists1p.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.90_1)
	(envelope-from <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org>)
	id 1k9Npt-0002JD-8M
	for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 22 Aug 2020 03:21:09 -0400
Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:52390)
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <Debian-debbugs@debbugs.gnu.org>)
 id 1k9Npn-0002J2-2H
 for bug-gnu-emacs@gnu.org; Sat, 22 Aug 2020 03:21:03 -0400
Original-Received: from debbugs.gnu.org ([209.51.188.43]:37266)
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)
 (Exim 4.90_1) (envelope-from <Debian-debbugs@debbugs.gnu.org>)
 id 1k9Npm-0002I3-Mm
 for bug-gnu-emacs@gnu.org; Sat, 22 Aug 2020 03:21:02 -0400
Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2)
 (envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1k9Npm-0004pj-Iv
 for bug-gnu-emacs@gnu.org; Sat, 22 Aug 2020 03:21:02 -0400
X-Loop: help-debbugs@gnu.org
Resent-From: Eli Zaretskii <eliz@gnu.org>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces@debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@gnu.org
Resent-Date: Sat, 22 Aug 2020 07:21:02 +0000
Resent-Message-ID: <handler.35885.B35885.159808084718537@debbugs.gnu.org>
Resent-Sender: help-debbugs@gnu.org
X-GNU-PR-Message: followup 35885
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: patch
Original-Received: via spool by 35885-submit@debbugs.gnu.org id=B35885.159808084718537
 (code B ref 35885); Sat, 22 Aug 2020 07:21:02 +0000
Original-Received: (at 35885) by debbugs.gnu.org; 22 Aug 2020 07:20:47 +0000
Original-Received: from localhost ([127.0.0.1]:48812 helo=debbugs.gnu.org)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <debbugs-submit-bounces@debbugs.gnu.org>)
 id 1k9NpX-0004ov-5S
 for submit@debbugs.gnu.org; Sat, 22 Aug 2020 03:20:47 -0400
Original-Received: from eggs.gnu.org ([209.51.188.92]:42268)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <eliz@gnu.org>) id 1k9NpV-0004og-Cl
 for 35885@debbugs.gnu.org; Sat, 22 Aug 2020 03:20:45 -0400
Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:35372)
 by eggs.gnu.org with esmtp (Exim 4.90_1)
 (envelope-from <eliz@gnu.org>)
 id 1k9NpQ-0002Hf-5o; Sat, 22 Aug 2020 03:20:40 -0400
Original-Received: from [176.228.60.248] (port=1264 helo=home-c4e4a596f7)
 by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256)
 (Exim 4.82) (envelope-from <eliz@gnu.org>)
 id 1k9NpP-0002Y1-Kc; Sat, 22 Aug 2020 03:20:39 -0400
In-Reply-To: <b74cb116-4f49-5c4b-fcf5-ac622c3ee4d8@gmail.com> (message from
 Sebastian Urban on Thu, 20 Aug 2020 20:24:32 +0200)
X-BeenThere: debbugs-submit@debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
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: <https://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-mx.org@gnu.org
Original-Sender: "bug-gnu-emacs"
 <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org>
Xref: news.gmane.io gmane.emacs.bugs:185923
Archived-At: <http://permalink.gmane.org/gmane.emacs.bugs/185923>

> From: Sebastian Urban <mrsebastianurban@gmail.com>
> Cc: Eli Zaretskii <eliz@gnu.org>, 35885@debbugs.gnu.org
> Date: Thu, 20 Aug 2020 20:24:32 +0200
> 
> 1.  Changed @samp to @t, as far as I remember it's preferred for quotes.
> 
> 2.  Similarly, in (...), I changed @samp to @kbd.  Although, this time

I understand item 1, but not item 2.  Why would we want to change
@samp to @kbd?  Likewise in other parts, where you suggest to change
@t to @kbd.  @kbd is for something the user types; using it for quotes
in context other than typing input is wrong.

> * EMACS.TEXI
> ============
> 
> This will change header style (PDF), to this:
> +-------------------------+ +------------------------+
> | PAGE_NUM      DOC_TITLE | |CHAPTER        PAGE_NUM |
> 
> --8<---------------cut here---------------start------------->8---
> --- old/emacs.texi	2020-08-19 15:44:47.000000000 +0200
> +++ new/emacs.texi	2020-08-20 20:06:46.751323200 +0200
> @@ -99,6 +99,7 @@
> 
>    @end titlepage
> 
> +@headings double

This is an unrelated change.  Why would we want it?