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#32629: 26; `buffer-list-update-hook' doc string Date: Mon, 10 Sep 2018 06:51:31 -0700 (PDT) Message-ID: References: <> <<83y3c9o59k.fsf@gnu.org>> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1536587957 17881 195.159.176.226 (10 Sep 2018 13:59:17 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 10 Sep 2018 13:59:17 +0000 (UTC) Cc: 32629@debbugs.gnu.org To: Eli Zaretskii , Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Sep 10 15:59:13 2018 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 1fzMie-0004YD-3z for geb-bug-gnu-emacs@m.gmane.org; Mon, 10 Sep 2018 15:59:12 +0200 Original-Received: from localhost ([::1]:51813 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fzMkk-0004Xu-Lg for geb-bug-gnu-emacs@m.gmane.org; Mon, 10 Sep 2018 10:01:22 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:57586) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fzMiD-0002Rf-2z for bug-gnu-emacs@gnu.org; Mon, 10 Sep 2018 09:58:50 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fzMbi-0005aN-Lu for bug-gnu-emacs@gnu.org; Mon, 10 Sep 2018 09:52:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:46906) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fzMbi-0005aF-HH for bug-gnu-emacs@gnu.org; Mon, 10 Sep 2018 09:52:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fzMbi-0001PZ-Et for bug-gnu-emacs@gnu.org; Mon, 10 Sep 2018 09:52:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 10 Sep 2018 13:52:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 32629 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 32629-submit@debbugs.gnu.org id=B32629.15365875035400 (code B ref 32629); Mon, 10 Sep 2018 13:52:02 +0000 Original-Received: (at 32629) by debbugs.gnu.org; 10 Sep 2018 13:51:43 +0000 Original-Received: from localhost ([127.0.0.1]:51924 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fzMbO-0001P1-MD for submit@debbugs.gnu.org; Mon, 10 Sep 2018 09:51:42 -0400 Original-Received: from userp2130.oracle.com ([156.151.31.86]:55038) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fzMbM-0001On-O5 for 32629@debbugs.gnu.org; Mon, 10 Sep 2018 09:51:41 -0400 Original-Received: from pps.filterd (userp2130.oracle.com [127.0.0.1]) by userp2130.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w8ADnGI4127442; Mon, 10 Sep 2018 13:51:35 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=+w4ShXi+k8KlX0T9Vl6dcM+OuYTw8xXen/bG1fA9SiI=; b=BSfQhFqnLAOnFQ6+L0Mq8q76X028j0ZhLaz4IeL9b9lYu4zqyk4d+eMeZlL6ScHWvCGH LR+7gv8YRRwXMUqylCuC5VeYW0Fpfo3muXvIDeTtHUqBB9R8F7JNX0L7CYB6iFROXST7 i23fUcBO2Cd1DklQ2y9Mp+qHIVkmsfKuTJsrF98rXWQChdHSJs89E+CYFrd4+a284/nu shhP/ch45v4iqiY2HCzRIn22F60z9DbWEVYB6PR1JB6/a4gZsKbkWfMQqi3u+g9DUeoY vKVQUmCggClfOoaZmeHLsdk92pzTQiHaz/XlSX8GGXPRRWLKkNCo/P2++cuOjijpfRYS Sw== Original-Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by userp2130.oracle.com with ESMTP id 2mc5ut67f6-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Mon, 10 Sep 2018 13:51:34 +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 w8ADpXtL016392 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Mon, 10 Sep 2018 13:51:34 GMT Original-Received: from abhmp0014.oracle.com (abhmp0014.oracle.com [141.146.116.20]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id w8ADpW7B015205; Mon, 10 Sep 2018 13:51:33 GMT In-Reply-To: <<83y3c9o59k.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4735.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=9011 signatures=668708 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=821 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1807170000 definitions=main-1809100142 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:150186 Archived-At: > > The doc string should not list the functions that run the hook. >=20 > Why not? Same reason we don't do that elsewhere (do we?). Instead we say, in the doc for each such function, that it runs the hook. (Similarly, we don't list, in the doc for some function, all of the functions that might call it.) The most that could be done would be to list the functions known, ahead of time, to run the hook. But even that is counterproductive, IMO. Let me ask: Why should this doc list the functions that run the hook? And do you know of other places where we do that?