From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#29598: 26.0; doc of `load-history' Date: Wed, 19 Aug 2020 05:53:49 -0700 (PDT) Message-ID: References: > <837etwuqgx.fsf@gnu.org>> <664c0075-fab4-4127-800e-eaaeec42002f@default> 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="33055"; mail-complaints-to="usenet@ciao.gmane.io" To: Stefan Kangas , 29598@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Aug 19 14:54:11 2020 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 1k8NbX-0008Td-TX for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 19 Aug 2020 14:54:11 +0200 Original-Received: from localhost ([::1]:50452 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1k8NbW-0006ep-Gm for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 19 Aug 2020 08:54:10 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:47200) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1k8NbP-0006dm-3g for bug-gnu-emacs@gnu.org; Wed, 19 Aug 2020 08:54:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:55213) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1k8NbO-00049l-Qy for bug-gnu-emacs@gnu.org; Wed, 19 Aug 2020 08:54:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1k8NbO-0000Kv-Pv for bug-gnu-emacs@gnu.org; Wed, 19 Aug 2020 08:54: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: Wed, 19 Aug 2020 12:54:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 29598 X-GNU-PR-Package: emacs Original-Received: via spool by 29598-submit@debbugs.gnu.org id=B29598.15978416401278 (code B ref 29598); Wed, 19 Aug 2020 12:54:02 +0000 Original-Received: (at 29598) by debbugs.gnu.org; 19 Aug 2020 12:54:00 +0000 Original-Received: from localhost ([127.0.0.1]:38525 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k8NbL-0000KX-S5 for submit@debbugs.gnu.org; Wed, 19 Aug 2020 08:54:00 -0400 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:38798) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k8NbK-0000KE-1W for 29598@debbugs.gnu.org; Wed, 19 Aug 2020 08:53:58 -0400 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 07JCpSHp079852; Wed, 19 Aug 2020 12:53:51 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2020-01-29; bh=TvQdQ2pMxGAH2+99YRFD9BQDfCtzr0RSnOLkGzbPHYQ=; b=ig6kOe1DR9hhu2xPBY6Hfo1j/pgzoE4DgA4z7MQpVtyfqw8wgz6v+d3Wdkx1yDfwKXSm yiOujCkt32wPXNzbaZASuVhwq7+3DvbPlTrQPEUlidFgiWM2XmXFT7+Uent5hHdmmQhW YFtnrUTubParFsw5Ic94zlYHPsPHmfGFazKRyq8c9apuS+mT2asvNXBqOOr8hpzqnhWm KgchwnMhWcoF+nI1Rsnv+4vfCaxdZn2XtbjXHcGK+fW2ATQY7Vi09pzxdSZ/MQHLqLUV W50gsp8gQHTM5+PAZAg6LVQM3IiD+KF8XNNA7xLlzl1LomfdKmGKeArCsVSqxirbw2z9 0Q== Original-Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by aserp2120.oracle.com with ESMTP id 32x7nmje9d-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Wed, 19 Aug 2020 12:53:51 +0000 Original-Received: from pps.filterd (userp3020.oracle.com [127.0.0.1]) by userp3020.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 07JCmHIV063508; Wed, 19 Aug 2020 12:53:51 GMT Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by userp3020.oracle.com with ESMTP id 32xsfta23p-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 19 Aug 2020 12:53:50 +0000 Original-Received: from abhmp0003.oracle.com (abhmp0003.oracle.com [141.146.116.9]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id 07JCrnec022457; Wed, 19 Aug 2020 12:53:50 GMT In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.5017.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9717 signatures=668679 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 malwarescore=0 mlxlogscore=999 spamscore=0 suspectscore=0 mlxscore=0 phishscore=0 bulkscore=0 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2006250000 definitions=main-2008190112 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9717 signatures=668679 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 spamscore=0 impostorscore=0 priorityscore=1501 adultscore=0 mlxscore=0 mlxlogscore=999 lowpriorityscore=0 bulkscore=0 phishscore=0 malwarescore=0 clxscore=1011 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2006250000 definitions=main-2008190113 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:185592 Archived-At: > >> > Shouldn't the doc say something about the order of the elements of t= he > >> > alist? It's a history, but neither the Elisp manual nor the doc str= ing > >> > mentions whether the beginning or the end of the list is the oldest > >> > part of the history of loads. > >> > >> Since it's an alist, and every element should be there only once, why > >> does the order matter? > > > > Because it's a history? We already tell users, by using > > that name, that it is chronological. What we don't tell > > them is which chronological order is used. > > > > If someone is looking for something, it helps to know whether > > the list order is old-to-new or new-to-old. And if someone > > locates something of interest in the list it helps to know > > whether it is the stuff that comes before or after it that > > was loaded when it got loaded. > > > > Is there some reason not to mention the order? We do, after > > all, bother to call it `*-history'. >=20 > Do you have a use-case in mind here? If we mention the order, we would > need to follow that in the future, whereas if we don't we could > potentially change it. So unless there is a concrete need to document > it, isn't it better to just avoid it? I really don't understand this hesitation. The use case is described above. Users have a chronological list. Why would we _not_ want to tell them which direction the list goes? That's not obvious. If at some future point Emacs changes the behavior (it never has), then we would, hopefully, document the new order. This is a very minor doc request, asking for a word or two.