From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.bugs Subject: bug#50731: `progress-reporter-update' docstring and `backward-sexp' interaction Date: Tue, 21 Sep 2021 23:52:58 -0700 Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="18053"; mail-complaints-to="usenet@ciao.gmane.io" To: 50731@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Sep 22 08:54:18 2021 Return-path: 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 ) id 1mSw94-0004Rx-KC for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 22 Sep 2021 08:54:18 +0200 Original-Received: from localhost ([::1]:60236 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mSw92-0005mm-21 for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 22 Sep 2021 02:54:16 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:59368) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mSw8p-0005kg-CV for bug-gnu-emacs@gnu.org; Wed, 22 Sep 2021 02:54:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:37130) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mSw8n-0007tU-Tw for bug-gnu-emacs@gnu.org; Wed, 22 Sep 2021 02:54:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mSw8n-0000t0-Ot for bug-gnu-emacs@gnu.org; Wed, 22 Sep 2021 02:54:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 22 Sep 2021 06:54:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 50731 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.16322935843273 (code B ref -1); Wed, 22 Sep 2021 06:54:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 22 Sep 2021 06:53:04 +0000 Original-Received: from localhost ([127.0.0.1]:48665 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mSw7r-0000qj-P3 for submit@debbugs.gnu.org; Wed, 22 Sep 2021 02:53:03 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:34632) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mSw7q-0000qc-GZ for submit@debbugs.gnu.org; Wed, 22 Sep 2021 02:53:02 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:59112) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mSw7q-0005C1-8N for bug-gnu-emacs@gnu.org; Wed, 22 Sep 2021 02:53:02 -0400 Original-Received: from mail-pj1-f46.google.com ([209.85.216.46]:43837) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mSw7o-00071J-Mw for bug-gnu-emacs@gnu.org; Wed, 22 Sep 2021 02:53:02 -0400 Original-Received: by mail-pj1-f46.google.com with SMTP id k23-20020a17090a591700b001976d2db364so1539067pji.2 for ; Tue, 21 Sep 2021 23:53:00 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:mime-version:date:message-id:subject:to; bh=tDWnzxDdhwu5tjnyvMRO+YD6RlDSjSGtj4qmNoq2tII=; b=JEXomlIPbuSpV0wLjCwKGFbjx9VvSTG+UzQLdoJsLlfJJofneH0PMcoYx3iGEySu26 +Pci5KuFdfv0nDXF+yid2ldES+l1FvaTxZJkQD3GUihYGubzxoRugPTdvI/UHjY8/rsj gvArQ9vt7FIqpkOunOTJFOszolvmE/MAqM/Xjdo2BFxlIt0m0X32WacVR1kTXjewSQHn knk6JzxyxM73odZzBW4BGsJ3h1x1xqkUwpDp50rD5BLr0+Pb6M5DhcOkasGHTvlK7eag Jd2LzkkMUscpl7YyaTNbq6jhun2j19XKS/ELKJGBlfv/CMcwTesXyqJs5/43cWZ8sR16 GtUg== X-Gm-Message-State: AOAM533xnTXJuSysGAD/M0AvSEYeoIPdOcYBnvW8n83QheFDXFKx3hQd el/FEQ55Q0c7C6du+xIp7zev61mlYEPDZm37TVIncRqh X-Google-Smtp-Source: ABdhPJzgabLE7/EzkV3E0JzufUC1iJeYFncESEUxIkQ/7f04OsgDIYwtCT1uomvJ3TDROnuDT76mi4yzXseVrKYfIlY= X-Received: by 2002:a17:902:d505:b0:13d:b037:2087 with SMTP id b5-20020a170902d50500b0013db0372087mr12681185plg.22.1632293578697; Tue, 21 Sep 2021 23:52:58 -0700 (PDT) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Tue, 21 Sep 2021 23:52:58 -0700 Received-SPF: pass client-ip=209.85.216.46; envelope-from=stefankangas@gmail.com; helo=mail-pj1-f46.google.com X-Spam_score_int: 0 X-Spam_score: 0.0 X-Spam_bar: / X-Spam_report: (0.0 / 5.0 requ) BAYES_05=-0.5, FREEMAIL_FORGED_FROMDOMAIN=0.249, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.25, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action 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" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:215061 Archived-At: Severity: minor The docstring of `progress-reporter-update' contains the following text: If REPORTER is a numerical progress reporter---i.e. if it was made using non-nil MIN-VALUE and MAX-VALUE arguments to `make-progress-reporter'---then VALUE should be a number between MIN-VALUE and MAX-VALUE. If I place point on the space after "i.e." on the first row, and type C-M-b (backward-sexp), point ends up before "reporter". (This happens in `emacs-lisp-mode', but not in `message-mode'; `message-mode' seems to have no concept of an abbreviation and lands on the "e".) This in turn leads to checkdoc flagging this as a mistake, and asks you to put two spaces after dot. I'm not sure which of these options is true: A) We should support the above convention of using three dashes in `backward-sexp'. (This is the rough ASCII equivalent of an em dash.) B) We should just not use the above convention in `progress-reporter-update'.