From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.devel Subject: RE: removing flatten-list (alias for new flatten-tree function) Date: Mon, 17 Dec 2018 12:23:30 -0800 (PST) Message-ID: References: <76ae4692-717a-4e68-e882-453ac8e0df62@cs.ucla.edu> <87lg4oq8q8.fsf@gmail.com> 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 1545078143 24475 195.159.176.226 (17 Dec 2018 20:22:23 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 17 Dec 2018 20:22:23 +0000 (UTC) Cc: "Basil L. Contovounesios" , Michael Albinus , Emacs development discussions To: Alex Branham , Paul Eggert Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Dec 17 21:22:18 2018 Return-path: Envelope-to: ged-emacs-devel@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 1gYzP8-0006Ek-FH for ged-emacs-devel@m.gmane.org; Mon, 17 Dec 2018 21:22:18 +0100 Original-Received: from localhost ([::1]:49407 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gYzRF-0005PH-3z for ged-emacs-devel@m.gmane.org; Mon, 17 Dec 2018 15:24:29 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:45520) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gYzQa-0005Ox-KB for emacs-devel@gnu.org; Mon, 17 Dec 2018 15:23:49 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gYzQV-0001Rh-Ma for emacs-devel@gnu.org; Mon, 17 Dec 2018 15:23:48 -0500 Original-Received: from userp2120.oracle.com ([156.151.31.85]:60950) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gYzQV-0001Q7-9w for emacs-devel@gnu.org; Mon, 17 Dec 2018 15:23:43 -0500 Original-Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.22/8.16.0.22) with SMTP id wBHKJPIw153324; Mon, 17 Dec 2018 20:23:33 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=TXSH59wxXXJj35KC30vBsq4UxBJhr/U9+thdW1tb+dk=; b=aCLfC1WlRxxI3tS/CLslaGwRWkzqcQhiFctNq1wpbPA1Dwr2XADaHiXZkI3BcJwtKAIK JWeSDTB5ToGNw3tmIEmQpqV5EimkUQaMoYg52oIKK4hjCgxwBV+9P2MTJUxcg/5qPC1u fFiXEcHZlkk9btnNc9Dmq+3vveMyYH8ne/Ifas5Xus57Fvxq6MB7Q18iJjAAOlRuP6yM RymVu41WrGFxmsqUCPjOt5rSME59ZTXHLxZrJdaBH+reBwMp2MEP4WYYrQIElLc+YwDY E3AVqvR3YSkWkNg6esxmeqxqPfTO4CGm7oxWQF2zd4UjM/5xvozNYz8FX16e352Ec8jF vg== Original-Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by userp2120.oracle.com with ESMTP id 2pct8qqkeq-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Mon, 17 Dec 2018 20:23:33 +0000 Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by userv0021.oracle.com (8.14.4/8.14.4) with ESMTP id wBHKNXiP001528 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Mon, 17 Dec 2018 20:23:33 GMT Original-Received: from abhmp0004.oracle.com (abhmp0004.oracle.com [141.146.116.10]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id wBHKNVdH012665; Mon, 17 Dec 2018 20:23:32 GMT In-Reply-To: <87lg4oq8q8.fsf@gmail.com> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4771.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=9110 signatures=668679 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=799 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1812170179 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] [fuzzy] X-Received-From: 156.151.31.85 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:231898 Archived-At: > > While doing that I found that I was confused by the existence of the > > just-added alias 'flatten-list', and I propose removing it as per the > > attached patch. I think people who want to find and use the new > > 'flatten-tree' function will typically be better served if it has > > just one name that fits in with existing Emacs Lisp functions like > > 'copy-tree', as opposed to also having a name that is a misnomer. >=20 > The reason I included `flatten-list' was that the existing > implementations (both inside and outside of Emacs) were nearly all > called foo-flatten-list or similar. I thought it would perhaps be > easier for people to find `flatten-list' than `flatten-tree'. I > don't have a really strong opinion about this, though. Yes. I don't know whether an alias is needed, but this should be pointed out in the doc, because Elisp is part of the history of Lisp. Flattening a (Lisp) list has pretty much always meant flattening it throughout.=20 If you want to use an alias that mentions "list", consider `deep-flatten-list'. "Deep" usually conveys recursively performing some action at all levels. And it's understood by most developers, using most languages.