From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#33870: 27.0.50; xref-goto-xref not configurable Date: Sun, 6 Jan 2019 12:55:13 -0800 (PST) Message-ID: References: <87a7ktqqx7.fsf@mail.linkov.net> <9215183d-0a44-88b5-5b3c-d0da31f749ad@yandex.ru> <878t02egph.fsf@mail.linkov.net> <878t011lch.fsf@mail.linkov.net> <83lg403o9c.fsf@gnu.org> <87r2dq8z9n.fsf@mail.linkov.net> <5C31C477.9040108@gmx.at> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1546808050 4199 195.159.176.226 (6 Jan 2019 20:54:10 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sun, 6 Jan 2019 20:54:10 +0000 (UTC) Cc: 33870@debbugs.gnu.org, joaotavora@gmail.com, dgutov@yandex.ru To: martin rudalics , Juri Linkov , Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Jan 06 21:54:05 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 esmtp (Exim 4.84_2) (envelope-from ) id 1ggFQq-0000uA-1i for geb-bug-gnu-emacs@m.gmane.org; Sun, 06 Jan 2019 21:54:04 +0100 Original-Received: from localhost ([127.0.0.1]:44633 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ggFSw-00060W-Kh for geb-bug-gnu-emacs@m.gmane.org; Sun, 06 Jan 2019 15:56:14 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:58438) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ggFSp-00060F-1Q for bug-gnu-emacs@gnu.org; Sun, 06 Jan 2019 15:56:09 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ggFSn-0000Xw-3W for bug-gnu-emacs@gnu.org; Sun, 06 Jan 2019 15:56:06 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:38631) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1ggFSk-0000Xk-37 for bug-gnu-emacs@gnu.org; Sun, 06 Jan 2019 15:56:03 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ggFSj-0007Fd-QU for bug-gnu-emacs@gnu.org; Sun, 06 Jan 2019 15:56:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 06 Jan 2019 20:56:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 33870 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 33870-submit@debbugs.gnu.org id=B33870.154680812527813 (code B ref 33870); Sun, 06 Jan 2019 20:56:01 +0000 Original-Received: (at 33870) by debbugs.gnu.org; 6 Jan 2019 20:55:25 +0000 Original-Received: from localhost ([127.0.0.1]:49056 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ggFS9-0007EX-4N for submit@debbugs.gnu.org; Sun, 06 Jan 2019 15:55:25 -0500 Original-Received: from aserp2130.oracle.com ([141.146.126.79]:60810) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ggFS6-0007EH-P4 for 33870@debbugs.gnu.org; Sun, 06 Jan 2019 15:55:23 -0500 Original-Received: from pps.filterd (aserp2130.oracle.com [127.0.0.1]) by aserp2130.oracle.com (8.16.0.22/8.16.0.22) with SMTP id x06KsuJC122316; Sun, 6 Jan 2019 20:55:16 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=PXsXKZ1rmM91rX7qb0lzofCn2RK1EhcptZRg8q/x8q4=; b=g+X9dMxqSWBQOqIS2YkHuLwquQsjXUS79AXH4TQgE3/wB+qHzrbrVM/8E7botKcr0czP SxV2eIDI7SXDDMCsJVm/6riSaoBEIBUCFbjDtt7tPa/WHrbRwHkXrsIGrkkCDWVj1373 xyXhAxagM5hGke95SnRKE0vZp4/EmWXaEIPntw8ZWey30z6NO1ETv8BajyFjoYNPNi2d bDXuHEyjPOp7KEuGv5iIb/976eNqgqoj6PU5Z4MA8HohqkFosxHVc5Uh5cjrXwm4SN7d lILCX8guTKYBdqPu1tE9BN7bJmNCLXkDl11V6jnUTTGrIlkmrzjHdxDGAgpXD6it85UG 8A== Original-Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by aserp2130.oracle.com with ESMTP id 2ptj3dk5cs-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 06 Jan 2019 20:55:16 +0000 Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by aserv0022.oracle.com (8.14.4/8.14.4) with ESMTP id x06KtFA6022723 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 6 Jan 2019 20:55:16 GMT Original-Received: from abhmp0009.oracle.com (abhmp0009.oracle.com [141.146.116.15]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id x06KtEo8012208; Sun, 6 Jan 2019 20:55:14 GMT In-Reply-To: <5C31C477.9040108@gmx.at> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4783.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=9127 signatures=668680 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=18 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=782 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1901060186 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:154200 Archived-At: > The 'display-buffer--maybe-' functions are macros in disguise invented > by Chong to simplify coding the rest. Unless we can't avoid it, I > would not make them public because then we would have to (1) document > them, (2) explain the semantics of the "maybe" and (3) justify why the > remaining 'display-buffer--maybe-' functions are not public. _Everything_ in Emacs is (and should be) public. Why would Emacs users not deserve all of #1, #2, and #3? Wouldn't you make that info available to Emacs developers? How are Emacs users different from Emacs developers with regard to what info they deserve to know about, including design and implementation behavior and their reasons? Many users might not be interested in digging into such info, but why hide it? Please consider instead making such info clear and explicit for everyone. An absolute minimum in this regard is comments in the code. But Emacs has doc strings, and beyond design and implementation information we should document function behavior in doc strings. It should make no difference how tentative or temporary or "internal" we might currently think some function is - its behavior deserves to be documented. "Unless we can't avoid it...". We should not avoid it or anything like it. It should be a moral imperative, as well as a question of helpfulness and civility, for Emacs to document itself to users.