From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Keith Thompson Newsgroups: gmane.emacs.bugs Subject: bug#36883: Make Gnus documentation clearer ("dumbquotes") Date: Wed, 31 Jul 2019 15:02:51 -0700 Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="14510"; mail-complaints-to="usenet@blaine.gmane.org" Cc: Keith Thompson To: 36883@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Aug 01 00:04:08 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.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hswhc-0003dD-77 for geb-bug-gnu-emacs@m.gmane.org; Thu, 01 Aug 2019 00:04:08 +0200 Original-Received: from localhost ([::1]:44804 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hswhb-0004nv-6Y for geb-bug-gnu-emacs@m.gmane.org; Wed, 31 Jul 2019 18:04:07 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:58107) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hswhX-0004np-9f for bug-gnu-emacs@gnu.org; Wed, 31 Jul 2019 18:04:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hswhW-00042d-Ba for bug-gnu-emacs@gnu.org; Wed, 31 Jul 2019 18:04:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:44391) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hswhW-00042V-7r for bug-gnu-emacs@gnu.org; Wed, 31 Jul 2019 18:04:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hswhW-0005ns-1V for bug-gnu-emacs@gnu.org; Wed, 31 Jul 2019 18:04:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Keith Thompson Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 31 Jul 2019 22:04:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 36883 X-GNU-PR-Package: emacs X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.156461059122243 (code B ref -1); Wed, 31 Jul 2019 22:04:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 31 Jul 2019 22:03:11 +0000 Original-Received: from localhost ([127.0.0.1]:53212 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hswgh-0005mg-31 for submit@debbugs.gnu.org; Wed, 31 Jul 2019 18:03:11 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:36435) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hswgd-0005mX-4W for submit@debbugs.gnu.org; Wed, 31 Jul 2019 18:03:07 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:57771) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hswgc-00041X-7H for bug-gnu-emacs@gnu.org; Wed, 31 Jul 2019 18:03:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hswgb-0003g3-7z for bug-gnu-emacs@gnu.org; Wed, 31 Jul 2019 18:03:06 -0400 Original-Received: from mail-ed1-x533.google.com ([2a00:1450:4864:20::533]:42539) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hswga-0003fF-WB for bug-gnu-emacs@gnu.org; Wed, 31 Jul 2019 18:03:05 -0400 Original-Received: by mail-ed1-x533.google.com with SMTP id v15so67207945eds.9 for ; Wed, 31 Jul 2019 15:03:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:from:date:message-id:subject:to:cc :content-transfer-encoding; bh=79JZqGMPLZonaakt0kf0bDQTlqkpbGMypxeqO9H+Rhs=; b=q/BVW69df1ZldM77ROATrczzP6Uje0WgWqH7FGshR/tz7C+lLI1ThyOJkCWD8bZs2l SxSS9mTQqLAV3/gLsutaIFCN1owt2CWEgJkCJ1ePpdbHkDZVy3MXuxLSaQ/N7D2u96zj dyQKC6pvlKj6zls4TxNQbKLMm/EBcOli3KihiabKKKlP5x4k0+WLH2tfa7svkKFO3ES1 bSE2YM+pNq3BTLNvWtZ+GVWKOiCZ2rzo/ziq2yzoCaWqVM6LQVMT8Fs7XICllGZ4BlHM v0FkripUrPu13cOmAAOVA3G2driH+39oCGpbUPUofwESovWvFUIVIiLvl+AxKngFn4zG 8zcg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to:cc :content-transfer-encoding; bh=79JZqGMPLZonaakt0kf0bDQTlqkpbGMypxeqO9H+Rhs=; b=SxyKTNEmdwYr2SU6VNLHoEZ/7B+g2zYOLL2TEh0u0cIyPGk9OI/tjM6bV8v1DKYbz+ UqlGYIW1xRq8vECJEDV1DEkl2GOQ7DdhXjj2b9W+vr3o+Ew1PTiBluZb/leJ7N5yKLYC ntV709x1apGEH6Cb7jbtQ7pTyIrq2PXpOx2lLII7ILQZAtX4Yj3MLudnWWPV0wW2+rGs ItfB92HF50GqLqI2/WKIFrEhXwEsKWiT0gpRMaBqaIyPnsnU2Hsn3/Duf5bpaHL75dt3 mgyemypx4t5DGA0aD55aj5EKL9UhxIqzgDdMeuXPUo+qNVWPgGnIDpndXbE4UKIFjhea F0gg== X-Gm-Message-State: APjAAAV3vK1gGSLOtoe1lNKPKIbdwEgNtMLIIWMte7CtGVxcCqPimT45 lKV1TjsLA5erxMCeLD2poWWXtjIRzJ7dsBR9dSMfYXk1qFQ= X-Google-Smtp-Source: APXvYqx1+FJdUBvY2/y1AoLa6I6nGKVFPPrwuJwNTA1p7haF8EzQEkIdwvasBrFSD+0A7puOfMwyViFO0wA0kbxpegc= X-Received: by 2002:a17:906:f91:: with SMTP id q17mr13048489ejj.297.1564610582908; Wed, 31 Jul 2019 15:03:02 -0700 (PDT) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. 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:164194 Archived-At: Emacs 26.2.90, Gnus v5.1 The Gnus info documentation includes the following: =E2=80=98W d=E2=80=99 Treat M****s*** sm*rtq**t*s according to =E2=80=98gnus-article-dumbquotes-map=E2=80=99 (=E2=80=98gnus-article-t= reat-dumbquotes=E2=80=99). Note that this function guesses whether a character is a sm*rtq**t* or not, so it should only be used interactively. Sm*rtq**t*s are M****s***=E2=80=99s unilateral extension to the charac= ter map in an attempt to provide more quoting characters. If you see something like =E2=80=98\222=E2=80=99 or =E2=80=98\264=E2=80=99 where = you=E2=80=99re expecting some kind of apostrophe or quotation mark, then try this wash. I suggest changing "M****s***" to "Micrsoft" and "sm*rtq**t*s" to "smartquo= tes" throughout. I'd also suggest changing the command names "article-treat-dumbquotes" and "gnus-article-treat-dumbquotes" to refer to "smartquotes" rather than "dumbquotes", probably keeping the existing names as aliases. IMHO documentation should make it easy to search without being an obstacle to understanding. I don't object to snark, but it shoudn't come at the expense of clarity.