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.devel Subject: RE: master 95e8c7d 1/2: ; Fix typos Date: Fri, 9 Oct 2020 14:14:22 -0700 (PDT) Message-ID: <032e56ac-ae15-420d-8bf3-0224197696a4@default> References: <20201009134249.15265.31644@vcs0.savannah.gnu.org> <20201009134252.81B3620A15@vcs0.savannah.gnu.org> <83tuv35upc.fsf@gnu.org> 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="33959"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Stefan Kangas , Eli Zaretskii , Robert Pluim Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Oct 09 23:17:31 2020 Return-path: Envelope-to: ged-emacs-devel@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 1kQzla-0008kH-QS for ged-emacs-devel@m.gmane-mx.org; Fri, 09 Oct 2020 23:17:30 +0200 Original-Received: from localhost ([::1]:51150 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kQzlZ-0008W7-Pu for ged-emacs-devel@m.gmane-mx.org; Fri, 09 Oct 2020 17:17:29 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:43732) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kQzkg-00083V-BS for emacs-devel@gnu.org; Fri, 09 Oct 2020 17:16:35 -0400 Original-Received: from aserp2130.oracle.com ([141.146.126.79]:33800) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kQzke-0007W0-8Z; Fri, 09 Oct 2020 17:16:33 -0400 Original-Received: from pps.filterd (aserp2130.oracle.com [127.0.0.1]) by aserp2130.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 099LEMT7033772; Fri, 9 Oct 2020 21:16:25 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-2020-01-29; bh=H3blVhWWAIAYIKmrCgm3ClzQc5WCrq+IxHch9QbjUWM=; b=dHV0wVKPEhufISj5mZ0fBPi+RHQu2crhRZu2K+SkDN//KaAUna+JpsPlbkB2Ud3F/uEs ldxET+e2kZihy+aaUYJBrRWa36FA2dgkrp4cHkSmF2Th9he1jRd4IKNeKCcBEg38eNLa yDKFE6Lp+ojSCnKhjbt4H8AGSzGLShJazyulT6MpduYPESytYYeqoi225lQmYaB3b360 I4KzIyTs2by6qq9M3YfHNPOumwWCZjfXjr5Yi9gSBqRQ78DObF06dvXgk7BArelqiGeK BkO8JflAYZnXy9ffshkCWw0sHZSctHkzqxEpaYn1LspvfRtcidVBvJ01KG7G2SjTgq1U BQ== Original-Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by aserp2130.oracle.com with ESMTP id 342kvyuk7r-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Fri, 09 Oct 2020 21:16:25 +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 099LBKVT196155; Fri, 9 Oct 2020 21:14:24 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userp3020.oracle.com with ESMTP id 3429kju16x-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 09 Oct 2020 21:14:24 +0000 Original-Received: from abhmp0014.oracle.com (abhmp0014.oracle.com [141.146.116.20]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id 099LENs5028241; Fri, 9 Oct 2020 21:14:23 GMT In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.5056.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9769 signatures=668681 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 malwarescore=0 mlxlogscore=999 suspectscore=0 mlxscore=0 adultscore=0 bulkscore=0 phishscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2010090155 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9769 signatures=668681 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 malwarescore=0 clxscore=1015 phishscore=0 spamscore=0 mlxlogscore=999 impostorscore=0 priorityscore=1501 suspectscore=0 bulkscore=0 adultscore=0 lowpriorityscore=0 mlxscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2010090156 Received-SPF: pass client-ip=141.146.126.79; envelope-from=drew.adams@oracle.com; helo=aserp2130.oracle.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/10/09 17:06:05 X-ACL-Warn: Detected OS = Linux 3.1-3.10 [fuzzy] X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 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-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:257282 Archived-At: > But it is true that it would be preferable if the code matched the > documentation. In the interest of consistency we are better off > sticking to one spelling. Note that we already had around 40 other > instances of "parsable" in our source tree. >=20 > This is obviously extremely minor. Personally I'd rather fix the names > of those two macros to match the docstring. IIUC, an obsolete function > alias would do the job. My 2 cents: Unless the code you want to rename is brand new - never been released as part of an Emacs release, please don't change the names in the code. And when you refer to those code names in the doc, use the actual code names. If you otherwise use the _word_ then use whatever you want. This kind of gratuitous name change is anathema. It's all the more silly since both names are acceptable as English words. Code names should be understandable. Other things being equal they should also be relatively consistent. But they need not correspond exactly, in general, with natural language words. The main point is not to break existing code. Especially gratuitously.