From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#29373: 24.5; doc string of `self-insert-uses-region-functions' Date: Fri, 24 Nov 2017 19:07:28 +0200 Message-ID: <83y3mv8v1r.fsf@gnu.org> References: <> <<83h8tk9chp.fsf@gnu.org>> <86584c33-6e52-4cf5-8e22-bb9952b296b2@default> Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1511543364 28809 195.159.176.226 (24 Nov 2017 17:09:24 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 24 Nov 2017 17:09:24 +0000 (UTC) Cc: 29373@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Nov 24 18:09:17 2017 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eIHTS-0006Ep-G3 for geb-bug-gnu-emacs@m.gmane.org; Fri, 24 Nov 2017 18:09:10 +0100 Original-Received: from localhost ([::1]:50377 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eIHTV-0002aS-2W for geb-bug-gnu-emacs@m.gmane.org; Fri, 24 Nov 2017 12:09:13 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54469) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eIHTO-0002a9-59 for bug-gnu-emacs@gnu.org; Fri, 24 Nov 2017 12:09:07 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eIHTK-0005a4-QN for bug-gnu-emacs@gnu.org; Fri, 24 Nov 2017 12:09:05 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:47552) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1eIHTK-0005Xu-It for bug-gnu-emacs@gnu.org; Fri, 24 Nov 2017 12:09:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1eIHTK-0004QM-7K for bug-gnu-emacs@gnu.org; Fri, 24 Nov 2017 12:09:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 24 Nov 2017 17:09:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 29373 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 29373-submit@debbugs.gnu.org id=B29373.151154328716940 (code B ref 29373); Fri, 24 Nov 2017 17:09:02 +0000 Original-Received: (at 29373) by debbugs.gnu.org; 24 Nov 2017 17:08:07 +0000 Original-Received: from localhost ([127.0.0.1]:56233 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eIHSR-0004PA-9L for submit@debbugs.gnu.org; Fri, 24 Nov 2017 12:08:07 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:34916) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eIHSP-0004Oh-SE for 29373@debbugs.gnu.org; Fri, 24 Nov 2017 12:08:06 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eIHSG-0001Ye-NY for 29373@debbugs.gnu.org; Fri, 24 Nov 2017 12:08:00 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:34614) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eIHSG-0001X8-JV; Fri, 24 Nov 2017 12:07:56 -0500 Original-Received: from [176.228.60.248] (port=3170 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1eIHSE-0007hh-O8; Fri, 24 Nov 2017 12:07:56 -0500 In-reply-to: <86584c33-6e52-4cf5-8e22-bb9952b296b2@default> (message from Drew Adams on Fri, 24 Nov 2017 08:43:05 -0800 (PST)) 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: 208.118.235.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:140321 Archived-At: > Date: Fri, 24 Nov 2017 08:43:05 -0800 (PST) > From: Drew Adams > Cc: 29373-done@debbugs.gnu.org > > > > Two lines of the doc string are too long. > > > > Longer than 79 characters? I didn't find any such lines. > > Where do you see 79 as the recommended max length? Sometimes it's impossible to limit a line to 70 characters without incurring worse problems. This is one such case. > > > The doc string is close to incomprehensible. > > > > Such derogatory remarks are best kept out of bug reports. The facts > > are grave enough to tell we should fix this. > > Nothing derogatory intended. That sentence could simply be omitted without any effect on the report. May I suggest that you try to refrain from such unneeded remarks? > That's a summary of the problem - lack of clarity overall. "Lack of clarity" would be fine (although it, too, adds nothing). "Incomprehensible" is not a summary. > I have no idea who wrote it, nor do I care. It's not > about blaming or attacking anyone. It's about calling > your attention to what I, at least, think is a doc > string that needs some love (improvement). What you said in the rest of the report is enough to drawing attention.