From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: carlmarcos--- via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#56870: company-dabbrev variable documentation Date: Thu, 4 Aug 2022 23:59:25 +0200 (CEST) Message-ID: References: <878ro74pz5.fsf@rfc20.org> <87y1w7ymiu.fsf@gnus.org> <87sfmd2mqk.fsf@rfc20.org> <878ro4rl4l.fsf@rfc20.org-N8dpYwc----2> Reply-To: carlmarcos@tutanota.com Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="27602"; mail-complaints-to="usenet@ciao.gmane.io" Cc: YE , uzibalqa , Lars Ingebrigtsen , 56870@debbugs.gnu.org To: Matt Armstrong Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Fri Aug 05 00:00:22 2022 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 1oJitC-0006zh-KR for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 05 Aug 2022 00:00:22 +0200 Original-Received: from localhost ([::1]:54016 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oJitB-0008Rr-81 for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 04 Aug 2022 18:00:21 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:41190) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oJist-0008RS-0F for bug-gnu-emacs@gnu.org; Thu, 04 Aug 2022 18:00:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:37251) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oJiss-0000gs-Lo for bug-gnu-emacs@gnu.org; Thu, 04 Aug 2022 18:00:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1oJiss-0001gT-J5 for bug-gnu-emacs@gnu.org; Thu, 04 Aug 2022 18:00:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: carlmarcos@tutanota.com Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 04 Aug 2022 22:00:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 56870 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: notabug Original-Received: via spool by 56870-submit@debbugs.gnu.org id=B56870.16596503776413 (code B ref 56870); Thu, 04 Aug 2022 22:00:02 +0000 Original-Received: (at 56870) by debbugs.gnu.org; 4 Aug 2022 21:59:37 +0000 Original-Received: from localhost ([127.0.0.1]:55233 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oJisS-0001fN-Lo for submit@debbugs.gnu.org; Thu, 04 Aug 2022 17:59:37 -0400 Original-Received: from w1.tutanota.de ([81.3.6.162]:42798) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oJisO-0001f5-6N for 56870@debbugs.gnu.org; Thu, 04 Aug 2022 17:59:35 -0400 Original-Received: from w3.tutanota.de (unknown [192.168.1.164]) by w1.tutanota.de (Postfix) with ESMTP id E58DDFBF8D3; Thu, 4 Aug 2022 21:59:25 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; t=1659650365; s=s1; d=tutanota.com; h=From:From:To:To:Subject:Subject:Content-Description:Content-ID:Content-Type:Content-Type:Content-Transfer-Encoding:Content-Transfer-Encoding:Cc:Cc:Date:Date:In-Reply-To:In-Reply-To:MIME-Version:MIME-Version:Message-ID:Message-ID:Reply-To:References:References:Sender; bh=Tg1asObEYxa9JKauB7pbekSIqeJZssTDQs1dhRzTw54=; b=QTdV2pG4S4RHq8XkiT7uxm9WkPfdKVzsxD0rsCvjfB95+RT7knh1KPjE81oklzNs HsGVETRmIgoIId70/3TPJK+IQdWzW7Y/RbdwFEAcBNL4zvBggkUD5hVY4O9B9mp+9Pg 2CgZC8Jdi8T4dUnN7sgVhHZ/ZKXbBV849SAhIAlQetYYTdJXpPqz408akJwZ1aE7WQK AEzmSXax5hldayaWQNrzPAHWgmb1lE7OXPzJWgqUaPVM97PtrfZlI1KMR/jRcxfRGmz 42/hxRr2YBgHCgU8k7mRCJbKK8e7UZ+wMqZ8irL32pycxbDKN+2qwJEyr6t0XCqhl48 arwkNvC1vA== In-Reply-To: <878ro4rl4l.fsf@rfc20.org-N8dpYwc----2> 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:238802 Archived-At: Aug 4, 2022, 17:09 by matt@rfc20.org: > carlmarcos@tutanota.com writes: > >> Aug 3, 2022, 18:41 by matt@rfc20.org: >> >>> I think the maintainers are quite receptive to improvements like >>> this. >>> >> >> I completely disagree.=C2=A0 The experience with maintainers has shown h= ow >> unreceptive they often get towards improvements like this.=C2=A0 Lars >> thought there isn't anything to fix in Emacs and decided to close this >> bug report. >> > > I think reasonable people can disagree about what is and is not a > problem, is or is not an improvement, or even misunderstand eachother > entirely. Sometimes patience and additional explanations are the way to > move forward. > > In this case, I agree with Lars that the company-dabbrev docstring is > consistent with Emacs' usual way of writing docstrings. I don't > actually see a clear way to improve the one docstring in isolation > without it becoming inconsistent with the rest of Emacs. And so, I > would expect any improvement here to involve some discussion, since the > path forward isn't obvious. > Sure.=C2=A0 But I found too much eagerness to close the discussion.=C2=A0 M= any are putting too much focus on consistency, when the aim should really be on equipping users with what = is actually required=C2=A0=20 for them to write code that works.=C2=A0 Rather than rely on assumptions th= at old timers consider of minor importance.=C2=A0 Because in the end it is code that works which counts.=C2= =A0 The less one tortures people, the better.