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, 15 Aug 2020 16:34:32 +0300
Message-ID: <83mu2wjamv.fsf@gnu.org>
References: <c27a8c46-68d3-f9f4-2e92-05e0b6496b53@gmail.com>
 <87v9hkvygw.fsf@gnus.org>
Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214";
	logging-data="30750"; mail-complaints-to="usenet@ciao.gmane.io"
Cc: mrsebastianurban@gmail.com, 35885@debbugs.gnu.org
To: Lars Ingebrigtsen <larsi@gnus.org>
Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Aug 15 15:35: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 1k6wL1-0007pq-Lr
	for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 15 Aug 2020 15:35:11 +0200
Original-Received: from localhost ([::1]:50758 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 1k6wKz-0000J7-W2
	for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 15 Aug 2020 09:35:10 -0400
Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:33310)
 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 1k6wKs-0000If-N8
 for bug-gnu-emacs@gnu.org; Sat, 15 Aug 2020 09:35:02 -0400
Original-Received: from debbugs.gnu.org ([209.51.188.43]:42905)
 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 1k6wKs-0002jr-DT
 for bug-gnu-emacs@gnu.org; Sat, 15 Aug 2020 09:35: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 1k6wKs-0005tt-An
 for bug-gnu-emacs@gnu.org; Sat, 15 Aug 2020 09:35: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, 15 Aug 2020 13:35:02 +0000
Resent-Message-ID: <handler.35885.B35885.159749849422661@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.159749849422661
 (code B ref 35885); Sat, 15 Aug 2020 13:35:02 +0000
Original-Received: (at 35885) by debbugs.gnu.org; 15 Aug 2020 13:34:54 +0000
Original-Received: from localhost ([127.0.0.1]:54451 helo=debbugs.gnu.org)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <debbugs-submit-bounces@debbugs.gnu.org>)
 id 1k6wKj-0005tR-Jz
 for submit@debbugs.gnu.org; Sat, 15 Aug 2020 09:34:53 -0400
Original-Received: from eggs.gnu.org ([209.51.188.92]:51416)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <eliz@gnu.org>) id 1k6wKg-0005t8-6J
 for 35885@debbugs.gnu.org; Sat, 15 Aug 2020 09:34:51 -0400
Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:48318)
 by eggs.gnu.org with esmtp (Exim 4.90_1)
 (envelope-from <eliz@gnu.org>)
 id 1k6wKa-0002ie-GT; Sat, 15 Aug 2020 09:34:44 -0400
Original-Received: from [176.228.60.248] (port=1232 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 1k6wKZ-0006rM-22; Sat, 15 Aug 2020 09:34:44 -0400
In-Reply-To: <87v9hkvygw.fsf@gnus.org> (message from Lars Ingebrigtsen on Sat, 
 15 Aug 2020 15:18:55 +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:185226
Archived-At: <http://permalink.gmane.org/gmane.emacs.bugs/185226>

> From: Lars Ingebrigtsen <larsi@gnus.org>
> Date: Sat, 15 Aug 2020 15:18:55 +0200
> Cc: 35885@debbugs.gnu.org
> 
> >  starting with @kbd{C-x 8}.  For example, @kbd{C-x 8 [} inserts @t{^X}
> >  which is Unicode code-point U+2018 @sc{left single quotation mark},
> >  sometimes called a left single ``curved quote'' or ``curly quote''.
> > -Similarly, @kbd{C-x 8 ]}, @kbd{C-x 8 @{} and @kbd{C-x 8 @}} insert the
> > +Similarly, @w{@kbd{C-x 8 ]}}, @kbd{C-x 8 @{} and @kbd{C-x 8 @}}
> > insert the
> 
> It looks like this patch has been severely mangled?  There's characters
> like ^X in it (where there should be a `, I think)?
> 
> Could you re-send the patch?

Beware of the changes that are supposed to "fix" how quote characters
are typeset: there be dragons there.  We've done quite a lot of fixing
that during Emacs 26 release, and found out that there are different,
sometimes contradictory, requirements to have those display nicely in
HTML and in PDF.  But Sebastian keeps pushing for his changes although
I told him long ago they are not necessarily TRT.

If you want to install those changes now, be sure to produce Info,
HTML, and PDF versions of the manual, and examine the results of each
change in all three formats, before you decide whether installing them
is a good idea.